ThunderPhone v3 kini tersedia.Gunakan langsung secara mandiri, mulai 2¢/menit.Baca pengumumannya

Contact centers

Hubungkan dari NICE CXone

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 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):

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):

{"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.

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.