Azure · annatisch · Jul 30, 2025 · May 6, 2025 · May 16, 2025 · May 21, 2025
@@ -4,11 +4,9 @@
 
 ### 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.
 
 ## 1.4.0 (2025-06-06)
 

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/communication/azure-communication-callautomation",
-  "Tag": "python/communication/azure-communication-callautomation_7fb5483cb0"
+  "Tag": "python/communication/azure-communication-callautomation_6d7be2f83f"
 }
@@ -37,6 +37,8 @@
     CommunicationIdentifierKind,
     CommunicationCloudEnvironment,
     UnknownIdentifier,
+    TeamsExtensionUserProperties,
+    TeamsExtensionUserIdentifier,
 )
 from ._generated.models._enums import (
     CallRejectReason,
@@ -91,6 +93,8 @@
     "CommunicationIdentifierKind",
     "CommunicationCloudEnvironment",
     "UnknownIdentifier",
+    "TeamsExtensionUserProperties",
+    "TeamsExtensionUserIdentifier",
 
     # enums
     "CallRejectReason",

@@ -13,5 +13,6 @@ class ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
     V2024_04_15 = "2024-04-15"
     V2024_09_15 = "2024-09-15"
     V2025_05_15 = "2025-05-15"
+    V2025_06_15 = "2025-06-15"
 
-DEFAULT_VERSION = ApiVersion.V2025_05_15.value
+DEFAULT_VERSION = ApiVersion.V2025_06_15.value
@@ -38,6 +38,7 @@
     serialize_phone_identifier,
     serialize_identifier,
     serialize_communication_user_identifier,
+    serialize_msft_teams_app_identifier,
     build_call_locator,
     process_repeatability_first_sent,
 )
@@ -58,6 +59,7 @@
         CommunicationIdentifier,
         CommunicationUserIdentifier,
         PhoneNumberIdentifier,
