---
title: "從 NICE CXone 連接"
description: "透過 Studio 腳本將 NICE CXone 通話連同 SIP 標頭中的 ContactID 傳送至 ThunderPhone 智能體，並在腳本繼續執行時查詢智能體的轉接結果。"
---

你的 CXone Studio 腳本會透過 SIP 標頭向智能體撥打電話，並傳送聯絡個案 ID 及任何其他背景資料。智能體完成後會掛線，腳本中的 REST API 動作會擷取轉交資料。

## 開始前

- 一個 ThunderPhone 智能體及一個組織 [API 金鑰](/yue/guides/api-keys)。
- 一個可接受自訂標頭的 CXone SIP 中繼群組。你的 NICE 客戶代表必須先啟用此設定，CXone 才會傳送這些標頭。

## 1. 建立 SIP 端點

Placecall 會透過 CXone 中繼群組撥打電話號碼，而不是 SIP 位址。
NICE 沒有提供相關 SIP 憑證文件，而另一個 AI 供應商的 CXone
整合使用 TLS 及 IP 允許清單。因此，請建立一個 `ip_allowlist`
端點，並將腳本會撥打的號碼設為撥入號碼（請參閱
[撥打電話號碼的平台](/yue/guides/sip-addresses)）：

```bash
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 標頭，因此智能體會回傳通話：它會道別並掛線，而你的腳本會重新接回
來電者。加入以下轉接號碼（請參閱
[加入轉接號碼](/yue/guides/contact-centers/overview)）：

```json
{"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`，以路由聯絡個案。

請參閱[查詢已轉交通話](/api-reference/calls#look-up-a-handed-off-call)。

## 測試

致電執行該腳本的號碼，要求智能體轉接至某位人士，並確認腳本會繼續執行，以及 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 的回應。
