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

Contact centers

Hubungkan dari Zoom Contact Center

Kirim panggilan Zoom Contact Center ke agen ThunderPhone dengan konektor voicebot pihak ketiga, lalu alihkan kembali ke agen manusia dengan SIP REFER.

Widget Bot dalam alur Zoom Contact Center Anda mengirim penelepon ke agen dengan sid panggilan Zoom. Saat penelepon membutuhkan seseorang, agen mengirim SIP REFER ke alamat agen manusia Zoom, dan alur Anda mengambil alih transfer berdasarkan sid panggilan.

Sebelum memulai

  • Agen ThunderPhone dan kunci API organisasi.
  • Aplikasi Umum Zoom Marketplace, dikelola oleh admin Anda dan disediakan untuk Contact Center, dengan konektor untuk widget Bot (panduan voicebot pihak ketiga Zoom).
  • Trunk SIP dari Zoom ke penyedia bot. Tim ISV Zoom membangunnya secara bertahap (penemuan, trunk staging, lalu produksi), dan Nama Perusahaan aplikasi harus sama persis dengan catatan trunk. Penyiapan ini dimulai dengan dukungan ThunderPhone dan Zoom, bukan hanya di akun Zoom Anda.

1. Buat endpoint SIP

Konektor Zoom menghubungi nomor 15 digit yang dimulai dengan 999, bukan alamat SIP. Menyimpan konektor akan menghasilkan nomor tersebut. Trunk Zoom menggunakan TLS 1.2 pada port 5061 dengan SRTP untuk audio, dan diizinkan berdasarkan subnet Zoom, bukan kata sandi. Jadi, buat endpoint ip_allowlist dengan nomor konektor sebagai nomor panggilan masuk dan SRTP diwajibkan (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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: subnet pensinyalan SIP Zoom, dari Zoom. Masing-masing harus berupa rentang IPv4 publik /16 atau lebih sempit (IPv6 /48 atau lebih sempit).
  • dial_in_numbers: nomor konektor persis seperti yang dikirimkan Zoom, tanpa +.
  • srtp: required, karena trunk Zoom selalu menggunakan SRTP.

Alamat Zoom digunakan bersama oleh semua pelanggannya, sehingga pelanggan Zoom lain yang menghubungi nomor tersebut akan mencapai agen Anda. Zoom menetapkan nomor tersebut; jangan publikasikan.

2. Kirim panggilan dengan konteks

Tambahkan widget Bot ke alur Anda dan tautkan ke konektor. Minta tim ISV Zoom untuk mengarahkan trunk ke sip.thunderphone.com, TLS pada port 5061, dengan nomor konektor di URI permintaan dan header To. Endpoint menolak UDP, jadi pastikan trunk tidak beralih kembali ke UDP.

Zoom mengirim:

  • X-ZOOM-Call-Sid, disimpan sebagai external_call_id panggilan. Halaman pemetaan data Zoom sendiri tidak mencantumkannya; integrasi Zoom dari penyedia AI lain mendokumentasikan hal tersebut, jadi periksa pada panggilan uji pertama Anda.
  • X-ZOOM-DNIS, nomor yang dihubungi penelepon, sebagai {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, URL Statis konektor.

3. Dapatkan kembali panggilan

Agen mengirim REFER ke alamat agen manusia di SBC Zoom. Tambahkan nomor transfer ini (lihat Tambahkan nomor transfer), dengan alamat SBC yang diberikan Zoom kepada Anda:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Panduan Zoom menjelaskan dua cara bot meneruskan konteks: POST ke Static URL konektor sebelum REFER (peristiwa voicebot_metadata dan serupa), serta header SIP yang dipetakan di bawah Masuk dari Bot. ThunderPhone tidak mengirim post ke Static URL. Panduan Zoom tidak menjelaskan apakah Zoom membaca header yang dipetakan dari REFER; jika Anda ingin mencoba, tambahkan headers seperti "X-Handoff-Id": "{{handoff_id}}" ke entri dan periksa pada panggilan uji. Konfirmasikan juga dengan Zoom bahwa Zoom menerima REFER tanpa metadata POST sebelumnya.

Untuk mendapatkan hand-off tanpa bergantung pada salah satunya, buat alur Anda mencarinya setelah widget Bot, dengan widget Panggilan HTTP atau Skrip:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= diikuti oleh sid panggilan.
  • Header Authorization: Bearer sk_live_….
  • Gunakan handoff.summary dan handoff.intent untuk mengarahkan penelepon dan memberi ringkasan kepada orang yang menerima panggilan.

Zoom tidak menerbitkan dokumentasi tingkat kolom untuk widget ini, jadi konfirmasikan di akun Anda bahwa widget dapat mengirim header Authorization. Lihat Cari panggilan yang telah di-hand-off.

Uji

Hubungi nomor yang mencapai widget Bot, minta agen untuk menghubungkan Anda ke seseorang, dan periksa bahwa penelepon mencapai agen manusia serta widget mengembalikan hand-off. Kemudian buka panggilan dengan GET /v1/calls/{call_id}: sip_headers harus mencantumkan x-zoom-call-sid, dan external_call_id harus sesuai dengan sid panggilan yang digunakan alur Anda.

Batasan

  • ThunderPhone tidak mengirim post ke Static URL konektor, sehingga Zoom mendapatkan hand-off melalui pencarian, atau melalui header yang dipetakan jika pengujian Anda menunjukkan bahwa Zoom membacanya dari REFER.
  • Trunk dibuat oleh tim ISV Zoom, sehingga Anda tidak dapat menyiapkannya atau mengujinya sendiri.