page_type	languages	products
sample	Java	azure azure-communication-services

Call Automation - Quick Start Sample

This sample application shows how the Azure Communication Services - Call Automation SDK can be used to build IVR related solutions. It makes an outbound call to a phone number, performs DTMF recognition, plays a different audio message based on the key pressed by the callee and hangs-up the call. This sample application configured for accepting tone 1 (tone1), 2 (tone2) , If the callee pressed any other key than expected, the call will be disconnected. This sample application is also capable of making multiple concurrent outbound calls. The application is a web-based application built on Java's Spring framework.

Design

Prerequisites

• An Azure account with an active subscription. Create an account for free.
• A deployed Communication Services resource. Create a Communication Services resource.
• A phone number in your Azure Communication Services resource that can make outbound calls. NB: phone numbers are not available in free subscriptions.
• Java Development Kit (JDK) Microsoft.OpenJDK.17
• Apache Maven
• Create and host a Azure Dev Tunnel. Instructions here

Before running the sample for the first time

• Open the application.yml file in the resources folder to configure the following settings

  • connectionstring: Azure Communication Service resource's connection string.

  • callerphonenumber: Phone number associated with the Azure Communication Service resource.

  • targetphonenumber: Target Phone number.

    Format: "OutboundTarget(Phone Number)".

    For e.g. "+1425XXXAAAA"
    

  • basecallbackuri: Base url of the app. For local development use dev tunnel url.

Setup and host your Azure DevTunnel

Azure DevTunnels is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We will then use this endpoint to notify your application of calling events from the ACS Call Automation service.

devtunnel create --allow-anonymous
devtunnel port create -p 8080
devtunnel host

Run the application

• Navigate to the directory containing the pom.xml file and use the following mvn commands:
  • Compile the application: mvn compile
  • Build the package: mvn package
  • Execute the app: mvn exec:java
• Access the Swagger UI at http://localhost:8080/swagger-ui.html
  • Try the GET /outboundCall to run the Sample Application