Page History

Sv translation

language	en

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.

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

language	xml

<?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>

Note: Should above configuration not result in a stable API connectivity and cause an equivalent error,

Error sample:

Code Block

language	xml

ERROR :: TEAMSPresenceRestApi 4 - TEAMSUDPListner :: TEAMSUDPListner::run SocketException acd-tel1:20696 - java.net.BindException: Cannot assign requested address

then an option can be the removal of the following two parameter lines:

Code Block

language	xml

# to be rermoved in case of above mentioned error:
        <teams_connector_ip>acd-tel1</teams_connector_ip>
        <teams_udp_port>20696</teams_udp_port>

Settings

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

Setting	Value	Comments
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_id	tenant_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_secret	The Client secret created in Azure Active Directory - registered App
parameters scope	https://graph.microsoft.com/.default	A 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 password	teams_password	Set the password for the Teams Administrator.
parameters execution_period	5	This defines the period of updating the status of MS Teams users.
teams_connector_ip	acd-tel1	This defines the hostname/ IP address where the teams connector is running. (Valid from release 3.27)
teams_udp_port	20696	This defines the UDP port of the teams connector. (Valid from release 3.27)
behavior syncAcdUsers	0	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 syncPbxUsers	1	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

language	de

MS Teams Connector 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
Mini Client
Hauptseite

Hinweis:

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

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 TEAMS Presence Rest API (Version) als Connector-Typ.

Die Connector-Einstellungen werden als XML angegeben.

Beispiel:

Code Block

language	xml

<?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>

Note: Sollte die oben genannte Konfiguration keine stabile API-Verbindung herstellen und einen entsprechenden Fehler verursachen,

Error sample:

ERROR :: TEAMSPresenceRestApi 4 - TEAMSUDPListner :: TEAMSUDPListner::run SocketException acd-tel1:20696 - java.net.BindException: Cannot assign requested address

Dann besteht die Möglichkeit, die folgenden beiden Parameterzeilen zu entfernen:

# to be rermoved in case of above mentioned error:
<teams_connector_ip>acd-tel1</teams_connector_ip>
<teams_udp_port>20696</teams_udp_port>

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_secret	Das Client-Secret aus Azure Active Directory - registrierte Anwendung
Parameter scope	https://graph.microsoft.com/.default	Eine 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_password	Legen Sie das Kennwort für den Team-Administrator fest.
Parameter execution_period	5	Dies definiert den Zeitraum für die Aktualisierung des Status der MS-Team-Benutzer.
teams_connector_ip	acd-tel1	Hier wird der Hostname/die IP-Adresse angegeben, unter der der Team-Connector läuft. (Gültig ab Version 3.27)
teams_udp_port	20696	Definiert 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

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 Removed

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

language	xml

<?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> </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:

Actuellement, les équipes, la v1.0 est supportée. Configurez la version appropriée de Teams.

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

Paramètres	Valeur	Commentaires
base du bocal de mise en œuvre	jtel-system-presence-connectors-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_id	tenant_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_secret	Le client secret créé dans Azure Active Directory - application enregistrée
portée des paramètres	https://graph.microsoft.com/.default	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	Définissez l'email de l'administrateur des équipes.
paramètres mot de passe	teams_password	Définissez le mot de passe pour l'administrateur des équipes.
paramèters execution_period	5	Ceci définit la période de mise à jour du statut des utilisateurs de MS Teams.
comportement syncAcdUsers	0	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 syncAcdUsers	1	Bewirkt, dass alle gemeldeten Nebenstellen als PBX-Benutzer erstellt werden. Es wird empfohlen, diesen Wert auf 1 zu setzen.

Sv translation

language	fr

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.

Page tree

Versions Compared

Old Version 21

New Version Current

Key

Note:

Important:

Portal Configuration

Settings

Hinweis:

Wichtig:

Portal Konfiguration

Einstellungen

Note:

Important:

Configuration du portail

Paramètres