Open in
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/16atau lebih sempit (IPv6/48atau 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 sebagaiexternal_call_idpanggilan. 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.summarydanhandoff.intentuntuk 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.