Open in
從 NICE CXone 連線
透過 Studio 指令碼,將 NICE CXone 通話連同 SIP 標頭中的 ContactID 傳送至 ThunderPhone 智慧體,並在指令碼繼續執行時查詢智慧體的轉接。
你的 CXone Studio 指令碼會透過 SIP 標頭撥打智慧體,標頭會帶有聯絡人 ID 和其他任何脈絡資訊。智慧體完成後會掛斷,而指令碼中的 REST API 動作會取得交接資訊。
開始前
- 一個 ThunderPhone 智慧體和一組組織 API 金鑰。
- 一個接受自訂標頭的 CXone SIP 中繼群組。CXone 傳送這些標頭前,你的 NICE 帳戶代表必須先啟用此設定。
1. 建立 SIP 端點
Placecall 會透過 CXone 中繼群組撥打電話號碼,而不是 SIP 位址。
NICE 未提供其 SIP 憑證的文件,且另一家人工智慧供應商的 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 之後繼續執行的文件。其他人工智慧供應商的 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 的回應。