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

你的 CXone Studio 指令碼會透過 SIP 標頭撥打智慧體，標頭會帶有聯絡人 ID 和其他任何脈絡資訊。智慧體完成後會掛斷，而指令碼中的 REST API 動作會取得交接資訊。

## 開始前

- 一個 ThunderPhone 智慧體和一組組織 [API 金鑰](/zh-Hant/guides/api-keys)。
- 一個接受自訂標頭的 CXone SIP 中繼群組。CXone 傳送這些標頭前，你的 NICE 帳戶代表必須先啟用此設定。

## 1. 建立 SIP 端點

Placecall 會透過 CXone 中繼群組撥打電話號碼，而不是 SIP 位址。
NICE 未提供其 SIP 憑證的文件，且另一家人工智慧供應商的 CXone
整合使用 TLS 與 IP 允許清單。因此，請建立一個 `ip_allowlist`
端點，並將指令碼要撥打的號碼設為撥入號碼（請參閱
[撥打電話號碼的平台](/zh-Hant/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 標頭，因此智慧體會將通話交回：它會道別並掛斷，而你的指令碼會再次接回來電者。新增此轉接號碼（請參閱
[新增轉接號碼](/zh-Hant/guides/contact-centers/overview)）：

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

請參閱[查詢已交接的通話](/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 的回應。
