---
title: "Prijunkite iš Zoom Contact Center"
description: "Nukreipkite Zoom Contact Center skambučius į ThunderPhone agentą naudodami trečiosios šalies balso boto jungtį ir grąžinkite juos žmogaus agentui naudodami SIP REFER."
---

„Bot“ valdiklis jūsų Zoom kontaktų centro sraute perduoda skambinantį asmenį agentui su
Zoom skambučio SID. Kai skambinančiajam reikia žmogaus pagalbos, agentas siunčia SIP `REFER`
į Zoom žmogaus konsultanto adresą, o jūsų srautas gauna perdavimą pagal skambučio SID.

## Prieš pradėdami

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- Zoom Marketplace **bendroji programėlė**, administruojama jūsų administratoriaus ir prieinama
  kontaktų centrui, su „Bot“ valdiklio jungtimi
  ([Zoom trečiųjų šalių balso roboto vadovas](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP magistralė iš Zoom į balso roboto paslaugų teikėją. Zoom ISV komanda ją kuria
  etapais (poreikių analizė, testavimo magistralė, tada produkcinė magistralė), o programėlės
  įmonės pavadinimas turi tiksliai sutapti su magistralės įrašu. Ši sąranka pradedama su ThunderPhone
  palaikymo komanda ir Zoom, ne vien jūsų Zoom paskyroje.

## 1. Sukurkite SIP galinį tašką

Zoom jungtis surenka 15 skaitmenų numerį, prasidedantį `999`, o ne SIP
adresą. Išsaugojus jungtį sugeneruojamas šis numeris. Zoom magistralė naudoja TLS 1.2
5061 prievade su SRTP garsui, o prieiga ribojama pagal Zoom potinklius, o ne slaptažodžiu.
Todėl sukurkite `ip_allowlist` galinį tašką su jungties numeriu kaip įeinamuoju numeriu ir
privalomu SRTP (žr.
[Platformos, kurios surenka telefono numerį](/lt/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`: Zoom SIP signalizavimo potinkliai, gauti iš Zoom. Kiekvienas turi
  būti viešas `/16` arba siauresnis IPv4 diapazonas (IPv6 `/48` arba siauresnis).
- `dial_in_numbers`: jungties numeris tiksliai toks, kokį siunčia Zoom, be
  `+`.
- `srtp`: `required`, nes Zoom magistralė visada naudoja SRTP.

Zoom adresai bendri visiems jo klientams, todėl bet kuris kitas Zoom klientas,
surinkęs numerį, pasieks jūsų agentą. Zoom priskiria numerį; neskelbkite
jo.

## 2. Siųskite skambučius su kontekstu

Pridėkite **Bot** valdiklį prie savo srauto ir susiekite jį su jungtimi. Paprašykite Zoom ISV
komandos nukreipti magistralę į `sip.thunderphone.com`, naudojant TLS 5061 prievade, su
jungties numeriu ir užklausos URI, ir `To` antraštėje. Galinis taškas
atmeta UDP, todėl įsitikinkite, kad magistralė negrįžta prie jo.

Zoom siunčia:

- `X-ZOOM-Call-Sid`, saugomą kaip skambučio `external_call_id`. Zoom duomenų
  susiejimo puslapyje jis nenurodomas; jį dokumentuoja kito DI paslaugų teikėjo Zoom integracija,
  todėl patikrinkite jį per pirmąjį bandomąjį skambutį.
- `X-ZOOM-DNIS`, skambinančiojo surinktą numerį, kaip `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, jungties statinį URL.

## 3. Susigrąžinkite skambutį

Agentas siunčia `REFER` į žmogaus konsultanto adresą Zoom SBC. Pridėkite šį
peradresavimo numerį (žr.
[Pridėkite peradresavimo numerį](/lt/guides/contact-centers/overview)),
nurodydami Zoom pateiktą SBC adresą:

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

Zoom vadove aprašomi du būdai, kaip botas perduoda kontekstą: `POST` į
jungties Static URL prieš `REFER` (įvykiai `voicebot_metadata` ir panašūs)
bei SIP antraštės, susietos dalyje **Įeinantys iš roboto**. ThunderPhone
nesiunčia duomenų į Static URL. Zoom vadove nenurodyta, ar jis nuskaito
susietas antraštes iš `REFER`; jei norite pabandyti, prie įrašo pridėkite
`headers`, pvz., `"X-Handoff-Id": "{{handoff_id}}"`, ir patikrinkite bandomuoju
skambučiu. Taip pat su Zoom patvirtinkite, kad jis priima `REFER` be
metaduomenų `POST` prieš jį.

Norėdami gauti perdavimą nepasikliaudami nė vienu iš šių būdų, po Bot
valdiklio nustatykite, kad srautas jo ieškotų naudodamas **HTTP užklausos** arba
**Scenarijaus** valdiklį:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ir po jo nurodykite skambučio sid.
- Antraštė `Authorization: Bearer sk_live_…`.
- Naudokite `handoff.summary` ir `handoff.intent`, kad nukreiptumėte skambinantįjį
  ir informuotumėte skambutį perimantį asmenį.

Zoom neskelbia išsamios laukų dokumentacijos šiems valdikliams, todėl savo
paskyroje patvirtinkite, kad valdiklis gali siųsti `Authorization` antraštę. Žr.
[Raskite perduotą skambutį](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Skambinkite numeriu, kuris nukreipia į Bot valdiklį, paprašykite agento sujungti
su žmogumi ir patikrinkite, ar skambinantysis pasiekia žmogaus konsultantą ir ar
valdiklis grąžina perdavimą. Tada atidarykite skambutį naudodami
`GET /v1/calls/{call_id}`: `sip_headers` turėtų nurodyti `x-zoom-call-sid`, o
`external_call_id` turėtų atitikti skambučio sid, kurį naudoja jūsų srautas.

## Ribojimai

- ThunderPhone nesiunčia duomenų į jungties Static URL, todėl Zoom gauna
  perdavimą per paiešką arba per susietas antraštes, jei jūsų bandymas rodo, kad
  Zoom jas nuskaito iš `REFER`.
- SIP magistralę kuria Zoom ISV komanda, todėl negalite jos patys sukonfigūruoti
  ar išbandyti.
