GitHub Copilot ChatGPT Claude Codex CLI Cursor opencode Skill Text

azure-communication-callautomation-java

Build call automation workflows with Azure Communication Services Call Automation Java SDK. Use when implementing IVR systems, call routing, call recording, DTMF recognition, text-to-speech, or AI-powered call flows.

Ciza · 0 points · 19 views 0 listing impressions 0 install-command copies
Download microsoft-skills-.github_plugins_azure-sdk-java_skills_azure-communication-callautomation-java-e58528d.zip · 6 KB

Install

skills CLI npx skills add https://github.com/microsoft/skills/tree/main/.github/plugins/azure-sdk-java/skills/azure-communication-callautomation-java
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install microsoft-skills@llmmart
Git git clone https://github.com/microsoft/skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole microsoft/skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Azure Communication Call Automation (Java)

Build server-side call automation workflows including IVR systems, call routing, recording, and AI-powered interactions.

Installation

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-callautomation</artifactId>
    <version>1.6.0</version>
</dependency>

Client Creation

import com.azure.communication.callautomation.CallAutomationClient;
import com.azure.communication.callautomation.CallAutomationClientBuilder;
import com.azure.core.credential.TokenCredential;
import com.azure.identity.AzureIdentityEnvVars;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.identity.ManagedIdentityCredentialBuilder;

// Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .requireEnvVars(AzureIdentityEnvVars.AZURE_TOKEN_CREDENTIALS)
    .build();
// Or use a specific credential directly in production:
// See https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes
// TokenCredential credential = new ManagedIdentityCredentialBuilder().build();

// With DefaultAzureCredential
CallAutomationClient client = new CallAutomationClientBuilder()
    .endpoint("https://<resource>.communication.azure.com")
    .credential(credential)
    .buildClient();

// With connection string
CallAutomationClient client = new CallAutomationClientBuilder()
    .connectionString("<connection-string>")
    .buildClient();

Key Concepts

Class Purpose
CallAutomationClient Make calls, answer/reject incoming calls, redirect calls
CallConnection Actions in established calls (add participants, terminate)
CallMedia Media operations (play audio, recognize DTMF/speech)
CallRecording Start/stop/pause recording
CallAutomationEventParser Parse webhook events from ACS

Create Outbound Call

import com.azure.communication.callautomation.models.*;
import com.azure.communication.common.CommunicationUserIdentifier;
import com.azure.communication.common.PhoneNumberIdentifier;

// Call to PSTN number
PhoneNumberIdentifier target = new PhoneNumberIdentifier("+14255551234");
PhoneNumberIdentifier caller = new PhoneNumberIdentifier("+14255550100");

CreateCallOptions options = new CreateCallOptions(
    new CommunicationUserIdentifier("<user-id>"),  // Source
    List.of(target))                                // Targets
    .setSourceCallerId(caller)
    .setCallbackUrl("https://your-app.com/api/callbacks");

CreateCallResult result = client.createCall(options);
String callConnectionId = result.getCallConnectionProperties().getCallConnectionId();

Answer Incoming Call

// From Event Grid webhook - IncomingCall event
String incomingCallContext = "<incoming-call-context-from-event>";

AnswerCallOptions options = new AnswerCallOptions(
    incomingCallContext,
    "https://your-app.com/api/callbacks");

AnswerCallResult result = client.answerCall(options);
CallConnection callConnection = result.getCallConnection();

Play Audio (Text-to-Speech)

CallConnection callConnection = client.getCallConnection(callConnectionId);
CallMedia callMedia = callConnection.getCallMedia();

// Play text-to-speech
TextSource textSource = new TextSource()
    .setText("Welcome to Contoso. Press 1 for sales, 2 for support.")
    .setVoiceName("en-US-JennyNeural");

PlayOptions playOptions = new PlayOptions(
    List.of(textSource),
    List.of(new CommunicationUserIdentifier("<target-user>")));

callMedia.play(playOptions);

// Play audio file
FileSource fileSource = new FileSource()
    .setUrl("https://storage.blob.core.windows.net/audio/greeting.wav");

callMedia.play(new PlayOptions(List.of(fileSource), List.of(target)));

Recognize DTMF Input

// Recognize DTMF tones
DtmfTone stopTones = DtmfTone.POUND;

CallMediaRecognizeDtmfOptions recognizeOptions = new CallMediaRecognizeDtmfOptions(
    new CommunicationUserIdentifier("<target-user>"),
    5)  // Max tones to collect
    .setInterToneTimeout(Duration.ofSeconds(5))
    .setStopTones(List.of(stopTones))
    .setInitialSilenceTimeout(Duration.ofSeconds(15))
    .setPlayPrompt(new TextSource().setText("Enter your account number followed by pound."));

