---
title: "NICE CXone から接続"
description: "Studio スクリプトから ContactID を SIP ヘッダーに含めて NICE CXone の通話を ThunderPhone エージェントに送信し、スクリプトの続行時にエージェントの引き継ぎを参照します。"
---

CXone Studio スクリプトは、連絡先 ID とその他のコンテキストを含む SIP ヘッダーを付けてエージェントに通話を発信します。エージェントが完了すると通話を終了し、スクリプト内の REST API アクションがハンドオフを取得します。

## 開始前の準備

- ThunderPhone エージェントと組織の [API キー](/ja/guides/api-keys)。
- カスタムヘッダーを受け入れる CXone SIP トランクグループ。CXone がヘッダーを送信する前に、NICE アカウント担当者がこの設定を有効にする必要があります。

## 1. SIP エンドポイントを作成する

Placecall は SIP アドレスではなく、CXone トランクグループ経由で電話番号に発信します。
NICE はその SIP 認証情報を文書化しておらず、別の AI プロバイダーの CXone 統合では IP 許可リストを使用する TLS が使われています。そのため、スクリプトが発信する番号を着信番号として指定し、`ip_allowlist`
エンドポイントを作成します（[電話番号に発信するプラットフォーム](/ja/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. ヘッダー `X-Call-ID` と値 `ContactID` を指定した **Sipputheader** アクションを追加します。CXone は独自の call-id ヘッダーを送信しないため、ThunderPhone はこの値を通話の `external_call_id` として保存します。
2. エージェントが把握すべき他の値ごとに **Sipputheader** アクションを追加します。たとえば、`X-Skill` を `support` に設定します。この値はプロンプト内で `{{sip_x_skill}}` として使用できます。Sipputheader は `User-to-User`、任意の `X-` ヘッダー、および大半の `P-` ヘッダーを受け付けます。NICE は 256 文字以下の値を推奨しています。

次に、その番号へ **Placecall** を実行します。番号がリクエスト URI と `To`
ヘッダーの両方に含まれた状態で `sip.thunderphone.com` に送信するトランクグループを使用してください。エンドポイントは TLS（ポート 5061）または TCP（ポート 5060）を受け付け、UDP は拒否します。NICE はトランクのトランスポートを文書化していないため、UDP ではないことを確認してください。

## 3. 通話を戻す

CXone は `INVITE` とその最終応答でのみ SIP ヘッダーを読み取るため、エージェントが通話を返します。エージェントは別れの挨拶をして通話を終了し、スクリプトが再び発信者を引き取ります。次の転送番号を追加します（[転送番号を追加する](/ja/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 です。
