Deploy and Sync the PBX Connector App

  • Updated on Jun 17, 2025
  • Published on May 13, 2025
  • 2 minute(s) read
Prev Next

The PBX App is an optional accessory to the PBX Connector service.  Once it is installed by a user, it enables user-specific information to be exchanged between Teams and the PBX or UCaaS server.  Some of the capabilities of the PBX App are:

  • It can communicate with the SIP server to sync presence information  
  • It can generate adaptive call cards that can be displayed to a Teams user when pre-determined events occur (such as voicemail notifications)
  •  It can display the PBX user portal inside the Teams app.
  • It is brand-able and can be customized to display your name, logo and other information.

This document guides an Enterprise Admin in deploying the PBX Connector App into an organization’s Microsoft Teams catalog.

Before You Begin

  • Arrange with your ConnecttoTeams service provider to enable the PBX service for your enterprise account.

  • Arrange with your ConnecttoTeams service provider to save the app settings in the App Management page.

  • Learn about the general guide in PBX Connector Installation Step-by-Step Guide.

Instructions for the Reseller

To enable PBX for enterprise, see Enable PBX Service for an Enterprise.

To configure your default PBX app template, see Build PBX App Template

To customize and deploy the SMS app for the enterprise, see Customize and Deploy PBX App for an Enterprise.

Learn your set of tasks to configure the PBX Connector for the enterprise at PBX Connector Installation Step-by-Step Guide.

Deploy and Sync the Teams Connector App in Microsoft Teams

  1. As the Global Administrator of the enterprise, from the Enterprise Admin Menu, navigate to Dashboard.


  2. In the Enterprise Admin Action Items table, click Sync PBX App button.

    Supported browser

    Use Chrome browser when Synching the PBX app. Other browsers like Firefox fails to submit the request when the button on the popup is clicked

  3. Then the Sync PBX Teams Application windows will pop up, and click Provision Application.

    The status will change from Pending Synchronization to Deployment in Progress.


    It will take a few minutes for the App to be built and to show under the Custom Teams Application.

  4. Check the notification section, you should get three notifications by the time it is done.

When the app is not successfully deployed and the app goes through the verification state where the Verify <app> App button displays under the Action Required column, see the App Fails To Deploy to Teams Catalog Due to Microsoft Migration.

Verification may take up to 48 hours.

Troubleshooting the App

If the Enterprise wants to redeploy the app or if there's an issue deploying the app:

  1. The Service Provider will need to change the Team Name or the Application name (Short Name).  

  2. The app will be slated for 'Sync' again.

  3. The Enterprise Admin will then perform another sync for the app to be deployed afresh.

  4. If the new changes failed to be deployed, clean up the app on the Teams side and try again.

Related articles