---
title: "Hubungkan dari NICE CXone"
description: "Kirim panggilan NICE CXone ke agen ThunderPhone dari skrip Studio dengan ContactID dalam header SIP, lalu cari hand-off agen saat skrip berlanjut."
---

Skrip CXone Studio Anda melakukan panggilan ke agen dengan header SIP yang membawa
ID kontak dan konteks lainnya. Ketika agen selesai, agen menutup panggilan, dan
aksi REST API dalam skrip mengambil serah-terima.

## Sebelum memulai

- Agen ThunderPhone dan [kunci API](/id/guides/api-keys) organisasi.
- Grup trunk SIP CXone yang menerima header kustom. Perwakilan akun NICE Anda
  harus mengaktifkan pengaturan ini sebelum CXone mengirimkannya.

## 1. Buat endpoint SIP

Placecall menghubungi nomor telepon melalui grup trunk CXone, bukan alamat SIP.
NICE tidak mendokumentasikan kredensial SIP untuknya, dan integrasi CXone dari
penyedia AI lain menggunakan TLS dengan daftar izin IP. Jadi, buat endpoint
`ip_allowlist` dengan nomor yang akan dihubungi skrip sebagai nomor dial-in
(lihat [Platform yang menghubungi nomor telepon](/id/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`: rentang pensinyalan SIP klaster CXone Anda, dari
  NICE. Masing-masing harus berupa rentang IPv4 publik `/16` atau lebih sempit
  (IPv6 `/48` atau lebih sempit).
- `dial_in_numbers`: nomor yang akan dihubungi Placecall, ditulis dengan cara
  CXone mengirimkannya. Nomor ini tidak harus merupakan nomor telepon asli.
  Nomor ini tidak boleh sudah digunakan di ThunderPhone, sebagai nomor telepon
  atau pada endpoint lain: hal tersebut mengembalikan `409`.

Alamat CXone digunakan bersama oleh semua pelanggannya, sehingga pelanggan
CXone lain yang menghubungi nomor tersebut akan mencapai agen Anda. Saat memilih
nomor, pilih nomor panjang yang tidak akan ditebak siapa pun (hingga 15 digit),
pastikan CXone mengirimkannya ke ThunderPhone alih-alih ke jaringan telepon,
dan jangan publikasikan nomor tersebut.

## 2. Kirim panggilan dengan konteks

Dalam skrip Studio Anda, sebelum **Placecall**:

1. Tambahkan aksi **Sipputheader** dengan header `X-Call-ID` dan nilai
   `ContactID`. CXone tidak mengirim header ID panggilannya sendiri;
   ThunderPhone menyimpan header ini sebagai `external_call_id` panggilan.
2. Tambahkan aksi **Sipputheader** untuk setiap nilai lain yang perlu diketahui
   agen, seperti `X-Skill` yang diatur ke `support`. Nilai ini mencapai Prompt
   sebagai `{{sip_x_skill}}`. Sipputheader menerima `User-to-User`, header
   `X-` apa pun, dan sebagian besar header `P-`; NICE merekomendasikan nilai
   256 karakter atau kurang.

Kemudian lakukan **Placecall** ke nomor tersebut, melalui grup trunk yang
mengirimkannya ke `sip.thunderphone.com` dengan nomor di URI permintaan dan
header `To`. Endpoint menerima TLS (port 5061) atau TCP (port 5060) dan menolak
UDP, serta NICE tidak mendokumentasikan transport trunk, jadi pastikan
transport tersebut bukan UDP.

## 3. Ambil kembali panggilan

CXone hanya membaca header SIP pada `INVITE` dan respons akhirnya, sehingga
agen mengembalikan panggilan: agen mengucapkan selamat tinggal dan menutup
panggilan, lalu skrip Anda mengambil kembali penelepon. Tambahkan nomor transfer
ini (lihat
[Tambahkan nomor transfer](/id/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE tidak mendokumentasikan bahwa skrip berlanjut setelah Placecall ketika
panggilan yang dilakukan berakhir. Integrasi CXone dari penyedia AI lain
sebaliknya memberi sinyal kepada skrip melalui Signal API CXone
(`POST /interactions/{contactId}/signal`) sebelum menutup panggilan;
ThunderPhone tidak memanggilnya. Konfirmasikan dengan NICE bagaimana skrip Anda
mengambil kembali penelepon, lalu ambil serah-terima dengan aksi **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  diikuti oleh `ContactID`.
- Header `Authorization: Bearer sk_live_…`.
- Baca `handoff.summary` dan `handoff.intent` dari respons untuk merutekan
  kontak.

Lihat [Cari panggilan yang telah diserahterimakan](/api-reference/calls#look-up-a-handed-off-call).

## Uji

Hubungi nomor yang menjalankan skrip, minta agen menghubungkan Anda ke seseorang, lalu periksa bahwa
skrip berlanjut dan tindakan REST API mengembalikan pengalihan. Jika panggilan
tidak pernah mencapai agen, periksa nomor yang dikirim CXone, bahwa alamat sumbernya
ada di `allowed_source_cidrs`, dan bahwa panggilan datang melalui TCP atau TLS. Kemudian buka
panggilan dengan `GET /v1/calls/{call_id}`: `sip_headers` harus mencantumkan `x-call-id`, dan
`external_call_id` harus sama dengan `ContactID`.

## Batasan

- CXone mengirim dan membaca header hanya pada `INVITE` dan `2xx` akhirnya, sehingga
  tidak ada apa pun pada `BYE` agen yang mencapai skrip.
- NICE tidak mendokumentasikan penerimaan `REFER` dari agen.
- Tindakan REST API kehabisan waktu setelah 10 detik secara default (maksimal di bawah 90 detik)
  dan membaca respons hingga 32 KB.