callMedia.startRecognizing(recognizeOptions);

Recognize Speech

// Speech recognition with AI
CallMediaRecognizeSpeechOptions speechOptions = new CallMediaRecognizeSpeechOptions(
    new CommunicationUserIdentifier("<target-user>"))
    .setEndSilenceTimeout(Duration.ofSeconds(2))
    .setSpeechLanguage("en-US")
    .setPlayPrompt(new TextSource().setText("How can I help you today?"));

callMedia.startRecognizing(speechOptions);

Call Recording

CallRecording callRecording = client.getCallRecording();

// Start recording
StartRecordingOptions recordingOptions = new StartRecordingOptions(
    new ServerCallLocator("<server-call-id>"))
    .setRecordingChannel(RecordingChannel.MIXED)
    .setRecordingContent(RecordingContent.AUDIO_VIDEO)
    .setRecordingFormat(RecordingFormat.MP4);

RecordingStateResult recordingResult = callRecording.start(recordingOptions);
String recordingId = recordingResult.getRecordingId();

// Pause/resume/stop
callRecording.pause(recordingId);
callRecording.resume(recordingId);
callRecording.stop(recordingId);

// Download recording (after RecordingFileStatusUpdated event)
callRecording.downloadTo(recordingUrl, Paths.get("recording.mp4"));

Add Participant to Call

CallConnection callConnection = client.getCallConnection(callConnectionId);

CommunicationUserIdentifier participant = new CommunicationUserIdentifier("<user-id>");
AddParticipantOptions addOptions = new AddParticipantOptions(participant)
    .setInvitationTimeout(Duration.ofSeconds(30));

AddParticipantResult result = callConnection.addParticipant(addOptions);

Transfer Call

// Blind transfer
PhoneNumberIdentifier transferTarget = new PhoneNumberIdentifier("+14255559999");
TransferCallToParticipantResult result = callConnection.transferCallToParticipant(transferTarget);

Handle Events (Webhook)

import com.azure.communication.callautomation.CallAutomationEventParser;
import com.azure.communication.callautomation.models.events.*;

// In your webhook endpoint
public void handleCallback(String requestBody) {
    List<CallAutomationEventBase> events = CallAutomationEventParser.parseEvents(requestBody);
    
    for (CallAutomationEventBase event : events) {
        if (event instanceof CallConnected) {
            CallConnected connected = (CallConnected) event;
            System.out.println("Call connected: " + connected.getCallConnectionId());
        } else if (event instanceof RecognizeCompleted) {
            RecognizeCompleted recognized = (RecognizeCompleted) event;
            // Handle DTMF or speech recognition result
            DtmfResult dtmfResult = (DtmfResult) recognized.getRecognizeResult();
            String tones = dtmfResult.getTones().stream()
                .map(DtmfTone::toString)
                .collect(Collectors.joining());
            System.out.println("DTMF received: " + tones);
        } else if (event instanceof PlayCompleted) {
            System.out.println("Audio playback completed");
        } else if (event instanceof CallDisconnected) {
            System.out.println("Call ended");
        }
    }
}

Hang Up Call

// Hang up for all participants
callConnection.hangUp(true);

// Hang up only this leg
callConnection.hangUp(false);

Error Handling

import com.azure.core.exception.HttpResponseException;

try {
    client.answerCall(options);
} catch (HttpResponseException e) {
    if (e.getResponse().getStatusCode() == 404) {
        System.out.println("Call not found or already ended");
    } else if (e.getResponse().getStatusCode() == 400) {
        System.out.println("Invalid request: " + e.getMessage());
    }
}

Environment Variables

AZURE_COMMUNICATION_ENDPOINT=https://<resource>.communication.azure.com  # Required for all auth methods
AZURE_COMMUNICATION_CONNECTION_STRING=endpoint=https://...;accesskey=...  # Alternative to Entra ID auth
CALLBACK_BASE_URL=https://your-app.com/api/callbacks  # Required for webhook callbacks
AZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production

Trigger Phrases

  • "call automation Java", "IVR Java", "interactive voice response"
  • "call recording Java", "DTMF recognition Java"
  • "text to speech call", "speech recognition call"
  • "answer incoming call", "transfer call Java"
  • "Azure Communication Services call automation"
