---
title: "Unganisha kutoka Zoom Contact Center"
description: "Tuma simu za Zoom Contact Center kwa ejenti wa ThunderPhone ukitumia kiunganishi cha voicebot cha wahusika wengine, kisha zirudishe kwa ejenti wa kibinadamu kwa SIP REFER."
---

Wijeti ya Bot katika mtiririko wako wa Zoom Contact Center humtuma mpigaji kwa ejenti pamoja na sid ya simu ya Zoom. Mpigaji anapohitaji mtu, ejenti hutuma SIP `REFER` kwa anwani ya mwakilishi wa kibinadamu wa Zoom, na mtiririko wako hupata uhamishaji kwa sid ya simu.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- **General App** ya Zoom Marketplace, inayosimamiwa na msimamizi wako na kupatikana kwa Contact Center, yenye kiunganishi cha wijeti ya Bot
  ([mwongozo wa Zoom wa voicebot wa wahusika wengine](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP trunk kutoka Zoom kwenda kwa mtoa huduma wa bot. Timu ya ISV ya Zoom huiunda kwa
  hatua (ugunduzi, trunk ya majaribio, kisha uzalishaji), na Jina la Kampuni la programu
  lazima lilingane kabisa na rekodi ya trunk. Usanidi huu huanza na usaidizi wa ThunderPhone
  na Zoom, si katika akaunti yako ya Zoom pekee.

## 1. Unda endpoint ya SIP

Kiunganishi cha Zoom hupiga nambari ya tarakimu 15 inayoanza na `999`, si anwani ya SIP. Kuhifadhi kiunganishi hutengeneza nambari hiyo. Trunk ya Zoom hutumia TLS 1.2 kwenye porti 5061 pamoja na SRTP kwa sauti, na huruhusiwa kupitia orodha kwa mitandao midogo ya Zoom badala ya nenosiri. Kwa hiyo unda endpoint ya `ip_allowlist` yenye nambari ya kiunganishi kama nambari ya kupiga na SRTP inayohitajika (tazama
[Majukwaa yanayopiga nambari ya simu](/sw/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`: mitandao midogo ya uashiriaji ya SIP ya Zoom, inayotolewa na Zoom. Kila moja lazima
  iwe safu ya IPv4 ya umma ya `/16` au nyembamba zaidi (IPv6 `/48` au nyembamba zaidi).
- `dial_in_numbers`: nambari ya kiunganishi hasa jinsi Zoom inavyoituma, bila
  `+`.
- `srtp`: `required`, kwa kuwa trunk ya Zoom hutumia SRTP kila wakati.

Anwani za Zoom hutumiwa kwa pamoja na wateja wake wote, kwa hiyo mteja mwingine yeyote wa Zoom
anayepiga nambari hiyo humfikia ejenti wako. Zoom huweka nambari hiyo; usiichapishe.

## 2. Tuma simu pamoja na muktadha

Ongeza wijeti ya **Bot** kwenye mtiririko wako na uiunganishe na kiunganishi. Iombe timu ya ISV ya Zoom
ielekeze trunk kwenye `sip.thunderphone.com`, TLS kwenye porti 5061, pamoja na
nambari ya kiunganishi katika URI ya ombi na kichwa cha `To`. Endpoint inakataa UDP, kwa hiyo hakikisha trunk hairudi kuitumia.

Zoom hutuma:

- `X-ZOOM-Call-Sid`, inayohifadhiwa kama `external_call_id` ya simu. Ukurasa wa Zoom wa upangaji wa data
  hauiorodheshi; muunganisho wa Zoom wa mtoa huduma mwingine wa AI unaieleza
  kwenye nyaraka, kwa hiyo iangalie kwenye simu yako ya kwanza ya majaribio.
- `X-ZOOM-DNIS`, nambari aliyopiga mpigaji, kama `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, URL Tuli ya kiunganishi.

## 3. Pokea simu iliyorejeshwa

Ejenti hutuma `REFER` kwa anwani ya ejenti wa kibinadamu kwenye SBC ya Zoom. Ongeza
nambari hii ya uhamisho (tazama
[Ongeza nambari ya uhamisho](/sw/guides/contact-centers/overview)),
kwa kutumia anwani ya SBC unayopewa na Zoom:

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

Mwongozo wa Zoom unaeleza njia mbili ambazo bot hupitisha muktadha: `POST` kwa
URL tuli ya kiunganishi kabla ya `REFER` (matukio ya `voicebot_metadata` na
yanayofanana), na vichwa vya SIP vilivyopangwa chini ya **Inayoingia kutoka kwa Bot**. ThunderPhone
haitumi POST kwa URL tuli. Mwongozo wa Zoom hauelezi ikiwa inasoma
vichwa vilivyopangwa kutoka kwa `REFER`; ikiwa unataka kujaribu, ongeza `headers` kama
vile `"X-Handoff-Id": "{{handoff_id}}"` kwenye ingizo na uangalie kwenye simu ya majaribio. Pia
thibitisha na Zoom kwamba inakubali `REFER` isiyo na `POST` ya metadata kabla yake.

Ili kupata uhamisho bila kutegemea mojawapo ya njia hizo, fanya mtiririko wako
uutafute baada ya wijeti ya Bot, kwa wijeti ya **Simu ya HTTP** au **Hati**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ikifuatiwa na SID ya simu.
- Kichwa `Authorization: Bearer sk_live_…`.
- Tumia `handoff.summary` na `handoff.intent` kumwelekeza mpigaji simu na kumpa
  muhtasari mtu anayepokea simu.

Zoom haichapishi hati za kila sehemu za wijeti hizi, kwa hivyo thibitisha kwenye
akaunti yako kwamba wijeti inaweza kutuma kichwa cha `Authorization`. Tazama
[Tafuta simu iliyohamishwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga nambari inayofikia wijeti ya Bot, mwombe ejenti akuhamishe kwa mtu, na hakikisha
kwamba mpigaji simu anamfikia ejenti wa kibinadamu na wijeti inarejesha uhamisho. Kisha
fungua simu kwa `GET /v1/calls/{call_id}`: `sip_headers` inapaswa kuorodhesha
`x-zoom-call-sid`, na `external_call_id` inapaswa kulingana na SID ya simu inayotumiwa na mtiririko wako.

## Vikomo

- ThunderPhone haitumi POST kwa URL tuli ya kiunganishi, kwa hivyo Zoom hupata
  uhamisho kupitia utafutaji, au kupitia vichwa vilivyopangwa ikiwa jaribio lako linaonyesha
  kwamba Zoom huvvisoma kutoka kwa `REFER`.
- Tranki imeundwa na timu ya ISV ya Zoom, kwa hivyo huwezi kuisanidi au kuijaribu
  mwenyewe.
