Open in
從 Microsoft Dynamics 365 連接
透過你的 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 金鑰。
- Dynamics 365 Contact Center 語音渠道,透過 Azure Communication Services 直接路由連接至你管理的 SBC (SBC 要求): 支援的 SBC、公開憑證、連接埠 5061 上的 TLS 1.2,以及面向 Microsoft 的 SRTP。
- 轉接交談節點支援 SIP X-header (Copilot Studio)。 確認你的環境可使用此功能。
Dynamics 365 只會轉接至電話號碼,而 Microsoft 會以憑證而非密碼驗證直接路由。你的 SBC 位於 Microsoft 與 ThunderPhone 之間,並將該號碼轉換為智能體的 SIP 位址。
1. 建立 SIP 端點
通話會從你的 SBC 到達 ThunderPhone,因此請建立一個供 SBC 使用的標準端點:
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 驗證的平台。
2. 傳送附帶內容的通話
- 在你的 SBC 上為智能體選擇一個電話號碼,例如
+14155550188。 - 在 SBC 上,將撥打該號碼的通話透過連接埠
5061上的 TLS 路由至端點的sip_uri,例如sip:agent-12-jhxmginwjx@sip.thunderphone.com。ThunderPhone 會透過使用者部分 (agent-12-jhxmginwjx)識別端點,該部分必須同時存在於要求 URI 及To標頭中。原樣傳遞 X-header。 - 在 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 保留原有名稱
(自訂內容)。
3. 取回通話
智能體會交還通話:它會道別並掛線。加入以下轉接號碼(參閱 加入轉接號碼):
{"name": "Dynamics 365", "action": "return"}將來電者帶回 Dynamics 365 是你的 SBC 責任。Microsoft 記錄了一種讓通話攜帶情境資料的接入方式:透過 SBC 向已在 Dynamics 365 註冊的號碼發起新通話,並附帶 UUI,其索引鍵須與你在 工作流程 → 進階設定
(第三方 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。
參閱查詢已交接的通話。
測試
致電一個可到達轉接節點的 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上的標頭,因此只能透過查詢取得交接資料。