Edit

Manage an enterprise with Azure Communications Gateway's Number Management Portal for Operator Connect and Teams Phone Mobile

  • Article

Azure Communications Gateway's Number Management Portal enables you to manage enterprise customers and their numbers through the Azure portal.

The Operator Connect and Teams Phone Mobile programs don't allow you to use the Operator Connect portal for provisioning after you've launched your service in the Teams Admin Center. The Number Management Portal is a simple alternative that you can use until you've finished integrating with the Operator Connect APIs.

Prerequisites

Confirm that you have Reader access to your subscription and appropriate permissions for the Project Synergy enterprise application:

  • To view existing configuration: PartnerSettings.Read, TrunkManagement.Read, and NumberManagement.Read
  • To make changes to consents (which represent your relationships with enterprises) and numbers: PartnerSettings.Read, TrunkManagement.Read, and NumberManagement.Write

If you don't have these permissions, ask your administrator to set them up by following Set up user roles for Azure Communications Gateway.

If you're uploading new numbers for an enterprise customer:

  • You must know the numbers you need to upload (as E.164 numbers). Each number must:
    • Contain only digits (0-9), with an optional + at the start.
    • Include the country code.
    • Be up to 19 characters long.
  • You must have completed any internal procedures for assigning numbers.
  • You must know the following information for each number.
Information for each number Notes
Calling profile One of the Calling Profiles created by Microsoft for you.
Intended usage Individuals (calling users), applications or conference calls.
Capabilities Which types of call to allow (for example, inbound calls or outbound calls).
Civic address A physical location for emergency calls. The enterprise must have configured this address in the Teams Admin Center. Only required for individuals (calling users) and only if you don't allow the enterprise to update the address.
Location A description of the location for emergency calls. The enterprise must have configured this location in the Teams Admin Center. Only required for individuals (calling users) and only if you don't allow the enterprise to update the address.
Whether the enterprise can update the civic address or location If you don't allow the enterprise to update the civic address or location, you must specify a civic address or location. You can specify an address or location and also allow the enterprise to update it.
Country The country for the number. Only required if you're uploading a North American Toll-Free number, otherwise optional.
Ticket number (optional) The ID of any ticket or other request that you want to associate with this number. Up to 64 characters.

If you're uploading multiple numbers, prepare a .csv file with the heading Numbers and one number per line (up to 10,000 numbers), as in the following example. You can use this file to upload multiple numbers at once with the same settings (for example, the same calling profile).

Numbers
+441632960000
+441632960001
+441632960002
+441632960003
+441632960004

Go to your Communications Gateway resource

  1. Sign in to the Azure portal.
  2. In the search bar at the top of the page, search for your Communications Gateway resource.
  3. Select your Communications Gateway resource.

Select an enterprise customer to manage

When an enterprise customer uses the Teams Admin Center to request service, the Operator Connect APIs create a consent. This consent represents the relationship between you and the enterprise.

The Number Management Portal allows you to update the status of these consents. Finding the consent for an enterprise is also the easiest way to manage numbers for an enterprise.

  1. From the overview page for your Communications Gateway resource, find the Number Management section in the sidebar. Select Consents.
  2. Find the enterprise that you want to manage.
  3. If you need to change the status of the relationship, select Update Relationship Status from the menu for the enterprise. Set the new status. For example, if you're agreeing to provide service to a customer, set the status to Agreement signed. If you set the status to Consent Declined or Contract Terminated, you must provide a reason.

Manage numbers for the enterprise

Uploading numbers for an enterprise allows IT administrators at the enterprise to allocate those numbers to their users.

  1. Go to the number management page for the enterprise.
    • If you followed Select an enterprise customer to manage, select Manage numbers from the menu.
    • Otherwise, find the Number Management section in the sidebar and select Numbers. Search for the enterprise using the enterprise's Microsoft Entra tenant ID.
  2. To upload new numbers for an enterprise:
    1. Select Upload numbers.
    2. Fill in the fields based on the information you determined in Prerequisites. These settings apply to all the numbers you upload in the Telephone numbers section.
    3. In Telephone numbers, add the numbers:
      • If you created a .csv file with multiple numbers as described in Prerequisites, select Upload CSV file and upload the file when prompted.
      • Otherwise, select Manual input and add each number individually.
    4. Select Review + upload and Upload. Uploading creates an order for uploading numbers over the Operator Connect API.
    5. Wait 30 seconds, then refresh the order status. When the order status is Complete, the numbers are available to the enterprise. You might need to refresh more than once.
  3. To remove numbers from an enterprise:
    1. Select the numbers.
    2. Select Release numbers.
    3. Wait 30 seconds, then refresh the order status. When the order status is Complete, the numbers have been removed.

View civic addresses for an enterprise

You can view civic addresses for an enterprise. The enterprise configures the details of each civic address, so you can't configure these details.

  1. Go to the civic address page for the enterprise.
    • If you followed Select an enterprise customer to manage, select Civic addresses from the menu.
    • Otherwise, find the Number Management section in the sidebar and select Civic addresses. Search for the enterprise using the enterprise's Microsoft Entra tenant ID.
  2. View the civic addresses. You can see the address, the company name, the description and whether the address was validated when the enterprise configured the address.
  3. Optionally, select an individual address to view additional information provided by the enterprise (for example, the ELIN information).

Next steps

Learn more about the metrics you can use to monitor calls.