Open in
從 Zoom Contact Center 連接
透過第三方語音機械人連接器,將 Zoom Contact Center 通話轉接至 ThunderPhone 智能體,並使用 SIP REFER 將通話轉回真人客服人員。
Zoom Contact Center 流程中的 Bot 小工具會使用 Zoom 的通話 SID,將來電者轉接至智能體。當來電者需要真人協助時,智能體會向 Zoom 的人工客服地址發送 SIP REFER,而你的流程會透過通話 SID 擷取轉接資料。
開始之前
- 一個 ThunderPhone 智能體及機構的 API 金鑰。
- 一個由管理員管理並已開放予 Contact Center 使用的 Zoom Marketplace 通用應用程式,當中設有 Bot 小工具的連接器 (Zoom 的第三方語音機械人指南)。
- 由 Zoom 連接至機械人供應商的 SIP 中繼。Zoom 的 ISV 團隊會分階段建立(需求探索、測試中繼,然後投入生產),而應用程式的公司名稱必須與中繼記錄完全相符。此設定須由 ThunderPhone 支援團隊與 Zoom 開始處理,並非只可在你的 Zoom 帳戶中完成。
1. 建立 SIP 端點
Zoom 的連接器會撥打一個以 999 開頭的 15 位數字,而非 SIP
地址。儲存連接器後便會產生該號碼。Zoom 的中繼會在連接埠 5061 使用 TLS 1.2,並以 SRTP 傳送音訊;其存取權由 Zoom 的子網絡白名單控制,而非密碼。因此,請建立一個 ip_allowlist 端點,將連接器的號碼設為撥入號碼,並要求使用 SRTP(請參閱
撥打電話號碼的平台):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs:由 Zoom 提供的 Zoom SIP 訊令子網絡。每個項目必須為/16或更窄的公開 IPv4 範圍(IPv6 則為/48或更窄)。dial_in_numbers:連接器的號碼,必須與 Zoom 傳送的格式完全相同,且不含+。srtp:required,因為 Zoom 的中繼一律使用 SRTP。
Zoom 的地址由其所有客戶共用,因此任何其他 Zoom 客戶如撥打該號碼,均會接通至你的智能體。該號碼由 Zoom 指派;請勿公開。
2. 附帶內容傳送通話
在流程中新增一個 Bot 小工具,並將其綁定至連接器。請要求 Zoom 的 ISV 團隊將中繼指向 sip.thunderphone.com,在連接埠 5061 使用 TLS,並在請求 URI 及 To 標頭中均使用連接器的號碼。端點拒絕 UDP,因此請確保中繼不會回退使用 UDP。
Zoom 會傳送:
X-ZOOM-Call-Sid,儲存為通話的external_call_id。Zoom 自身的資料對應頁面未有列出此項;另一個 AI 供應商的 Zoom 整合文件則有記錄,因此請在首次測試通話時核實。X-ZOOM-DNIS,即來電者撥打的號碼,儲存為{{sip_x_zoom_dnis}}。X-ZOOM-WEBHOOK,即連接器的靜態 URL。
3. 取得轉交通話資料
語音智能體會向 Zoom SBC 上的真人客服地址發送 REFER。使用 Zoom 提供的 SBC
地址新增此轉接號碼(請參閱
新增轉接號碼):
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom 的指南說明機械人可透過兩種方式傳遞內容:在 REFER 之前向連接器的靜態 URL
發送 POST(voicebot_metadata 及類似事件),以及映射至 由 Bot 傳入 的 SIP
標頭。ThunderPhone 不會向靜態 URL 發送資料。Zoom 的指南沒有說明它是否會從
REFER 讀取已映射的標頭;如想嘗試,請在項目中加入例如
"X-Handoff-Id": "{{handoff_id}}" 的 headers,並在測試通話中檢查。同時向 Zoom
確認,它是否接受在沒有事前中繼資料 POST 的情況下發送 REFER。
如要在不依賴上述任何一種方式下取得轉交資料,請在 Bot 小工具之後使用 HTTP 呼叫 或 指令碼 小工具進行查詢:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=後加上通話 SID。- 標頭
Authorization: Bearer sk_live_…。 - 使用
handoff.summary及handoff.intent為來電者安排轉接,並向接聽通話的人員簡介情況。
Zoom 未有發布這些小工具的欄位層級文件,因此請在你的帳戶中確認小工具可否發送
Authorization 標頭。請參閱
查詢已轉交通話。
測試
致電可到達 Bot 小工具的號碼,要求語音智能體轉接至真人,並確認來電者可接通真人客服,
而小工具會傳回轉交資料。然後使用 GET /v1/calls/{call_id} 開啟該通話:
sip_headers 應列出 x-zoom-call-sid,而 external_call_id 應與你的流程使用的
通話 SID 相符。
限制
- ThunderPhone 不會向連接器的靜態 URL 發送資料,因此 Zoom 會透過查詢取得轉交資料,
或在測試確認 Zoom 可從
REFER讀取標頭時,透過已映射的標頭取得資料。 - SIP 中繼線由 Zoom 的 ISV 團隊建立,因此你無法自行設定或測試。