Call Automation を使用して既存の通話に Microsoft Teams ユーザーを追加する

[アーティクル]
09/26/2024

重要

Azure Communication Services のこの機能は、現在プレビュー段階にあります。

プレビューの API と SDK は、サービスレベルアグリーメントなしに提供されます。運用環境のワークロードには使用しないことをお勧めします。一部の機能はサポート対象ではなく、機能が制限されることがあります。

詳細については、「Microsoft Azure プレビューの追加利用規約」を確認してください。

このクイックスタートでは、Azure Communication Services Call Automation API を使用して、Teams ユーザーに対して通話を追加、削除、転送します。

前提条件

アクティブなサブスクリプションを持つ Azure アカウント。詳細については、「アカウントの無料作成」を参照してください。
Microsoft Teams 電話のライセンスと、管理者特権を持つ Teams テナント。 Teams 電話のライセンスはこの機能を使用するために必須です。Teams ライセンスの詳細については、こちらを参照してください。 Microsoft Teams ユーザーも voice を有効にする必要があります。「setting-up-your-phone-system」を参照してください。管理者特権は、Teams ユーザーへの通話を Communication Services リソースに認可するために必要です。これについては手順 1 で後から説明します。
デプロイされた Communication Service リソースと、Azure portal の左側のメニューで [キー] を選択して検出された有効な接続文字列。
Communication Service リソースから PSTN 電話番号を取得する。このクイックスタートで使用するために取得した電話番号をメモしてください。
IncomingCall イベントを受信するための Azure Event Grid サブスクリプション。
お使いのオペレーティングシステムに応じた最新の Azure Communication Service Call Automation API ライブラリ。
Call Automation API ライブラリを実装する Web サービス。このチュートリアルに従ってください。

手順 1: Microsoft Teams ユーザーへの通話を可能にするための Azure Communication Services リソースの認可

Call Automation API を通じた通話を可能にするには、Microsoft Teams 管理者またはグローバル管理者は明示的に、Communication Services リソースのそのテナントへのアクセスを有効にして通話を許可できるようにする必要があります。

テナントと特定の Communication Services リソースとのフェデレーションを有効/無効にする Set-CsTeamsAcsFederationConfiguration (MicrosoftTeamsPowerShell) テナントレベルの設定。

Set-CsExternalAccessPolicy (SkypeForBusiness) ユーザーポリシーを使用すると、管理者は、組織内のどのユーザーが Communication Services ユーザーとのフェデレーション通信に参加できるかをさらに制御できます。

手順 2: Graph API を使用して、Teams ユーザーの Microsoft Entra オブジェクト ID を取得し、必要に応じてユーザーのプレゼンスを確認する

Teams ユーザーの Microsoft Entra オブジェクト ID (OID) は、Communication Services の通話に対してユーザーを追加したり転送したりするために必要です。 OID は、1) Office ポータル、2) Microsoft Entra 管理センター、3) Microsoft Entra Connect、または 4) Graph API を通じて取得できます。次の例は Graph API を使用しています。

Graph を使用してユーザーを検索するには、その前に Microsoft Entra 管理者が同意する必要があります。詳細については、「Microsoft Graph Security API の概要」を参照してください。 OID は、List users API を使用してユーザーを検索することにより取得できます。次の例は、表示名による検索を示していますが、他のプロパティを検索することもできます。

Microsoft Graph v1.0 を使用してユーザーを一覧表示する:

Request:
    https://graph.microsoft.com/v1.0/users?$search="displayName:Art Anderson"
Permissions:
    Application and delegated. Refer to documentation.
