Open in
NICE CXone から接続
Studio スクリプトから ContactID を SIP ヘッダーに含めて NICE CXone の通話を ThunderPhone エージェントに送信し、スクリプトの続行時にエージェントの引き継ぎを参照します。
CXone Studio スクリプトは、連絡先 ID とその他のコンテキストを含む SIP ヘッダーを付けてエージェントに通話を発信します。エージェントが完了すると通話を終了し、スクリプト内の REST API アクションがハンドオフを取得します。
開始前の準備
- ThunderPhone エージェントと組織の API キー。
- カスタムヘッダーを受け入れる CXone SIP トランクグループ。CXone がヘッダーを送信する前に、NICE アカウント担当者がこの設定を有効にする必要があります。
1. SIP エンドポイントを作成する
Placecall は SIP アドレスではなく、CXone トランクグループ経由で電話番号に発信します。
NICE はその SIP 認証情報を文書化しておらず、別の AI プロバイダーの CXone 統合では IP 許可リストを使用する TLS が使われています。そのため、スクリプトが発信する番号を着信番号として指定し、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 の前に次を設定します。
- ヘッダー
X-Call-IDと値ContactIDを指定した Sipputheader アクションを追加します。CXone は独自の call-id ヘッダーを送信しないため、ThunderPhone はこの値を通話のexternal_call_idとして保存します。 - エージェントが把握すべき他の値ごとに 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 ヘッダーを読み取るため、エージェントが通話を返します。エージェントは別れの挨拶をして通話を終了し、スクリプトが再び発信者を引き取ります。次の転送番号を追加します(転送番号を追加するを参照)。
{"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 です。