Table of Contents

Overview

Sangoma Send supports connecting to external contact sources, giving customers a flexible alternative to managing contacts directly within Send. With this feature, instead of manually uploading and maintaining static contact lists locally, customers can connect to an external identity provider to dynamically pull contact groups.

How to connect External Contacts to Sangoma Send

• Enter Select External Contacts in the menu on the left side.

  Open

  

• Enter the Microsoft Tenant ID, Application ID, and Secret retrieved from Microsoft Antra.
  For information on how to retrieve this info, reference the How to retrieve the Application ID, Tenant ID, and the Secret section below.

• Click the CONNECT MICROSOFT ACCOUNT button.

  Open

  

• Once the connection has been completed, select the type of phone number and emails that can be used in your send operation.

  Open

  

How to retrieve the Application ID, Tenant ID, and the Secret

• Go to Microsoft Entra admin center and log in with your credentials.

• Select App registration in the left side menu.
  To create a new application, follow the steps in the How to configure External Contacts section in this guide.

• Select the All application or the Owned application tabs.

• Search for and select the previously created application (Example: CPaaS Contacts).

• Copy the following Content:
  ① Tenant ID: Hover over the Directory (Tenant) ID field and click on Copy to clipboard.
  ② Application ID: Hover over the Application (Client) ID field and click on Copy to clipboard.
  ③ Secret: Hover over the Client credentials field and click on Copy to clipboard.

  Open

  

How to configure External Contacts in Microsoft

To allow Sangoma Send access to the Office 365 Management APIs, you need to
register the application in Microsoft Entra ID. This allows you to establish an identity.

Microsoft Entra

Configuring a new application

1. Go to Microsoft Entra admin center and log in with your credentials.

2. Click App registration in the left-side panel.

3. Click + New registration at the top of the page to create a new application connection.

   Open

   

4. New Application

   1. Name: Enter a name for the application. (Example: CPaaS contacts)

   2. Supported account types: Select Single tenant only - YOUR_ORGNAME

   3. Redirect URI: Leave the Redirect URI empty.

   4. Click the Register button.

      Open

      

       

5. Once created, click on Add a certificate or secret.

   Open

   

    

6. Click on + New client secret.

7. Description: Enter description for the application.

8. Expires: Select a length of time before the Secret expires.

9. Click the Add button to save the secret.

   Open

   

    

7. Click API permissions in the left-side panel.

8. Click + Add a permission.

9. Select Microsoft Graph in the displayed pop-up.

   Open

   

10. The Request API Permissions pop-up will be displayed.

11. Click on the Application Permissions tile.

12. Select permissions: Search and set the following 3 permissions:

    • User.Read.All:

      • Search for User.Read.All.

      • Expand User and select User.Read.All.

    • GroupMember.Read.All

      • Search for GroupMember.Read.All.

      • Expand GroupMember and select GroupMember.Read.All.

    • Group.Read.All

      • Search for Group.Read.All.

      • Expand Group and select Group.Read.All.

    • Click the Add permissions button after all permissions have been selected.

      Open

      

14. Finally, grant admin permission

    Open

    

Campaign Creation

External contacts are now available for selection in Audience when creating Campaigns - refer to Sangoma Send - Campaign Guide for details.