Response:
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users",
    "value": [
        {
            "displayName": "Art Anderson",
            "mail": "artanderson@contoso.com",
            "id": "fc4ccb5f-8046-4812-803f-6c344a5d1560"
        }

必要に応じて、プレゼンス取得 API とユーザー ObjectId を使用して、ユーザーのプレゼンスを取得できます。詳細は、Microsoft Graph v1.0 のドキュメントを参照してください。

Request:
https://graph.microsoft.com/v1.0/users/fc4ccb5f-8046-4812-803f-6c344a5d1560/presence
Permissions:
Delegated only. Application not supported.  Refer to documentation.
Response:
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('fc4ccb5f-8046-4812-803f-6c344a5d1560')/presence/$entity",
    "id": "fc4ccb5f-8046-4812-803f-6c344a5d1560",
    "availability": "Offline",
    "activity": "Offline"

手順 3: Call Automation API によって制御される既存の Communication Services 通話に Teams ユーザーを追加する

事前に必要な手順をすべて終え、Communication Services の通話を制御する Web サービスアプリを用意しておく必要があります。 callConnection オブジェクトを使用して、通話に参加者を追加します。

CallAutomationClient client = new CallAutomationClient('<Connection_String>');
AnswerCallResult answer = await client.AnswerCallAsync(incomingCallContext, new Uri('<Callback_URI>'));
await answer.Value.CallConnection.AddParticipantAsync(
    new CallInvite(new MicrosoftTeamsUserIdentifier('<Teams_User_Guid>'))
    {
        SourceDisplayName = "Jack (Contoso Tech Support)"
    });

CallAutomationClient client = new CallAutomationClientBuilder().connectionString("<resource_connection_string>").buildClient();
AnswerCallResult answer = client.answerCall(incomingCallContext, "<Callback_URI>"));
answer.getCallConnection().addParticipant(
    new CallInvite(new MicrosoftTeamsUserIdentifier("<Teams_User_Guid>"))
        .setSourceDisplayName("Jack (Contoso Tech Support)"));

const client = new CallAutomationClient("<resource_connection_string>");
const answer = await client.answerCall(incomingCallContext, "<Callback_URI>"));
answer.callConnection.addParticipant({
    targetParticipant: { microsoftTeamsUserId: "<Teams_User_Guid>" },
    sourceDisplayName: "Jack (Contoso Tech Support)"
});

call_automation_client = CallAutomationClient.from_connection_string("<resource_connection_string>")
answer = call_automation_client.answer_call(incoming_call_context = incoming_call_context, callback_url = "<Callback_URI>")
call_connection_client = call_automation_client.get_call_connection(answer.call_connection_id)
call_connection_client.add_participant(target_participant = CallInvite(
    target = MicrosoftTeamsUserIdentifier(user_id="<USER_ID>"),
    source_display_name = "Jack (Contoso Tech Support)"))

Microsoft Teams デスクトップクライアントで、Jack の通話は、着信トースト通知を通じて Microsoft Teams ユーザーに送信されます。

Microsoft Teams デスクトップクライアントのスクリーンショット。Jack の通話は、着信トースト通知を通じて Microsoft Teams ユーザーに送信されます。

Microsoft Teams ユーザーが通話を受け入れると、Microsoft Teams ユーザーの通話内エクスペリエンスにより、すべての参加者が Microsoft Teams 名簿に表示されます。 Call Automation API を使用して通話を管理しているアプリケーションは、通話画面で Teams ユーザーに対して非表示のままです。 Microsoft Teams ユーザーが通話を受け、Microsoft Teams ユーザーの通話内エクスペリエンスを入力しているスクリーンショット。

手順 4: Call Automation API によって制御される既存の Communication Services 通話から Teams ユーザーを削除する

await answer.Value.CallConnection.RemoveParticipantAsync(new MicrosoftTeamsUserIdentifier('<Teams_User_Guid>'));

answer.getCallConnection().removeParticipant(new MicrosoftTeamsUserIdentifier("<Teams_User_Guid>"));

answer.callConnection.removeParticipant({ microsoftTeamsUserId: "<Teams_User_Guid>" });

call_connection_client.remove_participant(target_participant = MicrosoftTeamsUserIdentifier(user_id="<USER_ID>"))

オプション機能: Call Automation API によって制御される既存の Communication Services 通話を Teams ユーザーに転送する

await answer.Value.CallConnection.TransferCallToParticipantAsync(new MicrosoftTeamsUserIdentifier('<Teams_User_Guid>'));

answer.getCallConnection().transferCallToParticipant(new MicrosoftTeamsUserIdentifier("<Teams_User_Guid>"));

answer.callConnection.transferCallToParticipant({ microsoftTeamsUserId: "<Teams_User_Guid>" });

call_connection_client.transfer_call_to_participant(target_participant = MicrosoftTeamsUserIdentifier(user_id = "<USER_ID>"))

リソースをクリーンアップする

Communication Services サブスクリプションをクリーンアップして解除する場合は、リソースまたはリソースグループを削除できます。リソースグループを削除すると、それに関連付けられている他のリソースも削除されます。詳細については、リソースのクリーンアップに関する記事を参照してください。

次のステップ

通話の記録方法を参照してください。
Call Automation とその機能の詳細を確認する。
Teams での Azure Communication Services Call Automation との相互運用性サポートの機能について詳細を確認してください
通話でオーディオを再生するための再生アクションについて説明します。
顧客サポートシナリオの通話ワークフローを構築する方法について確認する。

次の方法で共有