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

Contact centers

從 Five9 連接

透過 AI Agent Connect,使用 SIP 將 Five9 通話轉接至 ThunderPhone 智能體,並透過 IVR 指令碼讀取嘅路由標頭將通話轉回。

你的 Five9 IVR 指令碼會連同 Five9 的通話詳情,將來電者轉接至智能體。當智能體完成後,會在 SIP BYE 中附上路由標頭並掛線;指令碼會讀取這些標頭至通話變數,以路由來電者。

開始前準備

  • 一個 ThunderPhone 智能體及組織的 API 金鑰。
  • Five9 的 AI Agent Connect 附加元件。Five9 只限已獲其認可的 AI 供應商使用,而 Five9 的實施團隊會負責設定:匯入供應商的 IVR 指令碼範本、建立通話變數,並將指令碼的 第三方轉接 模組指向該供應商。ThunderPhone 尚未列入 Five9 的認可名單:在據此規劃前,請先向你的 Five9 客戶團隊或 ThunderPhone 支援團隊查詢。

1. 建立 SIP 端點

Five9 的第三方轉接模組會撥打電話號碼,而非 SIP 位址;其他供應商的 Five9 整合方案則透過來源位址而非密碼驗證 Five9。因此,請建立一個 ip_allowlist 端點,並將 Five9 會撥打的號碼設為撥入號碼(請參閱 撥打電話號碼的平台):

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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs:由 Five9 提供的 Five9 資料中心 SIP 訊號範圍。每個範圍必須為 /16 或更窄的公用 IPv4 範圍(IPv6 則為 /48 或更窄)。
  • dial_in_numbers:Five9 指令碼會撥打的號碼,請按 Five9 傳送號碼的格式填寫。此號碼毋須為真實電話號碼。它不能已在 ThunderPhone 中使用,不論作為電話號碼或另一個端點的號碼:否則會傳回 409。

Five9 的位址由所有客戶共用,因此任何撥打該號碼的其他 Five9 客戶都會接通你的智能體。如可自行選擇號碼,請選用無人會猜到的長號碼(最多 15 位數),確保 Five9 將其傳送至 ThunderPhone 而非撥出至電話網絡,並且不要公開該號碼。

2. 傳送附帶背景資料的通話

請要求 Five9 的實施團隊:

  • 從 第三方轉接 模組將通話傳送至 sip:+14155550188@sip.thunderphone.com,並在請求 URI 及 To 標頭中均包含該號碼。此模組會將號碼連同供應商的 SIP 網域置於標頭中傳送。
  • 透過 TLS(連接埠 5061)或 TCP(連接埠 5060)傳送。此端點拒絕 UDP,而 Five9 不會公開其使用的傳輸方式,因此請確保並非使用 UDP。
  • 啟用 第三方通話後返回,讓指令碼在智能體掛線後繼續執行(Five9 容許第三方通話最長 3,600 秒)。

Five9 的指南列出其傳送的值(call.ANI、call.DNIS、 call.call_id、call.session_id、call.campaign_name 等),但未列出其標頭名稱。其他 AI 供應商的 Five9 整合方案記錄顯示,這些值會以 X-CallANI、X-CallDNIS、X-CallID、X-CallSessionID、X-CallCampaign 及 X-AgentID 形式在線路上傳送;請在首次測試通話中核對。每項資料都會以變數形式傳入提示詞,例如 {{sip_x_callcampaign}}。X-CallID 會儲存為通話的 external_call_id。

3. 接回通話

智能體會接回通話:它會道別並掛線,而 BYE 會帶有 Five9 指令碼讀取的 四個標頭。加入此轉接號碼(請參閱 加入轉接號碼):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType 及 X-RouteValue 會告訴指令碼將來電者轉送至何處,此處為 Support 技能。其他供應商為 X-RouteType 記錄的值包括 SkillTransfer、PhoneTransfer、Hangup 及 DispositionOnly;請與維護指令碼的人員確認相關值。如有多個目的地,請為每個目的地加入一個回傳項目,並使用不同名稱及 X-RouteValue。
  • X-RouteReason 會帶有智能體的意圖標籤,例如 billing_dispute。
  • X-CustomMetaData 會帶有交接 ID。BYE 亦會以 X-TP-Handoff-Id 帶有該 ID,但 Five9 不會讀取。

Five9 的指令碼會將四個標頭對應至通話變數。如要取得智能體的摘要,請讓指令碼透過 IVR 查詢 模組呼叫交接查詢: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= 後接 call.call_id,並使用會傳送 Authorization: Bearer 及你的 API 金鑰的授權設定檔。請參閱 查詢已交接的通話。

測試

撥入 IVR 指令碼,要求智能體轉接真人,並檢查指令碼是否已在填入通話變數後為來電者路由。如通話從未到達智能體,請檢查請求 URI 及 To 標頭中的號碼是否與撥入號碼相符、Five9 的來源位址是否位於 allowed_source_cidrs,以及通話是否經由 TCP 或 TLS 傳送。然後使用 GET /v1/calls/{call_id} 開啟通話:sip_headers 應列出 x-callid,而 external_call_id 應與 Five9 中的 call.call_id 相符。

限制

  • Five9 的指南記錄了 BYE 上的路由資料,且沒有提及接受 REFER,因此回交由指令碼以冷轉接方式處理。
  • Five9 讀取的是 X-RouteType、X-RouteValue、X-RouteReason 及 X-CustomMetaData,而非 User-to-User。ThunderPhone 傳送的每個標頭值最多為 256 位元組。
  • Five9 建議將自訂標頭維持在約十個,以避免封包碎片化。