ThunderPhone v3 現已上線。自助開通,每分鐘 2¢ 起。查看公告

Contact centers

從 Microsoft Dynamics 365 連接

透過你的 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 金鑰。
  • Dynamics 365 Contact Center 語音通道,透過 Azure Communication Services 直接路由連線至你運作的 SBC (SBC 需求): 具備公開憑證、在連接埠 5061 使用 TLS 1.2,並朝向 Microsoft 使用 SRTP 的受支援 SBC。
  • SIP X 標頭支援,位於 轉接交談 節點 (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. 傳送含有情境資訊的通話

  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 保留其名稱 (自訂情境)。

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 的 UUI 最多可包含 128 個字元。
  • Microsoft 未記錄如何讀取 BYE 上的標頭,因此交接資訊只能透過查詢取得。