---
title: "從 Microsoft Dynamics 365 連接"
description: "透過你的 SBC 與 X-header，將 Dynamics 365 Contact Center 和 Copilot Studio 通話傳送至 ThunderPhone 智慧體，並透過 HTTP 查詢智慧體的轉接。"
---

Dynamics 365 Contact Center 會透過你的工作階段邊界控制器（SBC）將來電者傳送至智慧體，並可附帶最多五個 X 標頭，包括交談 ID。智慧體完成後會掛斷，你的 SBC 會將來電者帶回 Dynamics 365，而 HTTP Request 節點則會擷取交接資訊。

## 開始前準備

- 一個 ThunderPhone 智慧體和組織的 [API 金鑰](/zh-Hant/guides/api-keys)。
- Dynamics 365 Contact Center 語音通道，透過 Azure Communication Services **直接路由**連線至你運作的 SBC
  （[SBC 需求](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)）：
  具備公開憑證、在連接埠 5061 使用 TLS 1.2，並朝向 Microsoft 使用 SRTP 的受支援 SBC。
- **SIP X 標頭支援**，位於 **轉接交談** 節點
  （[Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)）。
  確認你的環境可使用此功能。

Dynamics 365 僅能轉接至電話號碼，而 Microsoft 會透過憑證而非密碼驗證直接路由。你的 SBC 位於 Microsoft 與 ThunderPhone 之間，並將該號碼轉換為智慧體的 SIP 位址。

## 1. 建立 SIP 端點

通話會從你的 SBC 抵達 ThunderPhone，因此請建立供 SBC 使用的標準端點：

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Dynamics 365 SBC"}'
```

請立即儲存回應中的 `password`；它只會顯示一次，而你的 SBC 會使用它回應 ThunderPhone 的驗證挑戰。如果你的 SBC 無法使用摘要驗證，請改為建立將 `auth` 設為 `ip_allowlist` 並指定 SBC 公開位址的端點；請參閱
[依來源 IP 驗證的平台](/zh-Hant/guides/sip-addresses)。

## 2. 傳送含有情境資訊的通話

1. 在你的 SBC 上為智慧體選擇一個電話號碼，例如 `+14155550188`。
2. 在 SBC 上，將撥打該號碼的通話透過連接埠 `5061` 上的 TLS，路由至端點的 `sip_uri`，例如 `sip:agent-12-jhxmginwjx@sip.thunderphone.com`。ThunderPhone 會依使用者部分
   （`agent-12-jhxmginwjx`）尋找端點，此部分必須同時存在於要求 URI 和
   `To` 標頭中。請原樣傳遞 X 標頭。
3. 在 Copilot Studio 中，新增 **轉接交談** 節點，並使用 **轉接至外部電話號碼** 將通話轉接至該號碼，接著新增 X 標頭：
   - `X-Call-ID`：Dynamics 365 交談 ID。Microsoft 沒有任何標頭會攜帶
     此資訊，因此請在此新增；ThunderPhone 會將其儲存為通話的
     `external_call_id`。請在 Copilot Studio 中確認哪個變數包含交談 ID。
   - 最多可再加入四個標頭，例如 `X-Customer-Tier`。

Microsoft 最多會傳送五個 X 標頭，名稱最長 64 個字元、值最長 256 個字元，並可使用字母、數字及 `= ; . ! % * _ + ~ -`。它會以小寫 `x-` 寫入前綴；ThunderPhone 比對標頭名稱時會忽略大小寫，因此 `x-customer-tier` 會以 `{{sip_x_customer_tier}}` 傳遞至提示詞。

若你改用 Azure Communication Services Call Automation 建立通話，`AddSipX` 預設會寫入 `X-MS-Custom-` 名稱。請傳遞 `SipHeaderPrefix.X`，讓 `X-Call-ID` 保留其名稱
（[自訂情境](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)）。

## 3. 讓通話返回

智慧體會將通話轉回：它會道別並掛斷。新增此轉接號碼（請參閱
[新增轉接號碼](/zh-Hant/guides/contact-centers/overview)）：

```json
{"name": "Dynamics 365", "action": "return"}
```

將來電者帶回 Dynamics 365 是你的 SBC 的工作。Microsoft 記錄了一種讓通話攜帶情境資訊進入的方法：透過 SBC 撥打註冊於 Dynamics 365 的號碼，並附帶 UUI，其索引鍵須與你在 **工作串流 → 進階設定**
（[第三方 IVR 轉接](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)）中設定的情境變數相符。
請與你的 SBC 供應商確認 ThunderPhone 掛斷時，來電者要如何到達該號碼，並傳遞你在 `X-Call-ID`
中傳送的對話 ID，讓流程能找到該通話。

接著使用 Copilot Studio 的 **HTTP 要求** 節點擷取交接資訊：

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  後接對話 ID。
- 標頭 `Authorization: Bearer sk_live_…`。
- 將回應剖析為變數，並使用 `handoff.summary` 和
  `handoff.intent`。

請參閱[查詢已交接的通話](/api-reference/calls#look-up-a-handed-off-call)。

## 測試

撥打會連至轉接節點的 Dynamics 365 號碼，要求智慧體轉接真人，並確認來電者會返回 Dynamics 365。接著以 `GET /v1/calls/{call_id}` 開啟通話：`sip_headers` 應列出 `x-call-id`，而
`external_call_id` 應為對話 ID。如果通話從未到達智慧體，而你的 SBC 紀錄顯示 SIP `404`，其請求 URI 或 `To` 標頭未包含端點的使用者部分。

## 限制

- 必須使用 SBC。Microsoft 無法撥打 SIP 位址或回應摘要驗證挑戰。
- Microsoft 最多傳送五個 X 標頭，且對於撥入的通話只保留前五個。Dynamics 365 的 UUI 最多可包含 128 個字元。
- Microsoft 未記錄如何讀取 `BYE` 上的標頭，因此交接資訊只能透過查詢取得。
