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

Contact centers

從 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 之前:

  1. 新增一個 Sipputheader 動作,標頭設為 X-Call-ID,值設為 ContactID。CXone 不會傳送自己的通話 ID 標頭;ThunderPhone 會將此值儲存為通話的 external_call_id。
  2. 針對智慧體應知道的每個其他值,新增一個 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 的回應。