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

Contact centers

從 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. 傳送附帶內容的通話

  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 保留原有名稱 (自訂內容)。

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 上的標頭,因此只能透過查詢取得交接資料。