---
title: "Hubungkan dari Zoom Contact Center"
description: "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](/id/guides/api-keys) organisasi.
- **Aplikasi Umum** Zoom Marketplace, dikelola oleh admin Anda dan disediakan untuk Contact Center, dengan konektor untuk widget Bot
  ([panduan voicebot pihak ketiga Zoom](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- 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](/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": "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](/id/guides/contact-centers/overview)),
dengan alamat SBC yang diberikan Zoom kepada Anda:

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
