Open in
從 NICE CXone 連接
透過 Studio 腳本將 NICE CXone 通話連同 SIP 標頭中的 ContactID 傳送至 ThunderPhone 智能體,並在腳本繼續執行時查詢智能體的轉接結果。
你的 CXone Studio 腳本會透過 SIP 標頭向智能體撥打電話,並傳送聯絡個案 ID 及任何其他背景資料。智能體完成後會掛線,腳本中的 REST API 動作會擷取轉交資料。
開始前
- 一個 ThunderPhone 智能體及一個組織 API 金鑰。
- 一個可接受自訂標頭的 CXone SIP 中繼群組。你的 NICE 客戶代表必須先啟用此設定,CXone 才會傳送這些標頭。
1. 建立 SIP 端點
Placecall 會透過 CXone 中繼群組撥打電話號碼,而不是 SIP 位址。
NICE 沒有提供相關 SIP 憑證文件,而另一個 AI 供應商的 CXone
整合使用 TLS 及 IP 允許清單。因此,請建立一個 ip_allowlist
端點,並將腳本會撥打的號碼設為撥入號碼(請參閱
撥打電話號碼的平台):
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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs:由 NICE 提供、你的 CXone 叢集所使用的 SIP 訊號範圍。 每個範圍必須是/16或更精確的公開 IPv4 範圍(IPv6 則為/48或更精確)。dial_in_numbers:Placecall 會撥打的號碼,須按 CXone 傳送的格式填寫。這不一定是真實電話號碼。不可以已在 ThunderPhone 中使用——無論作為電話號碼還是其他端點上的號碼——否則會傳回409。
CXone 的位址由所有客戶共用,因此任何其他 CXone 客戶如撥打該號碼,都會接通你的智能體。選擇號碼時,請使用一個不易被猜中的長號碼(最多 15 位數),確保 CXone 將其傳送至 ThunderPhone 而非撥出至電話網絡,並且不要公開該號碼。
2. 連同背景資料傳送通話
在你的 Studio 腳本中,於 Placecall 之前:
- 加入一個 Sipputheader 動作,標頭設為
X-Call-ID,值設為ContactID。CXone 不會傳送自己的通話 ID 標頭;ThunderPhone 會將此標頭儲存為通話的external_call_id。 - 為智能體需要知道的每個其他值加入一個 Sipputheader 動作,
例如將
X-Skill設為support。它會以{{sip_x_skill}}傳送至提示詞。Sipputheader 支援User-to-User、任何X-標頭及 大部分P-標頭;NICE 建議值不超過 256 個字元。
然後透過會將該號碼傳送至 sip.thunderphone.com 的中繼群組,向該號碼執行 Placecall,並在請求 URI 及 To
標頭中同時帶入該號碼。端點支援 TLS(連接埠 5061)或 TCP(連接埠 5060),並拒絕
UDP。NICE 沒有提供中繼傳輸方式的文件,因此請確保不是
UDP。
3. 取回通話
CXone 只會在 INVITE 及其最終回應中讀取 SIP 標頭,因此智能體會回傳通話:它會道別並掛線,而你的腳本會重新接回
來電者。加入以下轉接號碼(請參閱
加入轉接號碼):
{"name": "NICE CXone", "action": "return"}NICE 沒有提供文件說明已撥出的通話結束後,腳本會在 Placecall 之後繼續執行。其他 AI 供應商的 CXone 整合會在掛線前,透過 CXone 的 Signal API(POST /interactions/{contactId}/signal)向腳本發送訊號;ThunderPhone 不會呼叫它。請向 NICE 確認你的腳本如何接回來電者,然後使用 REST API 動作擷取轉交資料:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=後接ContactID。- 標頭
Authorization: Bearer sk_live_…。 - 從回應讀取
handoff.summary及handoff.intent,以路由聯絡個案。
請參閱查詢已轉交通話。
測試
致電執行該腳本的號碼,要求智能體轉接至某位人士,並確認腳本會繼續執行,以及 REST API 動作會傳回交接結果。若通話從未到達智能體,請檢查 CXone 傳送的號碼、其來源位址是否位於 allowed_source_cidrs,以及通話是否經由 TCP 或 TLS 傳送。然後使用 GET /v1/calls/{call_id} 開啟通話:sip_headers 應列出 x-call-id,而 external_call_id 應等同於 ContactID。
限制
- CXone 只會在
INVITE及其最終2xx中傳送和讀取標頭,因此智能體BYE中的任何內容均不會傳送至腳本。 - NICE 未有說明是否接受由智能體發出的
REFER。 - REST API 動作預設會在 10 秒後逾時(最長少於 90 秒),並會讀取最多 32 KB 的回應。