---
title: "Pripojenie zo služby Zoom Contact Center"
description: "Presmerujte hovory zo služby Zoom Contact Center na agenta ThunderPhone pomocou konektora hlasového bota tretej strany a vráťte ich späť ľudskému agentovi pomocou SIP REFER."
---

Widget Bot vo vašom toku Zoom Contact Center odošle volajúceho agentovi s
identifikátorom hovoru Zoom. Keď volajúci potrebuje človeka, agent odošle SIP `REFER`
na adresu ľudského agenta Zoom a váš tok načíta presmerovanie podľa identifikátora hovoru.

## Pred začatím

- Agent ThunderPhone a organizačný [kľúč API](/sk/guides/api-keys).
- **Všeobecná aplikácia** Zoom Marketplace spravovaná vaším administrátorom a sprístupnená
  pre Contact Center s konektorom pre widget Bot
  ([príručka Zoom pre hlasové boty tretích strán](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP trunk zo Zoom k poskytovateľovi bota. Tím ISV Zoom ho vytvára
  postupne (zistenie požiadaviek, testovací trunk, potom produkcia) a názov spoločnosti aplikácie
  musí presne zodpovedať záznamu trunku. Toto nastavenie začína s podporou ThunderPhone
  a Zoom, nie iba vo vašom účte Zoom.

## 1. Vytvorte koncový bod SIP

Konektor Zoom vytáča 15-miestne číslo začínajúce na `999`, nie SIP
adresu. Uložením konektora sa toto číslo vygeneruje. Trunk Zoom používa TLS 1.2
na porte 5061 so SRTP pre zvuk a je povolený podľa podsietí Zoom namiesto
hesla. Preto vytvorte koncový bod `ip_allowlist` s číslom konektora
ako číslom na vytáčanie a s vyžadovaným SRTP (pozrite si
[Platformy, ktoré vytáčajú telefónne číslo](/sk/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`: podsiete SIP signalizácie Zoom získané od Zoom. Každá musí
  byť verejný rozsah IPv4 s maskou `/16` alebo užšou (IPv6 `/48` alebo užšou).
- `dial_in_numbers`: číslo konektora presne v podobe, v akej ho odosiela Zoom, bez
  `+`.
- `srtp`: `required`, pretože trunk Zoom vždy používa SRTP.

Adresy Zoom sú zdieľané všetkými jeho zákazníkmi, takže akýkoľvek iný zákazník Zoom,
ktorý vytočí toto číslo, sa spojí s vaším agentom. Číslo prideľuje Zoom; nezverejňujte
ho.

## 2. Odosielajte hovory s kontextom

Pridajte do svojho toku widget **Bot** a priraďte ho ku konektoru. Požiadajte tím ISV
Zoom, aby trunk nasmeroval na `sip.thunderphone.com`, s TLS na porte 5061 a s
číslom konektora v identifikátore URI požiadavky aj v hlavičke `To`. Koncový bod
odmieta UDP, preto sa uistite, že sa naň trunk neprepne späť.

Zoom odosiela:

- `X-ZOOM-Call-Sid`, uložený ako `external_call_id` hovoru. Vlastná stránka Zoom
  na mapovanie údajov ho neuvádza; dokumentácia integrácie Zoom iného poskytovateľa AI
  ho uvádza, preto ho skontrolujte pri prvom testovacom hovore.
- `X-ZOOM-DNIS`, číslo vytočené volajúcim, ako `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, statickú URL konektora.

## 3. Získanie hovoru späť

Hlasový agent odošle `REFER` na adresu pracovníka v SBC Zoomu. Pridajte toto
číslo na presmerovanie (pozrite si
[Pridanie čísla na presmerovanie](/sk/guides/contact-centers/overview))
s adresou SBC, ktorú vám poskytne Zoom:

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

Príručka Zoomu opisuje dva spôsoby, ako bot odovzdáva kontext: požiadavku
`POST` na statickú adresu URL konektora pred `REFER` (udalosti
`voicebot_metadata` a podobné) a hlavičky SIP namapované v časti **Prichádzajúce od bota**. ThunderPhone
neodosiela požiadavky na statickú adresu URL. Príručka Zoomu neuvádza, či číta
namapované hlavičky z `REFER`; ak to chcete vyskúšať, pridajte do záznamu
`headers`, napríklad `"X-Handoff-Id": "{{handoff_id}}"`, a overte to pri testovacom hovore. Tiež
si u Zoomu potvrďte, že prijíma `REFER` bez predchádzajúcej požiadavky `POST`
s metadátami.

Ak chcete získať odovzdanie bez spoliehania sa na ktorýkoľvek z týchto spôsobov,
nechajte svoj tok vyhľadať údaje po miniaplikácii Bot pomocou miniaplikácie
**Volanie HTTP** alebo **Skript**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nasledované sid hovoru.
- Hlavička `Authorization: Bearer sk_live_…`.
- Použite `handoff.summary` a `handoff.intent` na smerovanie volajúceho a stručné
  oboznámenie osoby, ktorá hovor prevezme.

Zoom nezverejňuje dokumentáciu na úrovni polí pre tieto miniaplikácie, preto si
vo svojom účte overte, že miniaplikácia môže odosielať hlavičku `Authorization`.
Pozrite si
[Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte ho

Zavolajte na číslo, ktoré vedie do miniaplikácie Bot, požiadajte hlasového agenta
o spojenie s pracovníkom a overte, že sa volajúci dovolá pracovníkovi kontaktného
centra a miniaplikácia vráti údaje o odovzdaní. Potom otvorte hovor pomocou
`GET /v1/calls/{call_id}`: `sip_headers` by mali obsahovať
`x-zoom-call-sid` a `external_call_id` by sa malo zhodovať so sid hovoru, ktoré
používa váš tok.

## Obmedzenia

- ThunderPhone neodosiela požiadavky na statickú adresu URL konektora, preto Zoom
  získa údaje o odovzdaní prostredníctvom vyhľadania alebo cez namapované hlavičky,
  ak váš test ukáže, že ich Zoom číta z `REFER`.
- Trunk vytvára tím ISV Zoomu, takže ho nemôžete sami nastaviť ani otestovať.
