Call Automation GA changes (#45982)

* ga5 changes

* ga5 api changes

* Made GA5 changes and recorded the live tests. (#45409)

* Addressing arb comments

* Added the parser for the dtmf data. (#45347)

* Added the parser for the dtmf data.

* Removed dtmf meta data.

---------

Co-authored-by: Vinothini Dharmaraj <v-dharmarajv@microsoft.com>

* updating the white space difference

* addressing the arb comments

* GA5 Javadoc Issues (#45432)

* Fixed Javadoc issues in StreamingData.java & TranscriptionOptions.java

* Renamed MediaStreamingContent class to MediaStreamingContentType. Renamed getChannels() to getChannelType() in AudioMetaData.java

* Re-recorded tests and fixed linting issues (unused imports). (#45448)

* updating java missing fields

* lint errors

* moving transport url

* Addressing the ARB Comments

* addressing the arb comments

* addressing all arb comments

* updating the transcription and media streaming options

* Fixed Javadoc issues + updated ga5 version. (#45496)

* Fixing the lint errors

* fixing the lint error

* updating the changelog

* Updating the changelog and release date

* Created feature branch off of callautomation/release/ga5. Updated to ga6 apispec. Added custom x header support, MicrosoftTeamsAppIdentifier compatability, recording with call connection id, and StartRecordingFailed event.

* Ran recorded tests. Fixed timeout issue with waiting for incomingCallContext.

* adding teams extension user id

* ga6 version

* changelog update

* moving the sipheaderprefix to extendable enum

* setting callconnection id to recording request

* updating the ga version

* Increment package versions for core releases (#45876)

* Increment package versions for patch releases (#45841)

* Increment package versions for patch releases

* Increment package versions for patch releases

* Update sdk/remoterendering/azure-mixedreality-remoterendering/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update sdk/remoterendering/azure-mixedreality-remoterendering/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update sdk/remoterendering/azure-mixedreality-remoterendering/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Run python script to fix versions and remove duplicate tag

* Fixing azure-communication-jobrouter version in version_client.tct

---------

Co-authored-by: azure-sdk <azuresdk@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Alan Zimmer <48699787+alzimmermsft@users.noreply.github.com>

* latest from main autorest version

* apispec endpoint from the main

* Fixing the build issues

* adding recorded test

* pushing latest record file

* removing the public contructor as per the comments

* removing tests which are added mistaken

* updating the release date for the ga6

* changelog update

* removing the release date

* reverting version beta until finalize the release date

---------

Co-authored-by: v-pivamshi <155710746+v-pivamshi@users.noreply.github.com>
Co-authored-by: v-saasomani <v-saasomani@microsoft.com>
Co-authored-by: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Co-authored-by: Jair Myree <jairmyree@microsoft.com>
Co-authored-by: azure-sdk <azuresdk@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Alan Zimmer <48699787+alzimmermsft@users.noreply.github.com>

Author: 7 people

sdk/communication/azure-communication-callautomation/CHANGELOG.md

@@ -4,11 +4,11 @@
 
 ### Features Added
 
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
+- Added support for Teams multipersona users in create call, add participant, transfer, and redirect scenarios in OPS calls
+- Added TeamsAppSource for use when creating outbound OPS calls
+- Recording with the call connection ID is now supported. OPS calls can be recorded using the call connection ID.
+- Added StartRecordingFailed event to indicate when the start recording API is unable to initiate the recording.
+- Adds support for SIP headers prefixed with 'X-' and 'X-MS-Custom-' within the CustomCallingContext.
 
 ## 1.4.1 (2025-06-19)
 

sdk/communication/azure-communication-callautomation/README.md

@@ -22,7 +22,7 @@ This package contains a Java SDK for Azure Communication Call Automation Service
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-communication-callautomation</artifactId>
-    <version>1.4.1</version>
+    <version>1.5.0</version>
 </dependency>
 ```
 
@@ -41,61 +41,6 @@ This is the restart of Call Automation Service. It is renamed to Call Automation
 
 `CallAutomationEventParser` provides the functionality to handle events from the ACS resource.
 
-## Examples
-
-### Handle Mid-Connection events with CallAutomation's EventProcessor
-
-To easily handle mid-connection events, Call Automation's SDK provides easier way to handle these events.
-Take a look at `CallAutomationEventProcessor`. This will ensure correlation between call and events more easily.
-
-```Java
-@RestController
-public class ActionController {
-    // Controller implementation...
-
-    @RequestMapping(value = "/api/events", method = POST)
-    public ResponseEntity<?> handleCallEvents(@RequestBody String requestBody) {
-        try {
-            CallAutomationAsyncClient client = getCallAutomationAsyncClient();
-            client.getEventProcessor().processEvents(requestBody);
-
-            return new ResponseEntity<>(HttpStatus.OK);
-        } catch (Exception e) {
-            return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
-        }
-    }
-}
-```
-
-`processEvents` is required for EventProcessor to work.
-After event is being consumed by EventProcessor, you can start using its feature.
-
-See below for example: where you are making a call with `CreateCall`, and wait for `CallConnected` event of the call.
-
-```Java
-public class commandClass {
-    // Class implementation...
-
-    public void createCallCommand() {
-        CallAutomationAsyncClient client = getCallAutomationAsyncClient(); // Should be the same instance as the one used in the example above.
-        String callbackUrl = "<YOUR_CALL_BACK_URL>";
-        CallInvite callInvite = new CallInvite(new CommunicationUserIdentifier("<TARGET_USER_ID>"));
-        CreateCallResult result = client.createCall(callInvite, callbackUrl).block();
-
-        try {
-            // This will wait until CallConnected event is arrived or Timesout!
-            CreateCallEventResult eventResult = result.waitForEventProcessorAsync(Duration.ofSeconds(30)).block();
-            CallConnected returnedEvent = eventResult.successResult();
-        } catch (Exception e) {
-            // Timeout exception happend!
-            // Call likely was never answered.
-        }
-    }
-}
-```
-
-If timeout was not set when calling "waitForEventProcessorAsync", the default timeout is 4 minutes.
-
 ## Troubleshooting
 
 If you receive a CommunicationErrorException with the message: "Action is invalid when call is not in Established state." This usually means the call has ended. This can occur if the participants all leave

sdk/communication/azure-communication-callautomation/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/communication/azure-communication-callautomation",
-  "Tag": "java/communication/azure-communication-callautomation_33108318f9"
+  "Tag": "java/communication/azure-communication-callautomation_89c8cc481e"
 }

sdk/communication/azure-communication-callautomation/pom.xml

@@ -96,7 +96,8 @@
     <dependency>
       <groupId>org.hamcrest</groupId>
       <artifactId>hamcrest-all</artifactId>
-      <version>1.3</version> <!-- {x-version-update;org.hamcrest:hamcrest-all;external_dependency} -->
+      <version>1.3</version>
+      <!-- {x-version-update;org.hamcrest:hamcrest-all;external_dependency} -->
       <scope>test</scope>
     </dependency>
     <dependency>

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/CallAutomationAsyncClient.java

@@ -11,6 +11,7 @@
 import com.azure.communication.callautomation.implementation.converters.CommunicationIdentifierConverter;
 import com.azure.communication.callautomation.implementation.converters.CommunicationUserIdentifierConverter;
 import com.azure.communication.callautomation.implementation.converters.PhoneNumberIdentifierConverter;
+import com.azure.communication.callautomation.implementation.converters.MicrosoftTeamsAppIdentifierConverter;
 import com.azure.communication.callautomation.implementation.models.AnswerCallRequestInternal;
 import com.azure.communication.callautomation.implementation.models.AudioFormatInternal;
 import com.azure.communication.callautomation.implementation.models.CallIntelligenceOptionsInternal;
@@ -239,6 +240,11 @@ private CreateCallRequestInternal getCreateCallRequestInternal(CreateCallOptions
             request.setTranscriptionOptions(transcriptionOptionsInternal);
         }
 
+        if (createCallOptions.getTeamsAppSource() != null) {
+            request
+                .setTeamsAppSource(MicrosoftTeamsAppIdentifierConverter.convert(createCallOptions.getTeamsAppSource()));
+        }
+
         return request;
     }
 
@@ -278,6 +284,11 @@ private CreateCallRequestInternal getCreateCallRequestInternal(CreateGroupCallOp
             request.setTranscriptionOptions(transcriptionOptionsInternal);
         }
 
+        if (createCallGroupOptions.getTeamsAppSource() != null) {
+            request.setTeamsAppSource(
+                MicrosoftTeamsAppIdentifierConverter.convert(createCallGroupOptions.getTeamsAppSource()));
+        }
+
         return request;
     }
 

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/CallAutomationServiceVersion.java

@@ -33,7 +33,11 @@ public enum CallAutomationServiceVersion implements ServiceVersion {
     /**
     * Service version {@code 2025-05-15}.
     */
-    V2025_05_15("2025-05-15");
+    V2025_05_15("2025-05-15"),
+    /**
+    * Service version {@code 2025-06-15}.
+    */
+    V2025_06_15("2025-06-15");
 
     private final String version;
 
@@ -55,6 +59,6 @@ public String getVersion() {
      * @return The latest {@link CallAutomationServiceVersion} object.
      */
     public static CallAutomationServiceVersion getLatest() {
-        return V2025_05_15;
+        return V2025_06_15;
     }
 }

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/CallConnectionAsync.java

@@ -38,6 +38,7 @@
 import com.azure.communication.common.MicrosoftTeamsAppIdentifier;
 import com.azure.communication.common.MicrosoftTeamsUserIdentifier;
 import com.azure.communication.common.PhoneNumberIdentifier;
+import com.azure.communication.common.TeamsExtensionUserIdentifier;
 import com.azure.core.annotation.ReturnType;
 import com.azure.core.annotation.ServiceMethod;
 import com.azure.core.exception.HttpResponseException;
@@ -259,6 +260,10 @@ public Mono<TransferCallResult> transferCallToParticipant(CommunicationIdentifie
             return transferCallToParticipantWithResponse(
                 new TransferCallToParticipantOptions((MicrosoftTeamsAppIdentifier) targetParticipant))
                     .flatMap(FluxUtil::toMono);
+        } else if (targetParticipant instanceof TeamsExtensionUserIdentifier) {
+            return transferCallToParticipantWithResponse(
+                new TransferCallToParticipantOptions((TeamsExtensionUserIdentifier) targetParticipant))
+                    .flatMap(FluxUtil::toMono);
         } else {
             throw logger.logExceptionAsError(new IllegalArgumentException("targetParticipant type is invalid."));
         }

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/CallRecordingAsync.java

@@ -186,6 +186,9 @@ private StartCallRecordingRequestInternal getStartCallRecordingRequest(StartReco
         if (options.isPauseOnStart() != null) {
             request.setPauseOnStart(options.isPauseOnStart());
         }
+        if (options.getCallConnectionId() != null) {
+            request.setCallConnectionId(options.getCallConnectionId());
+        }
         return request;
     }
 

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/AzureCommunicationCallAutomationServiceImplBuilder.java

@@ -275,7 +275,7 @@ public AzureCommunicationCallAutomationServiceImplBuilder retryPolicy(RetryPolic
     public AzureCommunicationCallAutomationServiceImpl buildClient() {
         this.validateClient();
         HttpPipeline localPipeline = (pipeline != null) ? pipeline : createHttpPipeline();
-        String localApiVersion = (apiVersion != null) ? apiVersion : "2025-05-15";
+        String localApiVersion = (apiVersion != null) ? apiVersion : "2025-06-15";
         SerializerAdapter localSerializerAdapter
             = (serializerAdapter != null) ? serializerAdapter : JacksonAdapter.createDefaultSerializerAdapter();
         AzureCommunicationCallAutomationServiceImpl client = new AzureCommunicationCallAutomationServiceImpl(

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/CallRecordingsImpl.java

@@ -63,7 +63,7 @@ public final class CallRecordingsImpl {
     @ServiceInterface(name = "AzureCommunicationCallAutomationServiceCallRecordings")
     public interface CallRecordingsService {
         @Post("/calling/recordings")
-        @ExpectedResponses({ 200 })
+        @ExpectedResponses({ 200, 202 })
         @UnexpectedResponseExceptionType(CommunicationErrorResponseException.class)
         Mono<Response<RecordingStateResponseInternal>> startRecording(@HostParam("endpoint") String endpoint,
             @QueryParam("api-version") String apiVersion,