Merge pull request #247750 from rcdun/number_management_portal_fixes

Fix Number Management Portal docs

Author: ttorble

articles/communications-gateway/connect-operator-connect.md

@@ -5,7 +5,7 @@ author: rcdun
 ms.author: rdunstan
 ms.service: communications-gateway
 ms.topic: integration
-ms.date: 11/15/2023
+ms.date: 11/27/2023
 ms.custom:
     - template-how-to-pattern
     - has-azure-ad-ps-ref
@@ -85,9 +85,9 @@ To add the Project Synergy application:
 1. Select **Properties**.
 1. Scroll down to the Tenant ID field. Your tenant ID is in the box. Make a note of your tenant ID.
 1. Open PowerShell.
-1. Run the following cmdlet, replacing *`<AADTenantID>`* with the tenant ID you noted down in step 5.
+1. Run the following cmdlet, replacing *`<TenantID>`* with the tenant ID you noted down in step 5.
     ```azurepowershell
-    Connect-AzureAD -TenantId "<AADTenantID>"
+    Connect-AzureAD -TenantId "<TenantID>"
     New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"
     ```
 
@@ -106,7 +106,7 @@ The user who sets up Azure Communications Gateway needs to have the Admin user r
 
 ## Find the Object ID and Application ID for your Azure Communication Gateway resource
 
