Switchvox - Sangoma Phone for Microsoft Teams- Deployment Guide

Switchvox - Sangoma Phone for Microsoft Teams- Deployment Guide

Table of Contents

Overview

This guide outlines the administrator setup for the embedded Sangoma Phone integration within Microsoft Teams.

Refer to the https://sangoma.atlassian.net/wiki/spaces/BIT/pages/5273583666/Switchvox+Microsoft+Teams+Integration-+Using+Sangoma+Phone+Inside+Microsoft+Teams#Steps-to-Add-a-Sangoma-Phone-in-Microsoft-Teams for the MS Teams user instructions.

Note: Users may need to reload, close, or restart Microsoft Teams for the new app to appear.

Prerequisites

Before deployment, ensure the following:

  • Switchvox must have an SSL certificate from a trusted authority. See HTTPS and SSL Certificates - 3rd Party Certificate Authority.

  • Access to the Microsoft Teams Admin Center

  • The Sangoma Phone Teams file

  • Appropriate admin permissions to upload and manage Teams apps

  • Switchvox Users (SIP Phone extensions) who will use the app have a Email Address for Login that matches the email address they use to log into Teams:

    image-20260313-114941.png
    • NOTE: a password is not necessary in this scenario. MS Teams passes this email address to the embedded Sangoma Phone app, and if it matches then a password is not necessary.

Admin Deployment Steps

  1. Log In

  2. Navigate to Manage Apps

    • Expand Teams apps.

    • Click on Manage apps.

  3. Download the Sangoma Phone for MS Teams file

    • Download the Sangoma Phone Teams file to your local device.

  4. Upload the Sangoma Phone Teams App to Microsoft Teams

    • In the top right, click Actions and then select + Upload new app.

      31fc6258-a79d-4e35-bbb2-18602bdfac23.png

       

    • Upload the file that was downloaded in the prior step.

  5. Locate the App

    • Once the upload completes, click the link to manage the app,
      or search for Sangoma Phone in the Manage apps section.

      image (28).webp
  6. Configure Permissions

    • Open the app configuration.

    • Go to the Permissions tab.

    • Select Grant admin consent.

      63a9aeb9-6caf-4447-83e6-17aa29f4ec0c.png
    • In the Grant admin consent window, review the requested permissions and click Accept.

      77a8b85d-ee54-49c3-bea6-fe9824fe824e.png
    • Once permissions are granted, the admin should be able to view the same in the permission tab

      • e30c47e4-27ee-4fb5-b3d5-4722886fa3d7.png
      • Now the end users can add the embedded Sangoma Phone App to their Microsoft Teams instance.