Manage an enterprise with Azure Communications Gateway's Number Management Portal (preview)

Azure Communications Gateway's Number Management Portal (preview) enables you to manage enterprise customers and their numbers through the Azure portal. Any changes made in this portal are automatically provisioned into the Operator Connect and Teams Phone Mobile environments. You can also use Azure Communications Gateway's Provisioning API (preview). For more information, see Provisioning API (preview) for Azure Communications Gateway.

Important

The Operator Connect and Teams Phone Mobile programs require that full API integration to your BSS is completed prior to launch in the Teams Admin Center. This can either be directly to the Operator Connect API or through the Azure Communications Gateway's Provisioning API (preview).

You can:

  • Manage your agreement with an enterprise customer.
  • Manage numbers for the enterprise.
  • View civic addresses for an enterprise.
  • Configure a custom header for a number.

Prerequisites

Confirm that you have Reader access to the Azure Communications Gateway resource and appropriate permissions for the AzureCommunicationsGateway enterprise application:

  • To view configuration: ProvisioningAPI.ReadUser.
  • To add or make changes to configuration: ProvisioningAPI.ReadUser and ProvisioningAPI.WriteUser.
  • To remove configuration: ProvisioningAPI.ReadUser and ProvisioningAPI.DeleteUser.
  • To view, add, make changes to, or remove configuration: ProvisioningAPI.AdminUser.

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

Important

Ensure you have permissions on the AzureCommunicationsGateway enterprise application (not the Project Synergy enterprise application). The AzureCommunicationsGateway enterprise application was created automatically as part of deploying Azure Communications Gateway.

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

  • You must complete any internal procedures for assigning numbers.
  • 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 know the following information for each number.
Information for each number Notes
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.

Each number is automatically assigned to the Operator Connect or Teams Phone Mobile calling profile associated with the Azure Communications Gateway that is being provisioned.

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.

Manage your agreement with an enterprise customer

When an enterprise customer uses the Teams Admin Center to request service, the Operator Connect APIs create a consent. The consent represents the relationship between you and the enterprise. The Number Management Portal displays a consent as a Request for Information and allows you to update the status.

  1. From the overview page for your Communications Gateway resource, find the Number Management (Preview) section in the sidebar.
  2. Select Requests for Information.
  3. Find the enterprise that you want to manage. You can use the Add filter options to search for the enterprise.
  4. If you need to change the status of the relationship, select the enterprise Tenant ID then select Update relationship status. Use the drop-down to select 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.

If you're providing service to an enterprise for the first time, you must also create an Account for the enterprise.

  1. Select the enterprise, then select Create account.
  2. Fill in the enterprise Account name.
  3. Select the checkboxes for the services you want to enable for the enterprise.
  4. Fill in any additional information requested under the Communications Services Settings heading.
  5. Select Create.

Manage numbers for the enterprise

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

  1. In the sidebar, locate the Number Management (Preview) section and select Accounts. Select the enterprise Account name.
  2. Select View numbers to go to the number management page for the enterprise.
  3. 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 Add numbers section.
    3. In Add numbers add each number individually.
    4. Select Review and 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.
  4. To remove numbers from an enterprise:
    1. Select the numbers.
    2. Select Delete 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. In the sidebar, locate the Number Management (Preview) section and select Accounts. Select the enterprise Account name.
  2. Select Civic addresses to view the Unified civic addresses page for the enterprise.
  3. You can see the address, the company name, the description, and whether the address was validated when the enterprise configured the address.
  4. Optionally, select an individual address to view additional information provided by the enterprise, for example the Emergency Location Identification Number (ELIN).

Configure a custom header for a number

You can specify a custom SIP header value for an enterprise telephone number, which applies to all SIP messages sent and received by that number.

  1. In the sidebar, locate the Number Management (Preview) section and select Numbers.
  2. Select the Phone number checkbox then select Manage number.
  3. Specify a Custom SIP header value.
  4. Select Review and upload then Upload.

Next steps

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