+        MicrosoftTeamsAppIdentifier
     )
     from ._generated.models._enums import (
         CallRejectReason,
@@ -303,6 +305,7 @@ def create_call(
         cognitive_services_endpoint: Optional[str] = None,
         media_streaming: Optional['MediaStreamingOptions'] = None,
         transcription: Optional['TranscriptionOptions'] = None,
+        teams_app_source: Optional["MicrosoftTeamsAppIdentifier"] = None,
         **kwargs
     ) -> CallConnectionProperties:
         """Create a call connection request to a target identity.
@@ -329,6 +332,8 @@ def create_call(
         :keyword transcription: Configuration of live transcription.
         :paramtype transcription: ~azure.communication.callautomation.TranscriptionOptions
          or None
+        :keyword teams_app_source: The Microsoft Teams App Identifier.
+        :paramtype teams_app_source: ~azure.communication.callautomation.MicrosoftTeamsAppIdentifier
         :return: CallConnectionProperties
         :rtype: ~azure.communication.callautomation.CallConnectionProperties
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -362,7 +367,8 @@ def create_call(
             operation_context=operation_context,
             call_intelligence_options=call_intelligence_options,
             media_streaming_options=media_config,
-            transcription_options=transcription_config
+            transcription_options=transcription_config,
+            teams_app_source=serialize_msft_teams_app_identifier(teams_app_source),
         )
         process_repeatability_first_sent(kwargs)
         result = self._client.create_call(create_call_request=create_call_request, **kwargs)
@@ -378,6 +384,7 @@ def create_group_call(
         source_display_name: Optional[str] = None,
         operation_context: Optional[str] = None,
         cognitive_services_endpoint: Optional[str] = None,
+        teams_app_source: Optional["MicrosoftTeamsAppIdentifier"] = None,
         **kwargs,
     ) -> CallConnectionProperties:
         """Create a call connection request to a list of multiple target identities.
@@ -398,6 +405,8 @@ def create_group_call(
         :keyword cognitive_services_endpoint:
          The identifier of the Cognitive Service resource assigned to this call.
         :paramtype cognitive_services_endpoint: str
+        :keyword teams_app_source: The Microsoft Teams App Identifier.
+        :paramtype teams_app_source: ~azure.communication.callautomation.MicrosoftTeamsAppIdentifier
         :return: CallConnectionProperties
         :rtype: ~azure.communication.callautomation.CallConnectionProperties
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -413,6 +422,7 @@ def create_group_call(
             source_display_name=source_display_name,
             operation_context=operation_context,
             cognitive_services_endpoint=cognitive_services_endpoint,
+            teams_app_source=teams_app_source,
             **kwargs,
         )
 
@@ -680,6 +690,57 @@ def start_recording(
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
+    @overload
+    def start_recording(
+        self,
+        *,
+        call_connection_id: str,
+        recording_state_callback_url: Optional[str] = None,
+        recording_content_type: Optional[Union[str, 'RecordingContent']] = None,
+        recording_channel_type: Optional[Union[str, 'RecordingChannel']] = None,
+        recording_format_type: Optional[Union[str, 'RecordingFormat']] = None,
+        audio_channel_participant_ordering: Optional[List['CommunicationIdentifier']] = None,
+        channel_affinity: Optional[List['ChannelAffinity']] = None,
+        recording_storage: Optional[Union['AzureCommunicationsRecordingStorage',
+                                          'AzureBlobContainerRecordingStorage']] = None,
+        pause_on_start: Optional[bool] = None,
+        **kwargs,
+    ) -> RecordingProperties:
+        """Start recording for a ongoing call. Locate the call with call connection id.
+
+        :keyword str call_connection_id: The call connection ID to locate ongoing call.
+        :keyword recording_state_callback_url: The url to send notifications to.
+        :paramtype recording_state_callback_url: str or None
+        :keyword recording_content_type: The content type of call recording.
+        :paramtype recording_content_type: str or ~azure.communication.callautomation.RecordingContent or None
+        :keyword recording_channel_type: The channel type of call recording.
+        :paramtype recording_channel_type: str or ~azure.communication.callautomation.RecordingChannel or None
+        :keyword recording_format_type: The format type of call recording.
+        :paramtype recording_format_type: str or ~azure.communication.callautomation.RecordingFormat or None
+        :keyword audio_channel_participant_ordering:
+         The sequential order in which audio channels are assigned to participants in the unmixed recording.
+         When 'recordingChannelType' is set to 'unmixed' and `audioChannelParticipantOrdering is not specified,
+         the audio channel to participant mapping will be automatically assigned based on the order in
+         which participant first audio was detected.
+         Channel to participant mapping details can be found in the metadata of the recording.
+        :paramtype audio_channel_participant_ordering:
+         list[~azure.communication.callautomation.CommunicationIdentifier] or None
+        :keyword channel_affinity: The channel affinity of call recording
+         When 'recordingChannelType' is set to 'unmixed', if channelAffinity is not specified,
+         'channel' will be automatically assigned.
+         Channel-Participant mapping details can be found in the metadata of the recording.
+        :paramtype channel_affinity: list[~azure.communication.callautomation.ChannelAffinity] or None
+        :keyword recording_storage: Defines the kind of external storage. Known values are:
+         ``AzureCommunicationsRecordingStorage`` and ``AzureBlobContainerRecordingStorage``.
+         If no storage option is provided, the default is Azure Communications recording storage.
+        :paramtype recording_storage: AzureCommunicationsRecordingStorage or AzureBlobContainerRecordingStorage or None
+        :keyword pause_on_start: The state of the pause on start option.
+        :paramtype pause_on_start: bool or None
+        :return: RecordingProperties
+        :rtype: ~azure.communication.callautomation.RecordingProperties
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+
     @distributed_trace
     def start_recording(
         self,
@@ -696,9 +757,14 @@ def start_recording(
             kwargs.pop("room_id", None),
             args
         )
+        call_connection_id = kwargs.pop("call_connection_id", None)
+        if not call_locator and not call_connection_id:
+            raise ValueError("Either a call locator or a call_connection_id must be provided to start recording.")
+
         external_storage = build_external_storage(kwargs.pop("recording_storage", None))
         start_recording_request = StartCallRecordingRequest(
             call_locator=call_locator if call_locator else None,
+            call_connection_id=call_connection_id if call_connection_id else None,
             recording_state_callback_uri=kwargs.pop("recording_state_callback_url", None),
             recording_content_type=kwargs.pop("recording_content_type", None),
             recording_channel_type=kwargs.pop("recording_channel_type", None),

@@ -18,8 +18,12 @@
 from . import models as _models
 from ._configuration import AzureCommunicationCallAutomationServiceConfiguration
 from ._utils.serialization import Deserializer, Serializer
-from .operations import CallConnectionOperations, CallMediaOperations, CallRecordingOperations
-from .operations._operations import _AzureCommunicationCallAutomationServiceOperationsMixin
+from .operations import (
+    CallConnectionOperations,
+    CallMediaOperations,
+    CallRecordingOperations,
+    _AzureCommunicationCallAutomationServiceOperationsMixin,
+)
 
 
 class AzureCommunicationCallAutomationService(_AzureCommunicationCallAutomationServiceOperationsMixin):
@@ -36,7 +40,7 @@ class AzureCommunicationCallAutomationService(_AzureCommunicationCallAutomationS
     :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.AzureKeyCredential
-    :keyword api_version: Api Version. Default value is "2025-05-15". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-15". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """

@@ -25,13 +25,13 @@ class AzureCommunicationCallAutomationServiceConfiguration:  # pylint: disable=t
     :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.AzureKeyCredential
-    :keyword api_version: Api Version. Default value is "2025-05-15". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-15". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, credential: AzureKeyCredential, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2025-05-15")
+        api_version: str = kwargs.pop("api_version", "2025-06-15")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

@@ -18,8 +18,12 @@
 from .. import models as _models
 from .._utils.serialization import Deserializer, Serializer
 from ._configuration import AzureCommunicationCallAutomationServiceConfiguration
-from .operations import CallConnectionOperations, CallMediaOperations, CallRecordingOperations
-from .operations._operations import _AzureCommunicationCallAutomationServiceOperationsMixin
+from .operations import (
+    CallConnectionOperations,
+    CallMediaOperations,
+    CallRecordingOperations,
+    _AzureCommunicationCallAutomationServiceOperationsMixin,
+)
 
 
 class AzureCommunicationCallAutomationService(_AzureCommunicationCallAutomationServiceOperationsMixin):
@@ -37,7 +41,7 @@ class AzureCommunicationCallAutomationService(_AzureCommunicationCallAutomationS
     :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.AzureKeyCredential
-    :keyword api_version: Api Version. Default value is "2025-05-15". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-15". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """

@@ -25,13 +25,13 @@ class AzureCommunicationCallAutomationServiceConfiguration:  # pylint: disable=t
     :type endpoint: str
     :param credential: Credential needed for the client to connect to Azure. Required.
     :type credential: ~azure.core.credentials.AzureKeyCredential
-    :keyword api_version: Api Version. Default value is "2025-05-15". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-15". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, credential: AzureKeyCredential, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2025-05-15")
+        api_version: str = kwargs.pop("api_version", "2025-06-15")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

@@ -1,3 +1,4 @@
+# pylint: disable=line-too-long,useless-suppression
 # coding=utf-8
 # --------------------------------------------------------------------------
 # Copyright (c) Microsoft Corporation. All rights reserved.
@@ -12,6 +13,7 @@
 if TYPE_CHECKING:
     from ._patch import *  # pylint: disable=unused-wildcard-import
 
+from ._operations import _AzureCommunicationCallAutomationServiceOperationsMixin  # type: ignore # pylint: disable=unused-import
 from ._operations import CallConnectionOperations  # type: ignore
 from ._operations import CallMediaOperations  # type: ignore
 from ._operations import CallRecordingOperations  # type: ignore

@@ -3212,7 +3212,7 @@ async def start_recording(
 
         response = pipeline_response.http_response
 
-        if response.status_code not in [200]:
+        if response.status_code not in [200, 202]:
             map_error(status_code=response.status_code, response=response, error_map=error_map)
             error = self._deserialize.failsafe_deserialize(_models.CommunicationErrorResponse, pipeline_response)
             raise HttpResponseError(response=response, model=error)

@@ -96,9 +96,11 @@
     SsmlSource,
     StartCallRecordingRequest,
     StartMediaStreamingRequest,
+    StartRecordingFailed,
     StartTranscriptionRequest,
     StopMediaStreamingRequest,
     StopTranscriptionRequest,
+    TeamsExtensionUserIdentifierModel,
     TextSource,
     TranscriptionFailed,
     TranscriptionOptions,
@@ -231,9 +233,11 @@
     "SsmlSource",
     "StartCallRecordingRequest",
     "StartMediaStreamingRequest",
+    "StartRecordingFailed",
     "StartTranscriptionRequest",
     "StopMediaStreamingRequest",
     "StopTranscriptionRequest",
+    "TeamsExtensionUserIdentifierModel",
     "TextSource",
     "TranscriptionFailed",
     "TranscriptionOptions",

@@ -63,6 +63,7 @@ class CommunicationIdentifierModelKind(str, Enum, metaclass=CaseInsensitiveEnumM
     PHONE_NUMBER = "phoneNumber"
     MICROSOFT_TEAMS_USER = "microsoftTeamsUser"
     MICROSOFT_TEAMS_APP = "microsoftTeamsApp"
+    TEAMS_EXTENSION_USER = "teamsExtensionUser"
 
 
 class DtmfTone(str, Enum, metaclass=CaseInsensitiveEnumMeta):