Contoso Phone Radio

What is Contoso Phone Radio

Contoso Phone Radio is simple service that will accept phonecall, and then play music to the caller.

• Utilizes Azure Communication Service (ACS) Call Automation
• Able to answer incoming PSTN or VoIP calls
• Play media to the caller
• Simply deploy to Azure with provided ARM template

Prerequisites

1. An Azure account with an active subscription.
2. Provisioned Azure Communication Service resource
3. (Optional) Acquire a PSTN phone number from the Azure Communication Service resource.

Option 1: Deploy the Demo to Azure Web Apps

1. Make sure above Prerequisites are met.

2. Click on the Deploy to Azure Button

   

3. Fill out the values in the Deployment page

   • Subscription / Resource Group: Select your provisioned Subscription and Resource group here.
   • Azure Communication Services Resource Name: Name of your pre-provisioned ACS resource.
   • Provision System Topic: If you do not have EventGrid system topic created under ACS resource above, select YES. If you already have EventGrid system topic, select NO.
   • System Topic Name: Provide any unique name if you have selected YES above. If you already have EventGrid system topic under ACS, provide that name.

4. Review + Create.

5. Wait until provision finishes. May take up few minutes.

6. Once it is complete, You can test it by calling the PSTN phone number provisioned in Prerequisites.

Option 2: Test the Demo on your Local Computer

Reference: Build a customer interaction workflow using Call Automation

1. Install latest Visual Studio if you do not have it.
2. Allow your localhost to accept incoming HTTP callbacks. You can use service like ngrok to have your localhost accessible to public network. This is required to accept events.
3. Get Envrionment Variable of the followings added in your Visual Studio
   • AppServiceEndpoint: your public endpoint from above ngrok.
   • AzureCommunicationServiceKey: your ACS resource connection string.
   • PlayMediaFileEndpoint: music .wav file to be played.
4. Start your service
5. On ACS portal, go events, create new webhook event with Incoming Call.
6. Webhook end point will be your public endpoint + /incomingcallevents. (i.e. https://contoso.com/incomingcallevents)
7. Verify that your incoming call eventgrid is successful on portal.
8. You can test it by calling the PSTN phone number provisioned in Prerequisites.

Resources

• Call Automation Overview
• Incoming Call Concept
• Build a customer interaction workflow using Call Automation
• Redirect inbound telephony calls with Call Automation
• Quickstart: Play action
• Quickstart: Recognize action
• Read more about Call Recording in Azure Communication Services
• Record and download calls with Event Grid