Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

MS Teams Connector allow the retrieval of presence from MS Teams, to provide a display of presence in the Jtel system in various views such as:

  • Agent Home
  • Supervisor
  • MiniClient
  • Main Page

Note:

If the presence status does not work properly, it may be because the secret in Azure has expired.

Image Added

Important:

Each customer should set an own resubmission date as jtel cannot see when the secret expires as jtel does not have axccess to the Customers Azure.

Portal Configuration

The new presence connector is created as a sysadmin in the Jtel Web Portal.

Give the connector a name, and select TEAMS Presence Rest API (Version) as the connector type.

The connector settings are specified as XML.

Example:

Translations Ignore


Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<config>
	<implementation>
		<jar>
			<base>jtel-system-presence-connectors-teams</base>
			<version>1.0</version>
		</jar>
		<class>de.jtel.system.presence.connectors.teams.v1.TEAMSPresenceRestApi</class>
	</implementation>
	<parameters>
		<tenant_id></tenant_id>
		<client_id></client_id>
		<client_secret></client_secret>
        <scope></scope>
        <user></user>
        <password></password>
        <execution_period></execution_period>
	 	<teams_connector_ip>acd-tel1</teams_connector_ip>
		<teams_udp_port>20696</teams_udp_port>
	</parameters>
	<behavior>
		<syncAcdUsers>0</syncAcdUsers>
		<syncPbxUsers>1</syncPbxUsers>
	</behavior>
</config>


Settings

Only the settings in the areas parameters and behavior may be adjusted:

SettingValueComments

implementation jar base

jtel-system-presence-connectors-teams

Currently, teams, v1.0 is supported. Configure the appropriate Teams version.


implementation jar version
1.0
This version pertains to the Jtel version of the connector implementation. Currently, version 1.0 is required (for all Teams versions).
parameters tenant_idtenant_id

The Directory (tenant) ID from Azure Active Directory - registered App

parameters client_id
client_id
The Application ID from Azure Active Directory - registered App
parameters client_secret client_secretThe Client secret created in Azure Active Directory - registered App
parameters scope https://graph.microsoft.com/.defaultA space-separated list of the Microsoft Graph permissions that you want the user to consent to. This may also include OpenID scopes.
parameters user 
teams_user
Set the email for the Teams Administrator.
parameters passwordteams_passwordSet the password for the Teams Administrator.
parameters execution_period5This defines the period of updating the status of MS Teams users.
teams_connector_ipacd-tel1This defines the hostname/ IP address where the teams connector is running. (Valid from release 3.27)
teams_udp_port20696This defines the UDP port of the teams connector. (Valid from release 3.27)
behavior syncAcdUsers0

Causes all reported extensions to be created as an ACD user. Setting this to 1 is not recommended.

Note: even if this is set to 0, the ACD users' presence status will still be set according to the current Tel1 field in the user record, and TelActive (the active telephone number).

behavior syncPbxUsers1

Causes all reported extensions to be created as PBX Users. Setting this to 1 is recommended.

Note: If telephone numbers and names of users change, the old records must be deleted manually as this is not done automatically.


Sv translation
languagede

MS Teams Connector

allow the retrieval of presence from MS Teams, to provide a display of presence in the Jtel system in various views such as

