Reference13r3:Concept App Service Connector for Microsoft 365

From innovaphone wiki
Revision as of 10:47, 27 September 2022 by The (talk | contribs) (New page: Apps {{FIXME|reason=This product is still in progress}} == Applies To == * innovaphone PBX from version 13r3 = Overview = Connector for Microsoft 365 synchronises...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Tools clipart.png FIXME: This product is still in progress

Applies To

  • innovaphone PBX from version 13r3

Overview

Connector for Microsoft 365 synchronises Microsoft Teams presences with the innovaphone PBX (unidirectional).

Requirements

  • innovaphone PBX
  • innovaphone Application Platform
  • App(Connector for Microsoft 365)
  • Connector for Microsoft 365 License per user

Concept

Configuration

Connector for Microsoft 365 has to be configured in the app itself and in the Azure Portal of Microsoft.

For configuring in the Azure Portal:

  • New App registration - Single Tenant
  • Add Api Permissions - Delegated Permissions: User.Read.All and Presence.Read.All
  • Grant admin permission
  • Authentication - Allow public client flows


For configuring the app you need the following parameter:

  • name of the master PBX
  • client ID of the registrated app from the azure portal
  • Tenant ID of your organization, also from the azure portal
  • credentials for your Microsoft Azure Portal login (User needs a Teams license)
  • notification uri "https://{your_domain}/microsoft365/subscriptions"

Where to get those parameters

Technical Overview

If the Connector for Microsoft 365 app is fully configured, the app connects to Microsoft to obtain a token. With the token, the app gets the teams users (with a Teams license) through the Microsoft Graph Api. A presence subscription to Microsoft is started with the licensed users of the PBX to get presence changes in Microsoft Teams for these users. A user subscription is also started to get changes of the users (adding, deleting or update). If a user has changed, the Teams users are retrieved again. If the presence has changed, it is forwarded to the PBX. The presences of Teams are mapped to the presences of the PBX.

  • User subscriptions are renewed every 60 minutes.
  • Presence subscriptions are renewed every 10 minutes.
  • License Check is made before every presence subscription.


Mapping Table

Teams Presence PBX Presence
Away away
BeRightBack away
Busy busy
DoNotDisturb dnd
InACall on-the-phone
InAMeeting meeting
Inactive online
PresenceUnknown online
Available online
Offline online
Offwork online
OutOfOffice away
UrgentInterruptionsOnly dnd
Presenting on-the-phone
InAConferenceCall on-the-phone

The value "online" unsets the Teams presence in the PBX.

Master/Slave

For Master/Slave combination the "Connector for Microsoft 365" App has to be added to the slave (if no full replication is on). The slave websocket connection is needed to display "on-the-phone" presence.

Related Articles

Troubleshooting

The app itself shows required states with green and red as connections to the Master PBX, Authentication and Presence Subscription to identify if there are problems. Sometimes it needs a little bit time until the states are changed. If the states remain, it is mandatory to enable logs on the app platform and check for more information.

If presence subscription does not work, please check if the configured user has a Microsoft Teams license.

Retrieved from "https://wiki.innovaphone.com/index.php?title=Reference13r3:Concept_App_Service_Connector_for_Microsoft_365&oldid=63479"