Files (skills)
  • references
    • examples.md 16.1 KB
      Loading…
  • SKILL.md 9.1 KB
    ---
    name: azure-communication-callautomation-java
    description: Build call automation workflows with Azure Communication Services Call Automation Java SDK. Use when implementing IVR systems, call routing, call recording, DTMF recognition, text-to-speech, or AI-powered call flows.
    license: MIT
    metadata:
      author: Microsoft
      version: "1.0.0"
      package: com.azure:azure-communication-callautomation
    ---
    
    # Azure Communication Call Automation (Java)
    
    Build server-side call automation workflows including IVR systems, call routing, recording, and AI-powered interactions.
    
    ## Installation
    
    ```xml
    <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-communication-callautomation</artifactId>
        <version>1.6.0</version>
    </dependency>
    ```
    
    ## Client Creation
    
    ```java
    import com.azure.communication.callautomation.CallAutomationClient;
    import com.azure.communication.callautomation.CallAutomationClientBuilder;
    import com.azure.core.credential.TokenCredential;
    import com.azure.identity.AzureIdentityEnvVars;
    import com.azure.identity.DefaultAzureCredentialBuilder;
    import com.azure.identity.ManagedIdentityCredentialBuilder;
    
    // Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
    TokenCredential credential = new DefaultAzureCredentialBuilder()
        .requireEnvVars(AzureIdentityEnvVars.AZURE_TOKEN_CREDENTIALS)
        .build();
    // Or use a specific credential directly in production:
    // See https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes
    // TokenCredential credential = new ManagedIdentityCredentialBuilder().build();
    
    // With DefaultAzureCredential
    CallAutomationClient client = new CallAutomationClientBuilder()
        .endpoint("https://<resource>.communication.azure.com")
        .credential(credential)
        .buildClient();
    
    // With connection string
    CallAutomationClient client = new CallAutomationClientBuilder()
        .connectionString("<connection-string>")
        .buildClient();
    ```
    
    ## Key Concepts
    
    | Class | Purpose |
    |-------|---------|
    | `CallAutomationClient` | Make calls, answer/reject incoming calls, redirect calls |
    | `CallConnection` | Actions in established calls (add participants, terminate) |
    | `CallMedia` | Media operations (play audio, recognize DTMF/speech) |
    | `CallRecording` | Start/stop/pause recording |
    | `CallAutomationEventParser` | Parse webhook events from ACS |
    
    ## Create Outbound Call
    
    ```java
    import com.azure.communication.callautomation.models.*;
    import com.azure.communication.common.CommunicationUserIdentifier;
    import com.azure.communication.common.PhoneNumberIdentifier;
    
    // Call to PSTN number
    PhoneNumberIdentifier target = new PhoneNumberIdentifier("+14255551234");
    PhoneNumberIdentifier caller = new PhoneNumberIdentifier("+14255550100");
    
    CreateCallOptions options = new CreateCallOptions(
        new CommunicationUserIdentifier("<user-id>"),  // Source
        List.of(target))                                // Targets
        .setSourceCallerId(caller)
        .setCallbackUrl("https://your-app.com/api/callbacks");
    
    CreateCallResult result = client.createCall(options);
    String callConnectionId = result.getCallConnectionProperties().getCallConnectionId();
    ```
    
    ## Answer Incoming Call
    
    ```java
    // From Event Grid webhook - IncomingCall event
    String incomingCallContext = "<incoming-call-context-from-event>";
    
    AnswerCallOptions options = new AnswerCallOptions(
        incomingCallContext,
        "https://your-app.com/api/callbacks");
    
    AnswerCallResult result = client.answerCall(options);
    CallConnection callConnection = result.getCallConnection();
    ```
    
    ## Play Audio (Text-to-Speech)
    
    ```java
    CallConnection callConnection = client.getCallConnection(callConnectionId);
    CallMedia callMedia = callConnection.getCallMedia();
    
    // Play text-to-speech
    TextSource textSource = new TextSource()
        .setText("Welcome to Contoso. Press 1 for sales, 2 for support.")
        .setVoiceName("en-US-JennyNeural");
    
    PlayOptions playOptions = new PlayOptions(
        List.of(textSource),
        List.of(new CommunicationUserIdentifier("<target-user>")));
    
    callMedia.play(playOptions);
    
    // Play audio file
    FileSource fileSource = new FileSource()
        .setUrl("https://storage.blob.core.windows.net/audio/greeting.wav");
    
    callMedia.play(new PlayOptions(List.of(fileSource), List.of(target)));
    ```
    
    ## Recognize DTMF Input
    
    ```java
    // Recognize DTMF tones
    DtmfTone stopTones = DtmfTone.POUND;
    
    CallMediaRecognizeDtmfOptions recognizeOptions = new CallMediaRecognizeDtmfOptions(
        new CommunicationUserIdentifier("<target-user>"),
        5)  // Max tones to collect
        .setInterToneTimeout(Duration.ofSeconds(5))
        .setStopTones(List.of(stopTones))
        .setInitialSilenceTimeout(Duration.ofSeconds(15))
        .setPlayPrompt(new TextSource().setText("Enter your account number followed by pound."));
    
    callMedia.startRecognizing(recognizeOptions);
    ```
    
    ## Recognize Speech
    
    ```java
    // Speech recognition with AI
    CallMediaRecognizeSpeechOptions speechOptions = new CallMediaRecognizeSpeechOptions(
        new CommunicationUserIdentifier("<target-user>"))
        .setEndSilenceTimeout(Duration.ofSeconds(2))
        .setSpeechLanguage("en-US")
        .setPlayPrompt(new TextSource().setText("How can I help you today?"));
    
    callMedia.startRecognizing(speechOptions);
    ```
    
    ## Call Recording
    
    ```java
    CallRecording callRecording = client.getCallRecording();
    
    // Start recording
    StartRecordingOptions recordingOptions = new StartRecordingOptions(
        new ServerCallLocator("<server-call-id>"))
        .setRecordingChannel(RecordingChannel.MIXED)
        .setRecordingContent(RecordingContent.AUDIO_VIDEO)
        .setRecordingFormat(RecordingFormat.MP4);
    
    RecordingStateResult recordingResult = callRecording.start(recordingOptions);
    String recordingId = recordingResult.getRecordingId();
    
    // Pause/resume/stop
    callRecording.pause(recordingId);
    callRecording.resume(recordingId);
    callRecording.stop(recordingId);
    
    // Download recording (after RecordingFileStatusUpdated event)
    callRecording.downloadTo(recordingUrl, Paths.get("recording.mp4"));
    ```
    
    ## Add Participant to Call
    
    ```java
    CallConnection callConnection = client.getCallConnection(callConnectionId);
    
    CommunicationUserIdentifier participant = new CommunicationUserIdentifier("<user-id>");
    AddParticipantOptions addOptions = new AddParticipantOptions(participant)
        .setInvitationTimeout(Duration.ofSeconds(30));
    
    AddParticipantResult result = callConnection.addParticipant(addOptions);
    ```
    
    ## Transfer Call
    
    ```java
    // Blind transfer
    PhoneNumberIdentifier transferTarget = new PhoneNumberIdentifier("+14255559999");
    TransferCallToParticipantResult result = callConnection.transferCallToParticipant(transferTarget);
    ```
    
    ## Handle Events (Webhook)
    
    ```java
    import com.azure.communication.callautomation.CallAutomationEventParser;
    import com.azure.communication.callautomation.models.events.*;
    
    // In your webhook endpoint
    public void handleCallback(String requestBody) {
        List<CallAutomationEventBase> events = CallAutomationEventParser.parseEvents(requestBody);
        
        for (CallAutomationEventBase event : events) {
            if (event instanceof CallConnected) {
                CallConnected connected = (CallConnected) event;
                System.out.println("Call connected: " + connected.getCallConnectionId());
            } else if (event instanceof RecognizeCompleted) {
                RecognizeCompleted recognized = (RecognizeCompleted) event;
                // Handle DTMF or speech recognition result
                DtmfResult dtmfResult = (DtmfResult) recognized.getRecognizeResult();
                String tones = dtmfResult.getTones().stream()
                    .map(DtmfTone::toString)
                    .collect(Collectors.joining());
                System.out.println("DTMF received: " + tones);
            } else if (event instanceof PlayCompleted) {
                System.out.println("Audio playback completed");
            } else if (event instanceof CallDisconnected) {
                System.out.println("Call ended");
            }
        }
    }
    ```
    
    ## Hang Up Call
    
    ```java
    // Hang up for all participants
    callConnection.hangUp(true);
    
    // Hang up only this leg
    callConnection.hangUp(false);
    ```
    
    ## Error Handling
    
    ```java
    import com.azure.core.exception.HttpResponseException;
    
    try {
        client.answerCall(options);
    } catch (HttpResponseException e) {
        if (e.getResponse().getStatusCode() == 404) {
            System.out.println("Call not found or already ended");
        } else if (e.getResponse().getStatusCode() == 400) {
            System.out.println("Invalid request: " + e.getMessage());
        }
    }
    ```
    
    ## Environment Variables
    
    ```bash
    AZURE_COMMUNICATION_ENDPOINT=https://<resource>.communication.azure.com  # Required for all auth methods
    AZURE_COMMUNICATION_CONNECTION_STRING=endpoint=https://...;accesskey=...  # Alternative to Entra ID auth
    CALLBACK_BASE_URL=https://your-app.com/api/callbacks  # Required for webhook callbacks
    AZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production
    ```
    
    ## Trigger Phrases
    
    - "call automation Java", "IVR Java", "interactive voice response"
    - "call recording Java", "DTMF recognition Java"
    - "text to speech call", "speech recognition call"
    - "answer incoming call", "transfer call Java"
    - "Azure Communication Services call automation"
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.