ermöglicht den Abruf der Präsenz von MS Teams, um eine Anzeige der Präsenz im Jtel-System in verschiedenen Ansichten wie z.B:

  • Agent Home
  • Supervisor
  • MiniClient
  • Main Page
  • Portal Configuration

    The new presence connector is created as a sysadmin in the Jtel Web Portal.

    • Mini Client
    • Hauptseite

    Hinweis: 

    Sollte der Presence Status nicht ordnungsgemäß funktionieren, kann es daran liegen, dass der Secret im Azure abgelaufen ist. 

    Image Added

    Wichtig: 

    Jeder Kunde sollte sich selbst ein Wiedervorlagedatum setzen, da jtel nicht sehen kann wann das Secret abläuft, da jtel keinen Zugriff auf die Azure des Kunden hat.

    Portal Konfiguration

    Der neue Präsenzkonnektor wird als Systemadministrator im Jtel-Webportal angelegt.

    Geben Sie dem Connector einen Namen, und wählen Sie

    Give the connector a name, and select

    TEAMS Presence Rest API (Version)

    as the connector type.

    The connector settings are specified as XML.

    als Connector-Typ.

    Die Connector-Einstellungen werden als XML angegeben.

    Beispiel:

    Code Block
    languagexml
    Example:
    <?xml version="1.0"
     encoding
     encoding="UTF-8"?>

    <config>
        <implementation>
            <jar>
                <base>jtel
    
    <config>
        <implementation>
            <jar>
                <base>jtel-system-presence-connectors-teams</
    base>
                <version>1
    base>
                <version>1.0</
    version>
            </jar>
            <class>de
    version>
            </jar>
            <class>de.jtel.system.presence.connectors.teams.v1.TEAMSPresenceRestApi</class>
        </implementation>
        <parameters>
            <tenant_id></tenant_id>
            <client_id></client_id>
            <client_secret></client_secret>
            <scope></scope>
            <user></user>
            <password></password>
            <execution_period></execution_period>
    		<teams_connector_ip>acd-tel1</teams_connector_ip>
            <teams_udp_port>20696</teams_udp_port>
         </parameters>
        <behavior>
            <syncAcdUsers>0</syncAcdUsers>
            <syncPbxUsers>1</syncPbxUsers>
        </behavior>
    </config>

    Einstellungen

    Es dürfen nur die Einstellungen in den Bereichen Parameter und Verhalten angepasst werden:

    Einstellung

    Wert

    Kommentare

    Implementation

    jar base

    jtel-system-presence-connectors-teams

    Derzeit werden Teams, v1.0 unterstützt. Konfigurieren Sie die entsprechende Team-Version.


    Implementation

    jar version

    1.0
    Diese Version bezieht sich auf die Jtel-Version der Konnektor-Implementierung. Derzeit ist Version 1.0 erforderlich (für alle Team-Versionen).

    Parameter

    tenant_id

    tenant_id

    Die Verzeichnis-(Mieter-)ID von Azure Active Directory - registrierte App

    Parameter

    client_id

    client_id
    Die Anwendungs-ID aus Azure Active Directory - registrierte Anwendung

    Parameter

    client_secret 

    client_secretDas Client-Secret aus Azure Active Directory - registrierte Anwendung

    Parameter

    scope 

    https://graph.microsoft.com/.defaultEine durch Leerzeichen getrennte Liste der Microsoft Graph-Berechtigungen, denen der Benutzer zustimmen soll. Dies kann auch OpenID-Bereiche umfassen.

    Parameter

    user 

    teams_user
    Legen Sie die E-Mail für den Team-Administrator fest.

    Parameter

    password

    teams_passwordLegen Sie das Kennwort für den Team-Administrator fest.

    Parameter

    execution_period

    5Dies definiert den Zeitraum für die Aktualisierung des Status der MS-Team-Benutzer.
    teams_connector_ipacd-tel1Hier wird der Hostname/die IP-Adresse angegeben, unter der der Team-Connector läuft. (Gültig ab Version 3.27)
    teams_udp_port20696Definiert den UDP-Port des Teams-Connectors. (Gültig ab Version 3.27)

    Verhalten

    syncAcdUsers

    0

    Bewirkt, dass alle gemeldeten Erweiterungen als ACD-Benutzer erstellt werden. Es wird nicht empfohlen, diesen Wert auf 1 zu setzen.

    Hinweis: Selbst wenn dieser Wert auf 0 gesetzt wird, wird der Anwesenheitsstatus der ACD-Benutzer dennoch entsprechend dem aktuellen Tel1-Feld im Benutzerdatensatz und TelActive (der aktiven Telefonnummer) gesetzt.

    Verhalten

    syncPbxUsers

    1

    Bewirkt, dass alle gemeldeten Nebenstellen als PBX-Benutzer erstellt werden. Es wird empfohlen, diesen Wert auf 1 zu setzen.

    Hinweis: Wenn sich Telefonnummern und Namen von Benutzern ändern, müssen die alten Datensätze manuell gelöscht werden, da dies nicht automatisch durchgeführt wird.


    Sv translation
    languagefr

    MS Teams Connector permet la récupération de la présence de MS Teams, pour fournir un affichage de la présence dans le système Jtel dans différentes vues telles que:

    • Accueil de l'agent
    • Superviseur
    • MiniClient
    • Page principale

    Note:

    Si l'état de présence ne fonctionne pas correctement, c'est peut-être parce que le secret dans Azure a expiré.

    Image Added

    Important:

    Chaque client doit fixer sa propre date de resoumission car jtel ne peut pas savoir quand le secret expire car jtel n'a pas accès à Azure.

    Configuration du portail

    Le nouveau connecteur de présence est créé en tant qu'administrateur système dans le portail Web de Jtel.

    Donnez un nom au connecteur, et sélectionnez TEAMS Presence Rest API (Version) comme type de connecteur.

    Les paramètres du connecteur sont spécifiés en XML.

    Exemple :

    Translations Ignore


    Code Block
    languagexml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <config>
        <implementation>
            <jar>
                <base>jtel-system-presence-connectors-teams</base>
                <version>1.0</version>
            </jar>
            <class>de.jtel.system.presence.connectors.teams.v1.TEAMSPresenceRestApi</class>
        </implementation>
        <parameters>
            <tenant_id></tenant_id>
            <client_id></client_id>
            <client_secret></client_secret>
            <scope></scope>
            <user></user>
            <password></password>
            <execution_period></execution_period>
            <teams_connector_ip>acd-tel1</teams_connector_ip>
            <teams_udp_port>20696</teams_udp_port>
         </parameters>
        <behavior>
            <syncAcdUsers>0</syncAcdUsers>
            <syncPbxUsers>1</syncPbxUsers>
        </behavior>
    </config>
    


    Paramètres

    Seuls les réglages dans les domaines paramètres et comportement peuvent être ajustés:

    ParamètresValeurCommentaires

    base du bocal de mise en œuvre

    /class>
        </implementation>
        <parameters>
            <tenant_id></tenant_id>
            <client_id></client_id>
            <client_secret></client_secret>
            <scope></scope>
            <user></user>
            <password></password>
            <execution_period></execution_period>
        </parameters>
        <behavior>
            <syncAcdUsers>0</syncAcdUsers>
            <syncPbxUsers>1</syncPbxUsers>
        </behavior>
    </config>

    Settings

    Only the settings in the areas parameters and behavior may be adjusted:

    implementation jar baseCurrently teams is supported. Configure the appropriate Teams version.This version pertains to the Jtel version of the connector implementation. Currently, is required (for all Teams versionsparameters The Directory (tenant) ID from  registered Appparameters The Application ID from  registered parameters The Client secret created in  registered Appparameters scope parameters user parameters passwordparameters Causes all reported extensions to be created as PBX Users. Setting this to 1 is recommended

    Setting

    Value

    Comments

    Setting

    Value

    Comments

    jtel-system-presence-connectors-teams

    Actuellement,

    les équipes, la v1.0

    est supportée. Configurez la version appropriée de Teams.


    implementation jar version
    1
    ,0
    Cette version concerne la version Jtel de l'implémentation du connecteur. Actuellement, la version 1.0 est requise (pour toutes les versions de Teams).
    paramètres tenant_idtenant_id

    L'identifiant de l'annuaire (locataire) d'Azure Active Directory -

    application enregistrée

    paramètres client_id
    client_id
    L'identifiant de l'application d'Azure Active Directory - App enregistrée
    paramètres client_secret client_secretLe client secret créé dans Azure Active Directory - application enregistrée
    portée des paramètres https://graph.microsoft.com/.defaultA space-separated list of the Microsoft Graph permissions that you want the user to consent to. This may also include OpenID scopes.Une liste, séparée par des espaces, des autorisations Microsoft Graph auxquelles vous souhaitez que l'utilisateur consente. Cela peut également inclure les champs d'application OpenID.
    paramètres utilisateur 
    teams_user
    Set the email for the Teams Administrator.Définissez l'email de l'administrateur des équipes.
    paramètres mot de passeteams_passwordSet the password for the Teams Administrator.Définissez le mot de passe pour l'administrateur des équipes.
    paramèters execution_period5This defines the period of updating the status of MS Teams users.
    behavior syncAcdUsers0

    Causes all reported extensions to be created as an ACD user. Setting this to 1 is not recommended.

    Note: even if this is set to 0, the ACD users' presence status will still be set according to the current Tel1 field in the user record, and TelActive (the active telephone number).

    Ceci définit la période de mise à jour du statut des utilisateurs de MS Teams.
    teams_connector_ipacd-tel1Ceci définit le nom d'hôte/adresse IP où le connecteur de Teams est exécuté. (Valable à partir de la version 3.27)
    teams_udp_port20696Ceci définit le port UDP du connecteur de Teams. (Valable à partir de la version 3.27)
    comportement syncAcdUsers0

    Fait en sorte que toutes les extensions signalées soient créées en tant qu'utilisateur ACD. Il n'est pas recommandé de fixer cette valeur à 1.

    Remarque : même si cette valeur est 0, le statut de présence des utilisateurs de l'ACD sera toujours défini en fonction du champ Tel1 actuel dans l'enregistrement de l'utilisateur, et TelActive (le numéro de téléphone actif).

    comportement syncAcdUsers1

    Fait en sorte que toutes les extensions signalées soient créées en tant qu'utilisateurs du PBX. Il est recommandé de fixer cette valeur à 1.

    Note : Si les numéros de téléphone et les noms des utilisateurs changent, les anciens enregistrements doivent être supprimés manuellement car cela ne se fait pas automatiquement

    behavior syncPbxUsers1

    .