Documentation
pascom Cloud Phone System Documentation and Release Notes
Microsoft 365 User Status Connector
Trainings Video
Concept
With the MS365 status connector, it is possible to retrieve the user status from within the world of Microsoft 365. For the connector to function, a Microsoft Azure Active Directory (aadds) user directory is required. The status synchronisation is only available as a cloud-to-cloud synchronisation.
In order for the user state synchronisation to be successful, the user must have the same username for both the pascom phone system and the Azure AD (userPrincipalName).
To learn how to import users from Azure Active Directory, please click here.
Microsoft Teams Integration - In-Call Status
A Microsoft 365 user is in on Microsoft Teams video meeting or call, their MS365 status is changed to In-Call. The pascom Microsoft 365 Status Connector enables the synchronisation of the In-call status with the pascom client profiles. Therefore, the presence status of a pascom user will automatically change to the Teams Meeting profile as soon as the user enters a Microsoft Teams meeting.
Setup The Microsoft 365 Status Connector Profile
To setup the Microsoft 365 status connector, log into your pascom cloud phone system admin UI and follow the steps below:
- Go to .
- Select .
- Add a new connector via the menu item .
- Select the Microsoft 365 Status connector template.
- Enter a name for the connector, e.g. Teams Integration.
- Click .
Configure The Microsoft 365 Status Connector Profile
To configure the connector profile and enable the MS365 status synchronisation with the pascom apps and client profiles, the following settings need to be configured.
Setting | Description |
---|---|
Title | Connector profile name |
Source | MSSTATUS - Microsoft 365 user status |
Sync Status | Enabled per Default. Synchronisation can also be disabled. |
Profile during Teams meeting | Choose a server-base pascom client profile which is linked to the Microsoft 365 Status Connector. As standard, a new Teams Meeting profile will be created, which can then be distributed to users using roles as normal. |
Authenticate | Connect to your Microsoft account to authenticate the cloud to cloud connection. |
Microsoft Account Authentication
In order for the pascom Connector to import your Microsoft Office 365 contacts data, you must first authenticate yourself using your Microsoft account. To do this, use the “click here” link in the “Authenticate” settings option. This will redirect you to the Microsoft login screen.
Finally, you must confirm your authorisation in order to allow the pascom phone system access to your MS365 contacts. Once done, you will successfully connected your pascom phone system and Microsoft 365 environments.
Further customize Microsoft 365 Status Connector
In the Variables tab, you can set a more flexible MSSTATUS user matching, which allows the use of different AD account names.
- UserPrincipalName
- SamAccountName
- mailNickname
To do this, simply change the comment parameters (#) at the desired piece of code.
The Teams Meeting Client Profile
During the Microsoft Status connector set up, a new server-based Teams Meeting profile will have been created.
As standard, the Teams Meeting profile is a sticky profile and cannot be overridden by e.g. automatically timed profiles. However, you can create your own server-based Teams Meeting profile and link it to the status connector.
For more information about how the Teams Meeting profile works and which trigger is used, please refer to the client profiles guide.
User Status Synchronisation
It normally takes between 05 and 10 seconds for the pascom client to automatically switch the user’s status profile to Teams Meeting once a user starts a Microsoft Teams meeting (audio or video call). Microsoft does offer guaranteed response time, which can take up to 1 minute.
Once the user states have been synchronised, the user will not be able to receive any calls via the pascom apps for the duration of their Teams Meeting. Once the meeting has finished and the user has disconnected from the session, the status sync will automatically switch the user profile back last enabled client profile.
For more information regarding connector handling times, Microsoft provides a list of expected average synchronisation handling times: Status synchronisation times.
Changes in your Azure Active Directory
If you make changes to your users in Azure Active Directory, these changes can take 1 day to be reflected within the Microsoft 365 Status connector. However, you can synchronise the changes (new users, changed or deleted users) by performing a manual import as shown in the image below.