Skills Development Azure Calling Server Java Migration Guide

Azure Calling Server Java Migration Guide

v20260424
azure-communication-callingserver-java
⚠️ This SDK is deprecated and used for maintaining legacy code only. It provides functionality for Azure Communication Services calling servers in Java. For all new development, developers must migrate to the updated 'Call Automation' SDK (`azure-communication-callautomation`). This guide details the necessary class and usage changes for a smooth transition.
Get Skill
406 downloads
Overview

Azure Communication CallingServer (Java) - DEPRECATED

⚠️ DEPRECATED: This SDK has been renamed to Call Automation. For new projects, use azure-communication-callautomation instead. This skill is for maintaining legacy code only.

Migration to Call Automation

<!-- OLD (deprecated) -->
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-callingserver</artifactId>
    <version>1.0.0-beta.5</version>
</dependency>

<!-- NEW (use this instead) -->
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-callautomation</artifactId>
    <version>1.6.0</version>
</dependency>

Class Name Changes

CallingServer (Old)Call Automation (New)
CallingServerClientCallAutomationClient
CallingServerClientBuilderCallAutomationClientBuilder
CallConnectionCallConnection (same)
ServerCallRemoved - use CallConnection

Legacy Client Creation

// OLD WAY (deprecated)
import com.azure.communication.callingserver.CallingServerClient;
import com.azure.communication.callingserver.CallingServerClientBuilder;

CallingServerClient client = new CallingServerClientBuilder()
    .connectionString("<connection-string>")
    .buildClient();

// NEW WAY
import com.azure.communication.callautomation.CallAutomationClient;
import com.azure.communication.callautomation.CallAutomationClientBuilder;

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

Legacy Recording

// OLD WAY
StartRecordingOptions options = new StartRecordingOptions(serverCallId)
    .setRecordingStateCallbackUri(callbackUri);

StartCallRecordingResult result = client.startRecording(options);
String recordingId = result.getRecordingId();

client.pauseRecording(recordingId);
client.resumeRecording(recordingId);
client.stopRecording(recordingId);

// NEW WAY - see azure-communication-callautomation skill

For New Development

Do not use this SDK for new projects.

See the azure-communication-callautomation-java skill for:

  • Making outbound calls
  • Answering incoming calls
  • Call recording
  • DTMF recognition
  • Text-to-speech / speech-to-text
  • Adding/removing participants
  • Call transfer

Trigger Phrases

  • "callingserver legacy", "deprecated calling SDK"
  • "migrate callingserver to callautomation"

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Info
Category Development
Name azure-communication-callingserver-java
Version v20260424
Size 3.12KB
Updated At 2026-04-25
Language