--- title: "Deploy and Sync the PBX Connector App" slug: "deploy-and-sync-the-pbx-app" updated: 2025-08-26T06:25:21Z published: 2025-08-26T06:25:21Z canonical: "kb.connecttoteams.com/deploy-and-sync-the-pbx-app" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.connecttoteams.com/llms.txt > Use this file to discover all available pages before exploring further. # Deploy and Sync the PBX Connector App 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](/v1/docs/pbx-connector-installation-step-by-step-guide). > [!NOTE] > Instructions for the Reseller > > To enable PBX for enterprise, see [Enable PBX Service for an Enterprise](/v1/docs/enable-pbx-service-for-an-enterprise). > > To configure your default PBX app template, see [Build PBX App Template](/v1/docs/build-pbx-app-template) > > To customize and deploy the SMS app for the enterprise, see [Customize and Deploy PBX App for an Enterprise](/v1/docs/customize-and-deploy-pbx-app). > > Learn your set of tasks to configure the PBX Connector for the enterprise at [PBX Connector Installation Step-by-Step Guide](/v1/docs/pbx-connector-installation-step-by-step-guide). ## Deploy and Sync the Teams Connector App in Microsoft Teams 1. As the [Global Administrator](/v1/docs/global-administrator-requirement) of the enterprise, from the [Enterprise Admin Menu](/v1/docs/enterprise-admin-menu-standard), navigate to **Dashboard**. ![](https://cdn.us.document360.io/312e5ae5-e3c1-465d-8e37-f253a7ba8eee/Images/Documentation/image-970MO73R.png) 2. In the Enterprise Admin Action Items table, click **Sync PBX App** button. ![](https://cdn.us.document360.io/312e5ae5-e3c1-465d-8e37-f253a7ba8eee/Images/Documentation/image-ALN08VF6.png) > [!NOTE] > Supported browser > > Use [Chrome browser](/v1/docs/browser-compatibility) 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. ![](https://cdn.us.document360.io/312e5ae5-e3c1-465d-8e37-f253a7ba8eee/Images/Documentation/image-470YP3IE.png) The status will change from Pending Synchronization to Deployment in Progress. ![](https://cdn.us.document360.io/312e5ae5-e3c1-465d-8e37-f253a7ba8eee/Images/Documentation/image-XIGJA5HA.png) 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. ![](https://cdn.us.document360.io/312e5ae5-e3c1-465d-8e37-f253a7ba8eee/Images/Documentation/image-9EB1KLV9.png) > [!NOTE] > Troubleshooting > > When the app is not successfully deployed and the app goes through the **verification state** where the **Verify App** button displays under the **Action Required** column, see the [App Fails To Deploy to Teams Catalog Due to Microsoft Migration](/v1/docs/app-fails-to-deploy-to-teams-catalog-due-to-policies). > [!NOTE] > Delay > > 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](/v1/docs/delete-the-teams-application-in-microsoft-365) and try again. Your desired short name for the app. This is used in the app store to help users recognize that they have found the correct app when they search.