---
title: "Povežite se iz Zoom Contact Center"
description: "Klice iz Zoom Contact Center usmerite k agentu ThunderPhone s priključkom za glasovnega robota drugega ponudnika, nato pa jih s SIP REFER vrnite človeškemu agentu."
---

Gradnik Bot v vašem toku Zoom Contact Center klicatelja z
Zoomovim ID-jem klica pošlje agentu. Ko klicatelj potrebuje osebo, agent v
Zoomov naslov človeškega agenta pošlje SIP `REFER`, vaš tok pa po ID-ju klica pridobi predajo.

## Preden začnete

- Agent ThunderPhone in [ključ API](/sl/guides/api-keys) organizacije.
- **Splošna aplikacija** Zoom Marketplace, ki jo upravlja vaš skrbnik in je na voljo
  za Contact Center, s povezovalnikom za gradnik Bot
  ([Zoomov vodnik za glasovne bote tretjih ponudnikov](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP-trunk iz Zooma do ponudnika bota. Zoomova ekipa ISV ga vzpostavi v
  fazah (odkrivanje, trunk za preizkusno okolje, nato produkcija), ime podjetja
  aplikacije pa se mora natančno ujemati z zapisom trunka. Ta nastavitev se začne s podporo ThunderPhone
  in Zoomom, ne samo v vašem računu Zoom.

## 1. Ustvarite končno točko SIP

Zoomov povezovalnik kliče 15-mestno številko, ki se začne z `999`, ne naslova SIP.
S shranitvijo povezovalnika se ustvari ta številka. Zoomov trunk uporablja TLS 1.2
na vratih 5061 s SRTP za zvok in je uvrščen na seznam dovoljenih po Zoomovih podomrežjih
namesto z geslom. Zato ustvarite končno točko `ip_allowlist` s številko
povezovalnika kot številko za dohodne klice in zahtevanim SRTP (glejte
[Platforme, ki kličejo telefonsko številko](/sl/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`: Zoomova podomrežja za signalizacijo SIP, ki jih zagotovi Zoom. Vsako mora
  biti javni obseg IPv4 `/16` ali ožji (IPv6 `/48` ali ožji).
- `dial_in_numbers`: številka povezovalnika točno tako, kot jo pošlje Zoom, brez
  `+`.
- `srtp`: `required`, ker Zoomov trunk vedno uporablja SRTP.

Zoomove naslove si delijo vse njegove stranke, zato vsak drug uporabnik Zooma,
ki pokliče številko, doseže vašega agenta. Številko dodeli Zoom; ne
objavljajte je.

## 2. Pošljite klice s kontekstom

V svoj tok dodajte gradnik **Bot** in ga povežite s povezovalnikom. Zoomovo ekipo ISV
prosite, naj trunk usmeri na `sip.thunderphone.com`, TLS na vratih 5061, s
številko povezovalnika v URI-ju zahteve in glavi `To`. Končna točka
zavrne UDP, zato poskrbite, da trunk ne preklopi nanj.

Zoom pošlje:

- `X-ZOOM-Call-Sid`, shranjen kot `external_call_id` klica. Zoomova lastna stran za
  preslikavo podatkov ga ne navaja; dokumentacija integracije Zoom drugega ponudnika umetne inteligence
  ga opisuje, zato ga preverite pri prvem preizkusnem klicu.
- `X-ZOOM-DNIS`, številko, ki jo je klicatelj poklical, kot `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, statični URL povezovalnika.

## 3. Prejmite klic nazaj

Agent pošlje `REFER` na naslov človeškega agenta v Zoomovem SBC-ju. Dodajte to
številko za preusmeritev (glejte
[Dodajte številko za preusmeritev](/sl/guides/contact-centers/overview))
z naslovom SBC-ja, ki vam ga posreduje Zoom:

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

Zoomov vodnik opisuje dva načina, kako bot posreduje kontekst: zahtevo `POST` na
statični URL povezovalnika pred `REFER` (dogodki `voicebot_metadata` in podobni)
ter glave SIP, preslikane pod **Dohodno od bota**. ThunderPhone ne pošilja
zahtev na statični URL. Zoomov vodnik ne navaja, ali bere preslikane glave iz
`REFER`; če želite to preizkusiti, v vnos dodajte `headers`, kot je
`"X-Handoff-Id": "{{handoff_id}}"`, in preverite s testnim klicem. Pri Zoomu
tudi potrdite, da sprejme `REFER` brez predhodne zahteve `POST` z metapodatki.

Če želite pridobiti predajo, ne da bi se zanašali na katero koli od teh možnosti,
jo po pripomočku Bot poiščite v svojem toku s pripomočkom **Klic HTTP** ali
**Skript**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ki mu sledi SID klica.
- Glava `Authorization: Bearer sk_live_…`.
- Za usmerjanje klicatelja in seznanitev osebe, ki prevzame klic, uporabite
  `handoff.summary` in `handoff.intent`.

Zoom ne objavlja dokumentacije za posamezna polja teh pripomočkov, zato v svojem
računu preverite, ali lahko pripomoček pošlje glavo `Authorization`. Glejte
[Iskanje predanega klica](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite številko, ki doseže pripomoček Bot, glasovnega agenta prosite za
človeškega agenta in preverite, da klicatelj doseže človeškega agenta ter da
pripomoček vrne podatke o predaji. Nato odprite klic z
`GET /v1/calls/{call_id}`: `sip_headers` mora vsebovati `x-zoom-call-sid`, vrednost
`external_call_id` pa se mora ujemati s SID-jem klica, ki ga uporablja vaš tok.

## Omejitve

- ThunderPhone ne pošilja zahtev na statični URL povezovalnika, zato Zoom
  prejme predajo prek iskanja ali prek preslikanih glav, če vaš preizkus pokaže,
  da jih Zoom bere iz `REFER`.
- Trunk izdela Zoomova ekipa ISV, zato ga ne morete nastaviti ali preizkusiti
  sami.
