Dialogue Cloud

Microsoft Graph Presence Source Configuration

Introduction

The Microsoft Graph Presence Source (hereafter 'presence source') enables the UCC to use Teams user presences. It makes use of the Microsoft Graph Communications Presence APIs. Read more about Presence Resource Type at Microsoft Documentation.

Per a AD account the UCC can poll up to 200 unique users. In scenario's with more then 200 unique, you can add additional AD accounts.

The UCC will poll the presence each 500ms with a maximum of 100 users at a time. For UCCs with large amounts of agents, it is possible to add multiple AD accounts. For example when 500 unique agents are configured in the UCC (service wide) 3 accounts are needed to have the presence of all users polled every second.

 

Account requirements

The accounts to retrieve presence must be Azure Active Directory user accounts, these accounts will be able to retrieve presence from users that arein the same tenant. When subscribing users across different tenants, at least one account is needed from each tenant. The accounts do not need any permissions as they are granted globally by tenant admin, nor do they need any licenses. Simply create an new user account without licenses.

To grant admin consent for the Anywhere365 UCC Presence Source, simply replace {tenant-id} with your tenant ID in the following URL and launch it in a web browser. After the admin consent is granted, you will be able to sign in with non-admin user accounts in the presence source

Example https://login.microsoftonline.com/common/adminconsent?client_id=99077b9e-cb11-4fb7-b493-fbc6907245e6

Note A user with the Global Admin Role can perform this action.

Make sure to create dedicated accounts in the Azure Tenant as the API limits are account specific (see FAQ for API limits).

 

Permissions

 

Verify

To verify if the application is successfully added, you can perform the following steps:

  1. Sign into the Azure Portal, with a Azure Admin

  2. Navigate to Azure Active Directory

  3. Navigate to Enterprise applications tab

  4. In here you can find an application named "Anywhere365 UCC Teams Presence Source"

 

Password policy

When the password of an account changes, the tokens of the account will also expire. Make sure to set a password policy that will never expire passwords. Also make sure that the password isn't changed while in use by MS Graph Presence Provider. To ensure safety, make sure to use a long and safe password.

 

App registration

 

Use a different App registration

By default an app registration of WSP is used to authenticate the user with. In the scenario that you would prefer to host the application on your tenancy, please follow the steps below, once the application is created, replace the application ID in the regsitration URL above with the new one, and the tenant ID with your Tenant ID accordingly:

  • In Azure Active Directory create a new app registration

  • On the API Permissions tab, add the following delegated Graph API permissions

    • Directory.Read.All

    • User.ReadBasic.All

    • Presence.Read.All

  • The Directory.Read.All permission needs Admin consent, so grant the admin consent using the button. In the API permissions view.

    • Only a tenant administrator can grant the admin consent

  • On the Authentication tab

    • Add a new platform, choose type = web and enter a valid URL (https)

    • Set multiple tenant access on (optional if you only have one tenant)

    • Under advanced settings, set Treat application as a public client to Yes

  • From the overview page, copy the Application ID

The ClientId can then be shared with your Anywhere365 contact.

Add Teams users as agents

To use Teams presence

Teams users are matched by their User Principal Name (UPN). In most cases this is the e-mail address of the user. The UCC will create a Teams UPN field in the SharePoint list. The field can be added to the overview page with 'Modify view' button. When the field is not empty, this presence source will be selected over any other presence source. So if the Attendant presence source is desired, make sure this field is left blank.

To use Teams presence, fill in the Teams UPN field with the desired UPN of the user.

To use other presence sources

This presence source has the highest priority over other presence sources, but only when the Teams UPN SharePoint field is populated. This is also the case when this presence source is disabled. The UCC will raise errors that Graph Presence source is not enabled.

 

Related Topics

Additional Configuration Core

Using Microsoft Teams client with Anywhere365