--- title: "Microsoft Teams Calling - Setting Up a HPBX Service" slug: "setting-up-a-microsoft-teams-calling-hpbx-service" updated: 2025-10-02T10:58:47Z published: 2025-10-02T10:58:47Z canonical: "docs.uboss.com/setting-up-a-microsoft-teams-calling-hpbx-service" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.uboss.com/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Teams Calling - Setting Up a HPBX Service ## Requirements **NOTE - this new service can be run alongside the Microsoft Teams Calling SIP Integration service. If you want to run both simply also assign this new HPBX service to the business.** ### User Service The *App Microsoft Teams Calling - HPBX* service adds calling functionality to your Microsoft Teams Environment. Please tariff the *Microsoft Teams Calling - HPBX* service in the same way you would any other service. ### Business Service Next you need to ensure that you have added a tariff for the *Microsoft Teams HPBX Business Service*. This is a "zero charge" business service. If you are unsure how to do this, please follow the guide link in the User Service section above. ### Device You also need to add a tariff for the *Teams HPBX Device*, this is a "zero rate" device. Again, if you are unsure how to do this, please follow the guide link in the User Service section above. ### Phone Numbers Each user with a Microsoft Teams Calling package requires a DDI number, please make sure you have them available in your number pool. ### Microsoft Phone System License The end users will require one of the following Microsoft licenses to enable the dial pad within the Microsoft Teams application, these should be assigned before setting anything up for the customer in Uboss. - Microsoft Teams Phone Standard - E5 ### Additional Microsoft Licenses For Initial Synchronisation During the initial Sync, Call2Teams requires 2 additional Microsoft licenses to setup the required domains. Please ensure that you have 2 spare of any of the following types - Microsoft 365 Business Basic or equivalent Business Licenses - Microsoft E3 or E5 licenses ### Microsoft 365 Global Administrator Details This is required so that the Global Administrator can receive the synchronisation emails and then login to the Call2Teams portal and perform "Sync Now" requests. ## Service Setup in Uboss ### Step One - Adding the Business Service At the business level, go to Assignments>Service Assignments, and assign the *Microsoft Teams HPBX Business Service* ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28121%29.png) The following sections of the service wizard are required: - Instance Name - The name or ID for the service - Microsoft 365 Global Admin User Details - You must add the Email Address, first and last names for the end customers Microsoft 365 Global Administrator. You can add further Global Admins after the service has been added. **NOTE - If you are assigning this service in addition to the Microsoft Teams Calling SIP Integration then the admin name must be different, the email address can be the same** ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28122%29.png) ### Step Two - Global Administrator Email Invitation **NOTE - If you are running this service in addition to the Microsoft Teams Calling SIP Integration, and you have already enabled the Teams sync, then you can just run a sync here** Once the service is added, the Microsoft 365 Global Administrator will receive a similar email to the below: ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%287%29.png) The Global Admin must click on Accept Invitation. This will take the user to the Call2teams portal. They must enter their login credentials for the Global Admin account. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%288%29.png) Once logged in the user will get an "Account Activation Success" message, and be redirected to the C2T portal. Next the Admin must click on the *Services* Tab, then the *Teams* Tab, finally click on the *slider* for *Sync Disabled* so that it shows as *On* and then press *Save* ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28123%29.png) Next the user will be prompted with some permissions boxes that they must accept, When they have done this the initial Call2Teams synchronisation with the MS Teams envrionment will begin. The *Sync Now* box will show as *Syncing* ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28124%29.png) This initial sync will take approximately 15 mins. If the Sync does not complete this is usually due to the lack of 2 spare MS liceneses as mentioned in the requirements at the start of this document. Either add 2 more or free 2 up and perform the sync again. When the sync is successful it will show in the portal like this: ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%2811%29.png) At this time the Global Admin can leave Call2teams until the Uboss provisioning user has added the remaining user elements. ### Adding Microsoft Teams Calling HPBX Service to a user #### Step Three - Assigning to a New User A Microsoft Teams Calling HPBC service can only be assigned to a hosted user, if the user does not already exist in the portal, when adding please set the *User Type* to *HOSTED* in Step 1 of the *Add User* wizard, and continue the wizard as normal. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28125%29.png) In Step 2 of the Wizard, the Primary Device should be the Teams HPBX Device and make sure you have selected a VoIP Number ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28128%29.png) In Step 3, select the App - Microsoft Teams Calling - HPBX service and click Next ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28127%29.png) Click *FInish* on the 4th step of the Wizard. Your new user should add successfully. #### Step Four - Assigning to an Existing User NOTE - For an existing user you must complete the following in order If you are adding this service to an existing Hosted user then go go to the devices Tab, and the Teams HPBX Device (it does not have to be the primary device) and press save. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28129%29.png) Next go to the Package & Service Tab and select the App - Microsoft Teams Calling - HPBX service. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28130%29.png) Under the VOIP Account Details tab make sure the user has a DDI and then Save the user. ### Step Five - Mapping Uboss Users to Microsoft Teams Users In this next step we will *map* the new Microsoft Teams Calling HPBX users to the users that have been pulled through from the Call2teams sync. Go to *Service Assignments* at the business level, and find the Microsoft Teams HPBX Business Service. Click on the *Users* tab, then the *Unmapped Users* tab. This tab shows a list of users on the left from Uboss that have a Microsoft Teams Calling HPBX User service assigned, their VoIP number, and then a dropdown list of all users that are available to be mapped to in MS Teams on the right. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28131%29.png) Select the User(s) to map together and then click *SAVE* . The service will now save, if there are no more *Unmapped Users* then this screen will now be empty. If the dropdown list does not containt the user that you are looking for then please check with the End Customer that they have correctly assigned a license to the user in the Office 365 portal. If they have already done this or have changed it then they must login to Call2teams and perform a new Sync. You will see the below when a user is successfully mapped. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28132%29.png) The *Mapped Users* tab will show a list of all the users *mappings*. If you have incorrectly assigned a Uboss Microsoft Teams Calling HPBX user to the wrong MS Teams user, then you can select and delete them here. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28133%29.png) ### Step 6 - Informing the Customer That a Sync is Required In the business service, there is a tab *Sync Jobs*. This tab will show all syncs that have been performed and whether or not they have been successful. You can also send a *Sync Now Email*, click on the button and it will email the Global Admin a generic email that tells them to login and perform a *Sync Now*. General rule, is that whenever anything is changed in the service, perform a sync. So once you have mapped the users, perform a sync. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%28134%29.png) Once you have mapped the users and synced the service is ready to go. ### Other Functions in the Business Service There are 2 other tabs in the business service: - Teams Calling Policy - Within here you have 3 options: 1. Override Calling Policies - Select this to edit the 2 dropdowns. 2. Voice Mail - Decide whether you want to Use Teams voicemail, Prohibit Teams voicemail and use the Uboss VM, or Prohibit both Teams Voicemail or Call Forwarding 3. Music On Hold - Decide whether you want to Use Teams Hold Music or Use the UBoss Hold Music. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%2888%29.png) - Admin Users - This tab allows you to add futher Microsoft 365 Global Admin Users. ![image.png](https://cdn.document360.io/334a2c15-3e03-4702-a06b-0946461deedc/Images/Documentation/image%2889%29.png)