Versions Compared

Key

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

Introduction

This page provides a guide to the required configuration to activate the jtel Teams Presence API in your jtel system.

The API functions are described in detail at this page.

Azure Configuration - Prerequisites

The configuration should be done by a Azure AD Tenant Administrator. The configuring user must have access to the following:

  • Active Directory Administration
  • User Administration
  • Role Administration
  • API permission Administration

Azure Configuration - Step by Step Guide

Info
titleMicrosoft Documentation

Information on this page was extracted from Microsoft and is subject to changes from Microsoft. Please refer to the following Microsoft documentation page if you are having any issues with the described steps:

https://learn.microsoft.com/en-us/graph/auth-register-app-v2 

Create App Registration

In the Azure Active Directory of your Tenant, navigate to App registrations and create a New registration. Choose a name and select "Register".

Create a User with permissions to use the Application

Navigate to Azure Active Directory → Users and create a new User

Assign the Role "Cloud Application Administrator" to the new user.

Additional User Configuration

The users default password must be changed during first login. Log into the account on for example a different browser to complete a first-login and set a new password.

Info
titleAutomatic Passwort Reset

Depending on your Azure AD configuration and security, the users password might reset by default after a defined amount of time has passed. If you do not wish to disable this for this User, make sure to keep track of the date, as the configuration in the jtel Teams Presence Aggregator contains the password of the user and must be changed accordingly.

Assign the User to the Application

Navigate to the registered App configuration and into the tab "Owners" and add the User.

Grant Permissions

The Presence Connector requires permissions to read the users presence status. Configure the following permissions with "Add a permission" and grant the permssions by clicking on "Grant admin consent for <Tenant Name>".


Create a Client Secret

Navigate to Certificates and Secrets and click on "New client secret" to add a new secret.

Info
titleExpiry

As this secret will expire after the configured amount of time, please make note of this because it must be changed in the jtel Teams Presence Aggregator after being renewed in the Azure AD.


Gather all Information


Please provide all information on the following table to the contact who will be configuring the jtel Teams Presence Connector in your jtel ACD:

DataValue
Application (client) ID
Directory (tenant) ID
Secret Value
User email address
User password

Postman Collections

To see what is going on, import the postman collections as described here:

https://github.com/microsoftgraph/microsoftgraph-postman-collections

Demo:

Application: Get App Only Access Token

Image Removed

Application: Get Users

Image Removed

On Behalf of a User: Get User Access Token

Image Removed

Get Presence status of a specific user

This request does not exist in the postman collection, you have to create a new GET request as below:

URL: https://graph.microsoft.com/beta/users/{{users_id}}/presence

Authorization: Bearer token using the variable: {{UserAccessToken}}.

Image Removed

For more details about the MS Graph Get preseence for multiple users, please see https://docs.microsoft.com/en-us/graph/api/cloudcommunications-getpresencesbyuserid?view=graph-rest-1.0&tabs=http



Sv translation
languagede

Azure-Konfiguration

Erstellen eines Zugriffstokens für die Anwendung

Erstellen Sie die Anwendung und registrieren Sie sie wie hier beschrieben: https://docs.microsoft.com/en-us/graph/auth-register-app-v2


Berechtigungen erteilen

Der Presence Connector benötigt mindestens diese Angaben. Klicken Sie außerdem auf Admin-Zustimmung für die Jtel GmbH erteilen.


Ein Kundengeheimnis erstellen

Sammeln Sie alle Informationen

Sie benötigen:

Der Benutzer und das Passwort sind die E-Mail und das Passwort für den Team-Administrator.

Postman-Sammlungen

Um zu sehen, was vor sich geht, importieren Sie die postman-Sammlungen wie hier beschrieben:

https://github.com/microsoftgraph/microsoftgraph-postman-collections

Demo:

Application: Get App Only Access Token

Application: Get Users

On Behalf of a User: Get User Access Token

Anwesenheitsstatus eines bestimmten Benutzers abrufen

Diese Anfrage existiert nicht in der Postman-Sammlung. Sie müssen eine neue GET-Anfrage wie unten beschrieben erstellen:

URL: https://graph.microsoft.com/beta/users/{{users_id}}/presence

Authorization: Bearer token  unter Verwendung der Variablen:  {{UserAccessToken}}.

Weitere Einzelheiten über die MS Graph Get-Priorität für mehrere Benutzer finden Sie unter

https://docs.microsoft.com/en-us/graph/api/cloudcommunications-getpresencesbyuserid?view=graph-rest-1.0&tabs=http

Sv translation
languagefr

Configuration d'Azure

Créer un token d'accès pour l'application

Créez l'application et enregistrez-la comme décrit ici:

https://docs.microsoft.com/en-us/graph/auth-register-app-v2


Accorder des autorisations

Le Connecteur de Présence aura besoin d'au moins cela. Cliquez également sur Accorder le consentement de l'administrateur pour Jtel GmbH.


Créer un secret client

Rassembler toutes les informations

Vous aurez besoin :

  • L'Application (client) ID
  • le répertoire (tenant) ID
  • Le secret du client
  • Scope: https://graph.microsoft.com/.default
  • Utilisateur : adresse e-mail (Nous n'avons pas besoin d'une licence)
  • Mot de passe: xxxxxxxxxxxx.

L'utilisateur et le mot de passe sont l'email et le mot de passe de l'administrateur de Teams.

Collections du Postman

Pour voir ce qui se passe, importez les collections postman comme décrit ici:

https://github.com/microsoftgraph/microsoftgraph-postman-collections

Demo:

Application: Get App Only Access Token

Application: Get Users

On Behalf of a User: Get User Access Token

Get Presence status of a specific user

Cette requête n'existe pas dans la collection Postman, vous devez créer une nouvelle requête GET comme ci-dessous :

URL: https://graph.microsoft.com/beta/users/{{users_id}}/presence

Authorization: Bearer token en utilisant la variable: {{UserAccessToken}}.

Pour plus de détails sur la préséance de MS Graph Get pour les utilisateurs multiples, voir

https://docs.microsoft.com/en-us/graph/api/cloudcommunications-getpresencesbyuserid?view=graph-rest-1.0&tabs=http