Prepare for live traffic with Zoom Phone Cloud Peering and Azure Communications Gateway

Before you can launch your Zoom Phone Cloud Peering service, you and your onboarding team must:

  • Test your service.
  • Prepare for launch.

In this article, you learn about the steps that you and your Azure Communications Gateway onboarding team must take.

Important

Some steps can require days or weeks to complete. We recommend that you read through these steps in advance to work out a timeline.

Prerequisites

Complete the following procedures.

Choose test numbers. You need two types of test number:

  • Integration testing by your staff.
  • Service verification (continuous call testing) by your chosen communication services.

You must provision Azure Communications Gateway with the numbers for integration testing during this procedure.

  • To use Azure Communications Gateway's Number Management Portal (preview) for provisioning (recommended), you must have Reader access to the Azure Communications Gateway resource and ProvisioningAPI.ReadUser and ProvisioningAPI.WriteUser roles for the AzureCommunicationsGateway enterprise application.
  • To use Azure Communications Gateway's Provisioning API (preview), you must be able to make requests using a client integrated with the API. You must also have access to the API Reference.

You must be an owner or admin of a Zoom account that you want to use for testing.

You must be able to contact your Zoom representative.

Configure the test numbers for integration testing on Azure Communications Gateway

You must provision Azure Communications Gateway with the details of the test numbers for integration testing. This provisioning allows Azure Communications Gateway to identify that the calls should have Zoom service.

Important

Do not provision the service verification numbers for Zoom. Azure Communications Gateway routes calls involving those numbers automatically. Any provisioning you do for those numbers has no effect.

We recommend using the Number Management Portal (preview) to provision the test numbers. Alternatively, you can use Azure Communications Gateway's Provisioning API (preview).

  1. From the overview page for your Communications Gateway resource, find the Number Management section in the sidebar. Select Accounts.
  2. Select Create account. Enter an Account name and select the Enable Zoom Phone Cloud Peering checkbox. Select Create.
  3. Select the checkbox next to the new Account name and select View numbers.
  4. Select Create numbers.
  5. Fill in the fields as required under Manual Input, and then select Create.

Configure users in Zoom with the test numbers for integration testing

Upload the numbers for integration testing to Zoom. When you upload numbers, you can optionally configure Zoom to add a header containing custom contents to SIP INVITEs. You can use this header to identify the Zoom account for the number or indicate that these numbers are test numbers. For more information on this header, see Zoom's Zoom Phone Provider Exchange Solution Reference Guide.

Use https://support.zoom.us/hc/en-us/articles/360020808292-Managing-phone-numbers to assign the numbers for integration testing to the user accounts that you need to use for integration testing. Integration testing is part of preparing for live traffic.

Important

Do not assign the service verification numbers to Zoom user accounts. In the next step, you will ask your Zoom representative to configure the service verification numbers for you.

Provide Zoom with the details of the service verification numbers

Ask your Zoom representative to set up the resiliency and failover verification tests using the service verification numbers. Zoom must map the service verification numbers to datacenters in ascending numerical order. For example, if you allocated +19075550101 and +19075550102, Zoom must map +19075550101 to the datacenters for DID 1 and +19075550102 to the datacenters for DID 2.

This ordering matches how Azure Communications Gateway routes calls for these tests, so allows Azure Communications Gateway to pass the tests.

Update your network's routing configuration for the test numbers

Update your network configuration to route calls involving all the test numbers to Azure Communications Gateway. For more information about how to route calls to Azure Communications Gateway, see Call routing requirements.

Carry out integration testing and request changes

Network integration includes identifying SIP interoperability requirements and configuring devices to meet these requirements. For example, this process often includes interworking header formats and/or the signaling and media flows used for call hold and session refresh.

You must test typical call flows for your network. Your onboarding team will provide an example test plan that we recommend you follow. Your test plan should include call flow, failover, and connectivity testing.

  • If you decide that you need changes to Azure Communications Gateway, ask your onboarding team. Microsoft must make the changes for you.
  • If you need changes to the configuration of devices in your core network, you must make those changes.
  • If you need changes to Zoom configuration, you must arrange those changes with Zoom.

Run connectivity tests and provide proof to Zoom

Before you can launch, Zoom requires proof that your network is properly connected to their servers. The testing you need to carry out is described in Zoom's Zoom Phone Provider Exchange Solution Reference Guide or other documentation provided by your Zoom representative.

You must capture the signaling in your network and provide the proof to your Zoom representative.

Test raising a ticket

You must test that you can raise tickets in the Azure portal to report problems with Azure Communications Gateway. See Get support or request changes for Azure Communications Gateway.

Note

If we think a problem is caused by traffic from Zoom servers, we might ask you to raise a separate support request with Zoom. Ensure you also know how to raise a support request with Zoom.

Learn about monitoring and maintenance

Your operations team can use a selection of key metrics to monitor Azure Communications Gateway. These metrics are available to anyone with the Reader role on the subscription for Azure Communications Gateway. See Monitoring Azure Communications Gateway.

Your operations team must have Azure Monitor alerts for:

Schedule launch

Your launch date is the date that you'll be able to start selling Zoom Phone Cloud Peering service. You must arrange this date with your Zoom representative.