4.23 Set Up Swyx Direct for Microsoft Teams
Swyx Direct for Microsoft Teams enables full telephony integration between Swyx and Microsoft Teams. MS Teams users can make and receive internal calls and calls to landlines, while Swyx remains the central telephony platform.
Swyx Direct users can
*Call MS Teams users or subscribers on the public switched telephone network (PSTN) from Swyx,
*call Swyx users or subscribers on the public switched telephone network (PSTN) from Microsoft Teams,
*Receive calls from the public switched telephone network (PSTN) via Swyx or Microsoft Teams.
Requirements
Before you set up the Swyx Direct feature, the following prerequisites must be met on your Microsoft Azure platform and in your Swyx installation:
Microsoft Service Plan Licenses on Azure
The following Microsoft service plans with free licenses must be available in your Azure portal:
Service Plan
String ID
GUID
Microsoft Teams
TEAMS1
57ff2da0-773e-42df-b2af-ffb7a2317929
Microsoft Teams Phone / Microsoft 365 Phone System
MCOEV
4828c8ec-dc2e-4779-b502-87ac9ce28ab7
What's the point?
During setup, a new service account is to be automatically created, to which the service plans are assigned. The service account must have both service plan licenses and remain active for the entire duration of use. The service account name begins with "UMP...".
How do I purchase it?
Service plans can be purchased as a bundled product license (such as Microsoft 365 E5) or as a combination of license packages.
To find out which products or license packages include the required service plans, refer to the table on the Microsoft website:
Click "Expand table" and use the "Ctrl + F" shortcut to search for the string ID of the service plan you need.
MCOEV can be purchased as a separate Microsoft Teams Phone Standard license (e43b5b99-8dfb-405f-9987-dc307f34bcbd).
Example:
If the designated account has a Microsoft 365 E1 license, TEAMS1 is included, but MCOEV is not.
In this case, a Microsoft Teams Phone Standard license must also be assigned to the account, as it includes the required MCOEV service plan.
Swyx System Requirements
Before setting up Swyx Direct, make sure the following requirements are met:
*Online Licensing Swyx Flex or SwyxON and ordered Swyx Direct for MS Teams licenses for the desired number of users,
see 5.3 Additional functions
*Configured federated services with Entra ID,
see 4.21 Federated services via identity providers
*Microsoft Teams presence synchronization,
see 4.21.1 Microsoft Teams presence synchronization
Requirements for individual Swyx Direct users
To use Swyx Direct, the Swyx user must
*an assigned public phone number
and
*a configured federated identity in Entra ID,
see 9.3 Creating Users,
*the appropriate calling permission for making calls, see 9.9 Defining rights.
*From Swyx: an assigned Swyx Direct for MS Teams license,
see 4.5 Assign user-specific functions
*From Microsoft: a perpetual license that includes Direct Routing functionality for use with Microsoft Teams and Teams Phone.
Setup Process
Follow the steps below to complete the setup. Make sure you do not proceed to the next step until the previous one has been successfully completed.
1 In the PowerShell console: Register the Swyx Direct for MS Teams app in the Azure portal,
see How to register the Swyx app for Swyx Direct
2 In Swyx Control Center: Request the Swyx Direct for MS Teams connection from Swyx Support,
see 4.23.1 Connect Swyx Direct to Microsoft Teams
3 In Swyx Control Center: Assign the Swyx Direct feature to the desired users,
see 4.23.2 Activate Swyx Direct Users