GA6 Changes for callautomation (#41918)

* updating ga5 version

* Addressing comments

* fixing the media streaming error

* updating the change

* Recorded live tests + GA5 changes (#41253)

* updating the locale  and adding the operation callback uril in the unholdoptions

* updating hold operationcallback url

* updating version number

* adding the dtmf

* fixing the spelling error on the comment

* Live/Recorded Tests (#41328)

* Rerecorded live tests.

* Pushed assets.json.

* fixing the pipeline error

* fixing lint error

* fixing the recording issue

* fixing doc error

* Created feature branch off of callautomation/release/ga5. Updated to ga6 apispec and made necessary changes.

* Made changes to start recording to effectively handle call_connection_id to locate call rather than using call locator.

* Recorded live tests  for ga6.

* updating changelog

* [OPS Common SDK] Update Communication Common SDK for Teams Phone Extensibility GA  (#41219)

* Update models.py

* Update models.py

* Update models.py

* Update phone number identifier

* add tests

* small updates

* Update test_identifier_raw_id.py

* Update test_identifier_raw_id.py

* Update test_identifier_raw_id.py

* Create entra_user_credential_async.py

* add entra token cred

* add async exchange

* Update models.py

* Update test_identifier_raw_id.py

* Update test_identifier_raw_id.py

* update credential

* Update entra_user_credential_async.py

* Update entra_user_credential_async.py

* Update entra_user_credential_async.py

* Update entra_user_credential_async.py

* Create pipeline_utils.py

* Create entra_token_guard_policy.py

* Create entra_token_credential_options.py

* Create token_exchange.py

* Update token_exchange.py

* updates

* Update token_exchange.py

* Update token_exchange.py

* cleanup old files

* Update token_exchange.py

* Update entra_token_guard_policy.py

* updated credential classes

* updates

* Delete manual_test.py

* Update user_credential.py

* Copy to all _shared in all sdks

* Update sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_shared/entra_token_guard_policy.py

Co-authored-by: Dominik <[email protected]>

* Update token_exchange.py

* update version

* Fix imports

* Fix imports in all folders

* Fix test

* Update test_identifier_raw_id.py

* Update dev_requirements.txt

* try to fix conflict in pipeline

* try to fix conflict in pipeline 2

* Update setup.py

* try to fix call automation

* remove references

* expose the identifiers

* Update documentation for credential to include the optional params

* Delete manual_test.py

* Update _version.py

* fix comment to default the cloud

* fix comments for phone number properties

* fix path

* Update CHANGELOG.md

* fix cloud param

* fix comment

* Create test_entra_token_guard_policy.py

* fix for cloud param

* Add tests for token exchange

* add tests for credential

* update test

* Update test_user_credential_async.py

* add check in async cred

* fix cloud

* update not required

* Update test_identifier_raw_id.py

* fix passing scopes

* copy paste from identity

* fix space

* fix sending scopes

* Update test_token_exchange.py

* fix spaces for doc

* fix pylint errors

* fix pylint error in model

* fix props in phone number

* fix dateutil import

* update init of asserted_id

* replace none with ""

* update models phone number

* fix some pylint errors: format

* split files

* pylint fixes

* pylint call automation

* pylint for all

* fix some pylint warnings

* fix last warnings in identity

* update all

* update token exchange

* update credential for all sdks

* fix comments

* add some tests

* fix tests

* fix some comments

* fix comments

* copy in all sdks

* fix include

* fix import

* fix tests

* fix comments

* fix analysis warnings

* fix mypy

* fix pylint

* fix mypy

* fix optional scopes

---------

Co-authored-by: Dominik <[email protected]>

* updating api version

* ga6 vesrion update

* updating the python version

* updating the live test

* pushing resolve issue

* changelog update

* Update serialization.py

* updating ordering

* changing to dev version number as the pipeline is not letting to create the PR succeeded

* version number update

* Adding the classifier for the ga release

* making the teams extension users constructers to have the keyword only param

* copy issue fixing

* spell check fix

* updating communication shared code to use the isodate instead of the … (#42085)

* udpating communication shared code to use the isodate instead of the date util

* fixing the tests

* fix the test failure

* Updated communications dependencies

* Local transport import statements

* Use fixed offsets instead of ZoneInfo to fix tests in all environments

* addressing the comments

* changing to zoneinfo as per the comments

* Revert "changing to zoneinfo as per the comments"

This reverts commit 3e2610d.

---------

Co-authored-by: antisch <[email protected]>
Co-authored-by: Cezara Mateiasi <[email protected]>

* release date update

* update changelog

* Add asynchronous tests to align with existing synchronous tests in Call Automation SDK (#41990)

* Creating async live tests for call automation

* Removing the unavailable tests for GA6

* Updating the async tests for call automation

* updating the changes

* Pushing the recorded tests and assests.json

* updating the async tests

* Adding the async tests for callautomation

* updating asset file

---------

Co-authored-by: Vinothini Dharmaraj <[email protected]>

* fixing the long path issue fixed for the build failure

* removing older files

* removing the release

* reverting the version beta to check in changes to main as the release date is not confirmed

* reverting classifier

---------

Co-authored-by: v-saasomani <[email protected]>
Co-authored-by: Cezara Zamfir <[email protected]>
Co-authored-by: Dominik <[email protected]>
Co-authored-by: antisch <[email protected]>
Co-authored-by: Cezara Mateiasi <[email protected]>
Co-authored-by: Srinivasa Kaluri <[email protected]>

Author: 6 people

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

@@ -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)
 

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

@@ -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"
 }

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/__init__.py

@@ -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",

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_api_versions.py

@@ -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

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_call_automation_client.py

@@ -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),

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_client.py

@@ -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
     """

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/_configuration.py

@@ -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.")

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/aio/_client.py

@@ -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
     """

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/aio/_configuration.py

@@ -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.")

sdk/communication/azure-communication-callautomation/azure/communication/callautomation/_generated/aio/operations/__init__.py

@@ -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