---
title: "從 Microsoft Dynamics 365 連接"
description: "透過你的 SBC 使用 X-headers 將 Dynamics 365 Contact Center 及 Copilot Studio 通話轉接至 ThunderPhone 智能體，並透過 HTTP 查詢智能體的轉接資料。"
---

Dynamics 365 Contact Center 會透過你的工作階段邊界控制器（SBC）將來電者轉接至智能體，並附上最多五個 X-header，包括交談 ID。智能體完成後會結束通話，你的 SBC 會將來電者帶回 Dynamics 365，而 HTTP Request 節點會擷取交接資料。

## 開始前

- 一個 ThunderPhone 智能體及一個組織[API 金鑰](/yue/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)）：
  支援的 SBC、公開憑證、連接埠 5061 上的 TLS 1.2，以及面向 Microsoft 的 SRTP。
- **轉接交談**節點支援 **SIP X-header**
  （[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 驗證的平台](/yue/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-header。
3. 在 Copilot Studio 中，新增一個設為
   **外部電話號碼轉接**的 **轉接交談**節點，並加入 X-header：
   - `X-Call-ID`：Dynamics 365 交談 ID。Microsoft 並無標頭提供此 ID，
     因此請在此加入；ThunderPhone 會將其儲存為通話的
     `external_call_id`。請在 Copilot Studio 中確認哪個變數儲存交談 ID。
   - 最多另外四個，例如 `X-Customer-Tier`。

Microsoft 最多傳送五個 X-header，名稱最長 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. 取回通話

智能體會交還通話：它會道別並掛線。加入以下轉接號碼（參閱
[加入轉接號碼](/yue/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 最多接受 128 個字元的 UUI。
- Microsoft 未有記錄如何讀取 `BYE` 上的標頭，因此只能透過查詢取得交接資料。