-Each Azure Communications Gateway resource automatically receives a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md), which Azure Communications Gateway uses to connect to the Operator Connect environment. You need to find the Object ID and Application ID of the managed identity, so that you can connect Azure Communications Gateway to the Operator Connect or Teams Phone Mobile environment in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway) and [Add the Application ID for Azure Communications Gateway to Operator Connect](#add-the-application-id-for-azure-communications-gateway-to-operator-connect).
+Each Azure Communications Gateway resource automatically receives a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md), which Azure Communications Gateway uses to connect to the Operator Connect environment. You need to find the Object ID and Application ID of the managed identity, so that you can connect Azure Communications Gateway to the Operator Connect or Teams Phone Mobile environment in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway) and [Add the Application IDs for Azure Communications Gateway to Operator Connect](#add-the-application-ids-for-azure-communications-gateway-to-operator-connect).
 
 1. Sign in to the [Azure portal](https://azure.microsoft.com/).
 1. In the search bar at the top of the page, search for your Communications Gateway resource.
@@ -124,7 +124,7 @@ Each Azure Communications Gateway resource automatically receives a [system-assi
 Azure Communications Gateway contains services that need to access the Operator Connect API on your behalf. To enable this access, you must grant specific application roles to the system-assigned managed identity for Azure Communications Gateway under the Project Synergy Enterprise Application. You created the Project Synergy Enterprise Application in [Add the Project Synergy application to your Azure tenancy](#add-the-project-synergy-application-to-your-azure-tenancy).
 
 > [!IMPORTANT]
-> Granting permissions has two parts: configuring the system-assigned managed identity for Azure Communications Gateway with the appropriate roles (this step) and adding the application ID of the managed identity to the Operator Connect or Teams Phone Mobile environment. You'll add the application ID to the Operator Connect or Teams Phone Mobile environment later, in [Add the Application ID for Azure Communications Gateway to Operator Connect](#add-the-application-id-for-azure-communications-gateway-to-operator-connect).
+> Granting permissions has two parts: configuring the system-assigned managed identity for Azure Communications Gateway with the appropriate roles (this step) and adding the application ID of the managed identity to the Operator Connect or Teams Phone Mobile environment. You'll add the application ID to the Operator Connect or Teams Phone Mobile environment later, in [Add the Application IDs for Azure Communications Gateway to Operator Connect](#add-the-application-ids-for-azure-communications-gateway-to-operator-connect).
 
 Do the following steps in the tenant that contains your Project Synergy application.
 
@@ -147,9 +147,9 @@ Do the following steps in the tenant that contains your Project Synergy applicat
 1. Select **Properties**.
 1. Scroll down to the Tenant ID field. Your tenant ID is in the box. Make a note of your tenant ID.
 1. Open PowerShell.
-1. Run the following cmdlet, replacing *`<AADTenantID>`* with the tenant ID you noted down in step 5.
+1. Run the following cmdlet, replacing *`<TenantID>`* with the tenant ID you noted down in step 5.
     ```azurepowershell
-    Connect-AzureAD -TenantId "<AADTenantID>"
+    Connect-AzureAD -TenantId "<TenantID>"
     ```
 1. Run the following cmdlet, replacing *`<CommunicationsGatewayObjectID>`* with the Object ID you noted down in [Find the Object ID and Application ID for your Azure Communication Gateway resource](#find-the-object-id-and-application-id-for-your-azure-communication-gateway-resource).
     ```azurepowershell
@@ -200,14 +200,17 @@ If you don't already have an onboarding team, contact azcog-enablement@microsoft
 
 Go to the [Operator Connect homepage](https://operatorconnect.microsoft.com/) and check that you're able to sign in.
 
-## Add the Application ID for Azure Communications Gateway to Operator Connect
+## Add the Application IDs for Azure Communications Gateway to Operator Connect
 
-You must enable the Azure Communications Gateway application within the Operator Connect or Teams Phone Mobile environment. Enabling the application allows Azure Communications Gateway to use the roles that you set up in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway).
+You must enable Azure Communications Gateway within the Operator Connect or Teams Phone Mobile environment. This process requires configuring your environment with two Application IDs:
+-  The Application ID of the system-assigned managed identity that you found in  [Find the Object ID and Application ID for your Azure Communication Gateway resource](#find-the-object-id-and-application-id-for-your-azure-communication-gateway-resource). This Application ID allows Azure Communications Gateway to use the roles that you set up in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway).
+- A standard Application ID for Azure Communications Gateway. This ID always has the value `8502a0ec-c76d-412f-836c-398018e2312b`.
 
-To enable the application, add the Application ID of the system-assigned managed identity representing Azure Communications Gateway to your Operator Connect or Teams Phone Mobile environment. You found this ID in [Find the Object ID and Application ID for your Azure Communication Gateway resource](#find-the-object-id-and-application-id-for-your-azure-communication-gateway-resource).
+To add the Application IDs:
 
 1. Log into the [Operator Connect portal](https://operatorconnect.microsoft.com/operator/configuration).
-1. Add a new **Application Id**, using the Application ID that you found.
+1. Add a new **Application Id** for the Application ID that you found for the managed identity.
+1. Add a second **Application Id** for the value `8502a0ec-c76d-412f-836c-398018e2312b`.
 
 ## Register your deployment's domain name in Microsoft Entra
 

articles/communications-gateway/includes/communications-gateway-nmp-project-synergy-permissions.md

@@ -95,8 +95,6 @@ For full details of the media interworking features available in Azure Communica
 
 Operator Connect and Teams Phone Mobile require API integration between your IT systems and Microsoft Teams for flow-through provisioning and automation. After your deployment has been certified and launched, you must not use the Operator Connect portal for provisioning. You can use Azure Communications Gateway's Number Management Portal instead. This Azure portal feature enables you to pass the certification process and sell Operator Connect or Teams Phone Mobile services while you carry out a custom API integration project.
 
-The Number Management Portal is available as part of the optional API Bridge feature.
-
 For more information, see [Manage an enterprise with Azure Communications Gateway's Number Management Portal for Operator Connect and Teams Phone Mobile](manage-enterprise-operator-connect.md).
 
 > [!TIP]

articles/communications-gateway/interoperability-operator-connect.md

@@ -5,7 +5,7 @@ author: rcdun
 ms.author: rdunstan
 ms.service: communications-gateway
 ms.topic: how-to
-ms.date: 07/17/2023
+ms.date: 11/27/2023
 ms.custom: template-how-to-pattern
 ---
 
@@ -15,23 +15,26 @@ Azure Communications Gateway's Number Management Portal enables you to manage en
 
 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.
 
-> [!IMPORTANT]
-> You must have selected Azure Communications Gateway's API Bridge option to use the Number Management Portal.
-
 ## Prerequisites
 
-Confirm that you have [!INCLUDE [project-synergy-nmp-permissions](includes/communications-gateway-nmp-project-synergy-permissions.md)] permissions for the Project Synergy enterprise application and **Reader** access to your subscription. If you don't have these permissions, ask your administrator to set them up by following [Set up user roles for Azure Communications Gateway](provision-user-roles.md).
+Confirm that you have **Reader** access to your subscription and appropriate permissions for the Project Synergy enterprise application:
+
+<!-- Must be kept in sync with provision-user-roles.md - steps for understanding and configuring -->
+* 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](provision-user-roles.md).
 
-If you're assigning new numbers to an enterprise customer:
+If you're uploading new numbers for an enterprise customer:
 
-* You must know the numbers you need to assign (as E.164 numbers). Each number must:
+* 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 need to know the following information for each range of numbers.
+* You must know the following information for each number.
 
-|Information for each range of numbers |Notes  |
+|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.|
@@ -40,7 +43,19 @@ If you're assigning new numbers to an enterprise customer:
 |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 range of numbers. Up to 64 characters. |
+|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
 
@@ -50,39 +65,41 @@ If you're assigning new numbers to an enterprise customer:
 
 ## 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.
+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, select **Consents** in the sidebar.
+1. From the overview page for your Communications Gateway resource, find the **Number Management** section in the sidebar. Select **Consents**.
 1. Find the enterprise that you want to manage.
 1. 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
 
-Assigning numbers to an enterprise allows IT administrators at the enterprise to allocate those numbers to their users.
+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-an-enterprise-customer-to-manage), select **Manage numbers** from the menu.
-    * Otherwise, select **Numbers** in the sidebar and search for the enterprise using the enterprise's Microsoft Entra tenant ID.
-1. To add new numbers for an enterprise:
+    * Otherwise, find the **Number Management** section in the sidebar and select **Numbers**. Search for the enterprise using the enterprise's Microsoft Entra tenant ID.
+1. To upload new numbers for an enterprise:
     1. Select **Upload numbers**.
     1. Fill in the fields based on the information you determined in [Prerequisites](#prerequisites). These settings apply to all the numbers you upload in the **Telephone numbers** section.
-    1. In **Telephone numbers**, upload the numbers, as a comma-separated list.
+    1. In **Telephone numbers**, add the numbers:
+        * If you created a `.csv` file with multiple numbers as described in [Prerequisites](#prerequisites), select **Upload CSV file** and upload the file when prompted.
+        * Otherwise, select **Manual input** and add each number individually.
     1. Select **Review + upload** and **Upload**. Uploading creates an order for uploading numbers over the Operator Connect API.
     1. 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.
 1. To remove numbers from an enterprise:
     1. Select the numbers.
     1. Select **Release numbers**.
-    1. 1. Wait 30 seconds, then refresh the order status. When the order status is **Complete**, the numbers have been removed.
+    1. 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-an-enterprise-customer-to-manage), select **Civic addresses** from the menu.
-    * Otherwise, select **Civic addresses** in the sidebar and search for the enterprise using the enterprise's Microsoft Entra tenant ID.
+    * 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.
 1. 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.
 1. Optionally, select an individual address to view additional information provided by the enterprise (for example, the ELIN information).
 

articles/communications-gateway/manage-enterprise-operator-connect.md

@@ -5,7 +5,7 @@ author: rcdun
 ms.author: rdunstan
 ms.service: communications-gateway
 ms.topic: overview
-ms.date: 11/06/2023
+ms.date: 11/27/2023
 ms.custom: template-overview
 ---
 
@@ -62,8 +62,6 @@ Launching Operator Connect or Teams Phone Mobile requires you to use the Operato
 
 For more information, see [Number Management Portal for provisioning with Operator Connect APIs](interoperability-operator-connect.md#number-management-portal-for-provisioning-with-operator-connect-apis) and [Manage an enterprise with Azure Communications Gateway's Number Management Portal for Operator Connect and Teams Phone Mobile](manage-enterprise-operator-connect.md).
 
-The Number Management Portal is available as part of the optional API Bridge feature.
-
 > [!TIP]
 > The Number Management Portal does not allow your enterprise customers to manage Teams Calling. For example, it does not provide self-service portals.