Open in
從 Five9 連線
透過 AI Agent Connect 將 Five9 通話經由 SIP 傳送至 ThunderPhone 智慧體,並透過 IVR 指令碼可讀取的路由標頭將通話傳回。
你的 Five9 IVR 指令碼會連同 Five9 的通話詳細資料,將來電者轉接至智慧體。智慧體完成後,會在 SIP BYE 上附帶路由標頭掛斷;指令碼會將其讀入通話變數,以路由來電者。
開始前
- 一個 ThunderPhone 智慧體和一個組織的 API 金鑰。
- Five9 的 AI 智慧體連線附加元件。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;請與維護指令碼的人員確認使用的值。若有多個目的地,請為每個目的地新增一個 return,並設定不同的名稱和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 建議將自訂標頭維持在約十個,以避免封包碎裂。