Introduced in June 2025, the Unified Connector App contains all services (eg. SMS, PBX, Chat and CallApp) that are configured for a given user. It can be deployed in place of any of the stand-alone apps.
This document guides an Enterprise Admin in deploying the Unified Connector App into an organization’s Microsoft Teams catalog.
All the service configurations require the participation of the Service Provider, so coordinate accordingly as you follow the steps below.
Instructions
Assess the risk of granting the consents to your service provider. If acceptable, grant consents on the Microsoft permissions involve in deploying the apps. Doing so reduces the number of interactions between the service provider and global admin during app deployment.
If using the PBX Connector service, follow the steps presented in PBX Connector Installation Step-by-Step Guide EXCEPT the steps about building and deploying the PBX Connector App.
In addition to the PBX, if using the CallApp Add-on, follow the steps presented in CallApp Installation Step-by-Step Guide EXCEPT the steps about building and deploying the Teams Call App.
If using the SMS Connector service, follow the steps presented in SMS Connector Installation Step-by-Step Guide EXCEPT the steps about building and deploying the SMS Connector App.
If using the Chat App, arrange with your Service Provider to enable the Chat Service for your enterprise.
The Service Provider should Customize and Deploy Unified Connector App for an Enterprise.
After the above step, the Global Admin will see in the Enterprise Admin Action Items table the “Teams Unified Application” with Pending Synchronization status.
First, ensure you have custom apps enabled for Teams.
Then, click on Sync Unified App button.
Accept the required permission prompts.
Once the permissions are accepted, the deployment continues. The picture below shows deployment in progress.
Monitor the status of app deployment.
A successful deployment means the “UNIFIED” app will show in the Custom Teams Application table found in the Enterprise Dashboard page.
If the app was previously deployed and installed by your Teams users, they will automatically get the app changes discussed here the next time they sign in to the Teams client.
Troubleshooting
If error is encountered, check the various troubleshooting guides and apply the recommended steps:
Troubleshooting App Deployment Issues
Note to the Service Provider
If errors are still encountered after trying out the various troubleshooting steps, submit help ticket through the Service Portal.
Next Steps
Assign the required licenses to users who will use the Unified App Connector. See Microsoft Licensing for Unified Connector
Direct your end users to read the guide here: Using the Unified App.