---
title: "Povezivanje iz Zoom Contact Centera"
description: "Usmjerite pozive iz Zoom Contact Centera glasovnom agentu ThunderPhone putem poveznikâ glasovnih botova trećih strana i vratite ih ljudskom agentu pomoću SIP REFER-a."
---

Widget **Bot** u Vašem Zoom Contact Center tijeku usmjerava pozivatelja agentu sa
Zoomovim SID-om poziva. Kada pozivatelj treba osobu, agent šalje SIP `REFER`
na Zoomovu adresu ljudskog agenta, a Vaš tijek dohvaća preusmjeravanje prema SID-u poziva.

## Prije početka

- ThunderPhone agent i organizacijski [API ključ](/hr/guides/api-keys).
- Zoom Marketplace **Opća aplikacija**, kojom upravlja Vaš administrator i koja je dostupna
  za Contact Center, s konektorom za widget Bot
  ([Zoomov vodič za glasovne botove trećih strana](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP trunk od Zooma do pružatelja bota. Zoomov ISV tim izrađuje ga u
  fazama (inicijalna analiza, testni trunk, zatim produkcija), a polje Naziv
  tvrtke aplikacije mora se točno podudarati sa zapisom trunka. Ovo postavljanje započinje uz podršku ThunderPhonea i Zooma, a ne samo na Vašem Zoom računu.

## 1. Izradite SIP krajnju točku

Zoomov konektor bira 15-znamenkasti broj koji počinje s `999`, a ne SIP
adresu. Spremanje konektora generira taj broj. Zoomov trunk koristi TLS 1.2
na priključku 5061 sa SRTP-om za zvuk te je na popisu dopuštenih prema Zoomovim podmrežama, a ne lozinkom. Stoga izradite krajnju točku `ip_allowlist` s brojem konektora kao brojem za pozivanje i obaveznim SRTP-om (pogledajte
[Platforme koje biraju telefonski broj](/hr/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`: Zoomove SIP signalizacijske podmreže, koje dobivate od Zooma. Svaka mora
  biti javni IPv4 raspon `/16` ili uži (IPv6 `/48` ili uži).
- `dial_in_numbers`: broj konektora točno onako kako ga Zoom šalje, bez
  znaka `+`.
- `srtp`: `required`, jer Zoomov trunk uvijek koristi SRTP.

Zoomove adrese dijele svi njegovi korisnici, pa svaki drugi Zoomov korisnik
koji bira taj broj dolazi do Vašeg agenta. Zoom dodjeljuje broj; nemojte ga
objavljivati.

## 2. Šaljite pozive s kontekstom

Dodajte widget **Bot** u svoj tijek i povežite ga s konektorom. Zatražite od Zoomova ISV
tima da trunk usmjeri na `sip.thunderphone.com`, uz TLS na priključku 5061, s brojem
konektora u URI-ju zahtjeva i zaglavlju `To`. Krajnja točka
odbija UDP, stoga provjerite da trunk ne prijeđe na njega.

Zoom šalje:

- `X-ZOOM-Call-Sid`, pohranjen kao `external_call_id` poziva. Zoomova vlastita stranica
  za mapiranje podataka ne navodi ga; dokumentira ga Zoomova integracija drugog pružatelja AI-ja,
  stoga ga provjerite pri prvom testnom pozivu.
- `X-ZOOM-DNIS`, broj koji je pozivatelj birao, kao `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, statični URL konektora.

## 3. Preuzmite poziv natrag

Agent šalje `REFER` na adresu ljudskog agenta na Zoomovu SBC-u. Dodajte ovaj
broj za preusmjeravanje (pogledajte
[Dodajte broj za preusmjeravanje](/hr/guides/contact-centers/overview)),
s adresom SBC-a koju vam Zoom navede:

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

Zoomov vodič opisuje dva načina na koja bot prenosi kontekst: `POST` na
statički URL konektora prije `REFER` zahtjeva (`voicebot_metadata` i slični
događaji) te SIP zaglavlja mapirana u odjeljku **Dolazno od bota**. ThunderPhone
ne šalje podatke na statički URL. Zoomov vodič ne navodi čita li mapirana
zaglavlja iz `REFER` zahtjeva; ako želite pokušati, dodajte `headers` poput
`"X-Handoff-Id": "{{handoff_id}}"` u unos i provjerite to testnim pozivom. Također
potvrdite sa Zoomom da prihvaća `REFER` bez `POST` zahtjeva s metapodacima prije
njega.

Da biste dobili predaju bez oslanjanja na bilo koji od tih načina, postavite da
je vaš tok dohvaća nakon widgeta Bot pomoću widgeta **HTTP poziv** ili
**Skripta**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nakon kojeg slijedi SID poziva.
- Zaglavlje `Authorization: Bearer sk_live_…`.
- Upotrijebite `handoff.summary` i `handoff.intent` za usmjeravanje pozivatelja
  i informiranje osobe koja preuzima poziv.

Zoom ne objavljuje dokumentaciju na razini polja za ove widgete, stoga u svom
računu potvrdite da widget može poslati zaglavlje `Authorization`. Pogledajte
[Dohvat predanog poziva](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite broj koji vodi do widgeta Bot, zatražite od agenta razgovor s osobom i
provjerite dolazi li pozivatelj do ljudskog agenta te vraća li widget predaju.
Zatim otvorite poziv pomoću `GET /v1/calls/{call_id}`: `sip_headers` bi trebao
navesti `x-zoom-call-sid`, a `external_call_id` trebao bi odgovarati SID-u
poziva koji vaš tok upotrebljava.

## Ograničenja

- ThunderPhone ne šalje podatke na statički URL konektora, pa Zoom predaju dobiva
  putem dohvata ili putem mapiranih zaglavlja ako vaš test pokaže da ih Zoom čita
  iz `REFER` zahtjeva.
- Trunk izrađuje Zoomov ISV tim, stoga ga ne možete samostalno postaviti ni
  testirati.
