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

Contact centers

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

  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 之後繼續執行。其他 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 的回應。