使用通話自動化將 Microsoft Teams 使用者新增至現有通話

發行項
11/25/2024

在本快速入門中，我們會使用 Azure 通訊服務通話自動化 API 來新增、移除及轉移 Teams 使用者的通話。

必要條件

包含使用中訂用帳戶的 Azure 帳戶，如需詳細資料，請參閱建立免費帳戶。
具有系統管理權限的 Microsoft Teams 電話授權和 Teams 租用戶。若要使用此功能，必須有 Teams 電話授權，在這裡深入了解 Teams 授權。 Microsoft Teams 使用者也必須啟用 voice，請參閱 setting-up-your-phone-system (英文)。需要系統管理權限才能授權通訊服務資源來和 Teams 使用者通話，如步驟 1 稍後所述。
透過選取 Azure 入口網站左側功能表中的 [金鑰]，找到已部署的通訊服務資源和有效的連接字串。
從通訊服務資源取得 PSTN 電話號碼。請記下您在本快速入門中使用的電話號碼。
Azure 事件方格訂用帳戶，以接收 IncomingCall 事件。
您的操作系統最新的 Azure 通訊服務通話自動化 API 程式庫。
實作通話自動化 API 程式庫的 Web 服務，請遵循本教學課程。

步驟 1: Azure 通訊服務資源的授權，以啟用對 Microsoft Teams 使用者的通話

若要透過通話自動化 API 啟用通話，Microsoft Teams 系統管理員 (英文) 或全域管理員 (英文) 必須明確啟用通訊服務資源對其租用戶的存取權，才能允許通話。

Set-CsTeamsAcsFederationConfiguration (MicrosoftTeamsPowerShell) 租用戶層級設定，可啟用/停用其租用戶與特定通訊服務資源之間的同盟。

Set-CsExternalAccessPolicy (SkypeForBusiness) 使用者原則，可讓系統管理員進一步控制組織中的哪些使用者可以參與與通訊服務使用者的同盟通訊。

步驟 2: 使用圖形 API 取得 Teams 使用者的 Microsoft Entra 物件識別碼，並選擇性地檢查其是否存在

Teams 使用者的 Microsoft Entra 物件識別碼 (OID) 必須將它們新增至通訊服務通話，或從通訊服務進行轉移。 OID 可以透過 1) Office 入口網站、2) Microsoft Entra 系統管理中心、3) Microsoft Entra 連線；或 4) 圖形 API。下列範例使用圖形 API。

Microsoft Entra 系統管理員必須先授與同意後，才能使用 Graph 來搜尋使用者，請遵循 Microsoft Graph 安全性 API 概觀 (英文) 文件深入了解。使用清單使用者 API 來擷取 OID，以搜尋使用者。下列範例會依顯示名稱顯示搜尋，但您也可以搜尋其他屬性：

使用 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: 將 Teams 使用者新增至由通話自動化 API 控制的現有通訊服務通話

您必須完成必要條件步驟，並讓 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 名冊上顯示所有參與者。使用通話自動化 API 管理通話的應用程式，會在通話畫面上對 Teams 使用者保持隱藏。 Microsoft Teams 使用者接聽通話並輸入 Microsoft Teams 使用者通話中體驗的螢幕擷取畫面。

步驟 4: 將 Teams 使用者從由通話自動化 API 控制的現有通訊服務通話中移除

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

選用功能: 從由通話自動化 API 控制的現有通訊服務通話轉移至 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>"))

清除資源

如果您想要清除並移除通訊服務訂用帳戶，您可以刪除資源或資源群組。刪除資源群組也會刪除與其相關聯的任何其他資源。深入了解如何清除資源。

下一步

了解如何錄製通話
深入了解通話自動化及其功能。
深入了解 Azure 通訊服務通話自動化 Teams 互通性支援的功能。
了解播放動作，以在通話中播放音訊。
了解如何依據客戶支援案例建置通話工作流程。

共用方式為