Muokkaa

Jaa


Quickstart: get and manage a trial phone number in Azure Communication Services

Important

This feature of Azure Communication Services is currently in preview.

Preview APIs and SDKs are provided without a service-level agreement. We recommend that you don't use them for production workloads. Some features might not be supported, or they might have constrained capabilities.

For more information, review Supplemental Terms of Use for Microsoft Azure Previews.

Note

Trial Phone Numbers are currently only supported by Azure subscriptions with billing addresses based in the United States. For other geographies, please visit the Subscription eligibility documentation to determine where you can purchase a phone number.

Azure Communication Services provides powerful communication capabilities for developers to integrate voice, video, and SMS functionalities into their applications. One of the key features is the ability to acquire phone numbers for making and receiving calls. This quickstart guide walks you through the process of obtaining a trial phone number for Azure Communication Services.

Prerequisites

Get a trial phone number

  1. Navigate to your Communication Service resource in the Azure portal. Screenshot showing a Communication Services resource's main page.

  2. In the Communication Services resource overview, select on the "Phone numbers" option in the left-hand menu. Screenshot showing a Communication Services resource's phone numbers page. If you don’t have any phone numbers yet, you will see an empty list of phone numbers followed by this call to action for trial phone numbers.
    If you already have numbers for your Communication Services resource, you can also activate a trial phone number: Screenshot showing a Communication Services resource's phone numbers page with already purchased numbers.

  3. Select on “Activate trial phone number”. This immediately provisions a trial phone number to your Communication Services resource. Once the trial phone number is provisioned, you can view it on the Phone numbers page. Screenshot showing a Communication Services resource's phone numbers page with a trial phone number.

Add a verified phone number to your trial phone number

When using a trial phone number in Azure Communication Services for PSTN Calling capabilities, it is mandatory to verify the recipient phone number. This verification process ensures that the trial phone number can only make calls to the verified number.

  1. Once your trial phone number is provisioned, select the number in the Phone Numbers page and navigate to the “Trial details” tab: Screenshot showing a Communication Services resource's phone numbers page with a side panel open with the trial details tab. This tab shows the current limitations on the number, including the days left to use the number, the total calling minutes, and how many verified phone numbers are attached to the trial phone number. You can find more information on the trial phone number limitations here.

  2. Select on “Manage verified phone numbers” to start adding verified phone numbers. Screenshot showing a side panel with an empty list of verified phone numbers.

  3. Select “Add” or “Verify a phone number” and enter your phone number and designated country code associated with it. This recipient phone number is verified by sending a one-time passcode (OTP) to their number either through SMS or automated voicemail. Choose the option you prefer, and then press “Next” to receive the OTP. Screenshot showing a side panel with an entered phone number to verify. The radio button to text the phone number has been selected.

  4. Once the user gets the one-time-passcode (OTP), enter the code into the Portal to verify the number.
    Screenshot showing a side panel with an entered one-time passcode.

  5. Once the correct OTP is entered, the phone number is verified, it should show up in the list of verified numbers that the trial number can call. Screenshot showing a side panel with an added verified phone number.

Conclusion

Congratulations! You have successfully obtained a trial phone number for Azure Communication Services. You can now use this phone number to add voice capabilities to your applications. Explore the documentation and resources provided by Microsoft to learn more about Azure Communication Services and integrate it into your solutions.

Remember that trial phone numbers have limitations and are intended for evaluation and development purposes. If you require production-ready phone numbers, you can upgrade your Azure Communication Services subscription and purchase a phone number.

Next steps

In this quickstart you learned how to:

  • Activate a trial phone number
  • View your trial phone number limits
  • Add a verified phone number