---
title: "Ühenda Zoom Contact Centerist"
description: "Suunake Zoom Contact Centeri kõned kolmanda osapoole häälroboti konnektori abil ThunderPhone'i agendile ja võtke need SIP REFERi abil tagasi inimagendile."
---

Zoom Contact Centeri voo Boti vidin saadab helistaja agendile koos Zoomi kõne SID-ga. Kui helistaja vajab inimest, saadab agent Zoomi inimagendi aadressile SIP-i `REFER`-i ning sinu voog hangib üleandmise kõne SID järgi.

## Enne alustamist

- ThunderPhone'i agent ja organisatsiooni [API-võti](/et/guides/api-keys).
- Zoom Marketplace'i **üldrakendus**, mida haldab sinu administraator ja mis on Contact Centerile kättesaadavaks tehtud, koos Boti vidina konnektoriga
  ([Zoomi kolmanda osapoole häälboti juhend](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Zoomist botiteenuse pakkujani ulatuv SIP-trunk. Zoomi ISV-tiim loob selle
  etappide kaupa (vajaduste kaardistamine, testimistrunk ja seejärel tootmine) ning rakenduse ettevõtte nimi
  peab trunk'i kirjele täpselt vastama. Seda seadistust alustatakse ThunderPhone'i
  toe ja Zoomiga, mitte ainult sinu Zoomi kontol.

## 1. Loo SIP-lõpp-punkt

Zoomi konnektor valib SIP-aadressi asemel 15-kohalise numbri, mis algab `999`-ga.
Konnektori salvestamine genereerib selle numbri. Zoomi trunk kasutab heliks TLS 1.2
pordil 5061 koos SRTP-ga ning sellele antakse juurdepääs Zoomi alamvõrkude, mitte parooli alusel. Seega loo `ip_allowlist`-lõpp-punkt, millel on konnektori
number sissehelistamisnumbrina ja nõutud SRTP (vt
[platvormid, mis valivad telefoninumbri](/et/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`: Zoomi SIP-signaalimise alamvõrgud, mille saad Zoomilt. Igaüks peab
  olema avalik IPv4-vahemik suurusega `/16` või kitsam (IPv6 puhul `/48` või kitsam).
- `dial_in_numbers`: konnektori number täpselt sellisel kujul, nagu Zoom selle saadab, ilma
  `+`-ita.
- `srtp`: `required`, kuna Zoomi trunk kasutab alati SRTP-d.

Zoomi aadressid on ühised kõigile selle klientidele, seega jõuab iga teine Zoomi klient,
kes sellele numbrile helistab, sinu agendini. Zoom määrab numbri; ära seda
avalda.

## 2. Saada kõned koos kontekstiga

Lisa oma voogu **Boti** vidin ja seo see konnektoriga. Palu Zoomi ISV-tiimil
suunata trunk aadressile `sip.thunderphone.com`, kasutades TLS-i pordil 5061 ning
konnektori numbrit nii päringu URI-s kui ka päises `To`. Lõpp-punkt keeldub UDP-st,
seega veendu, et trunk ei lähe sellele tagasi.

Zoom saadab:

- `X-ZOOM-Call-Sid`, mis salvestatakse kõne `external_call_id`-na. Zoomi enda andmete
  vastendamise lehel seda ei ole; seda dokumenteerib teise AI-pakkuja Zoomi integratsioon,
  seega kontrolli seda oma esimesel testkõnel.
- `X-ZOOM-DNIS`, helistaja valitud numbri, kujul `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, konnektori staatilise URL-i.

## 3. Saa kõne tagasi

Agent saadab Zoomi SBC-s oleva inimagendi aadressile `REFER`-i. Lisa see
edastusnumber (vt
[Lisa edastusnumber](/et/guides/contact-centers/overview)),
kasutades Zoomi antud SBC-aadressi:

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

Zoomi juhend kirjeldab kahte viisi, kuidas bot konteksti edastab: `POST`
konnektori staatilisele URL-ile enne `REFER`-i (`voicebot_metadata` ja
sarnased sündmused) ning SIP-päised, mis on vastendatud jaotises **Botilt
sissetulev**. ThunderPhone ei saada staatilisele URL-ile päringuid. Zoomi
juhend ei ütle, kas see loeb `REFER`-ist vastendatud päiseid; kui soovid seda
proovida, lisa kirjele `headers`, näiteks
`"X-Handoff-Id": "{{handoff_id}}"`, ja kontrolli seda testkõnega. Kinnita
Zoomiga ka, et see aktsepteerib `REFER`-i, millele ei eelne metaandmete `POST`.

Edastuse saamiseks ilma kummalegi neist tuginemata lase oma voolul see pärast
Boti vidinat otsida, kasutades vidinat **HTTP-kõne** või **Skript**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  millele järgneb kõne sid.
- Päis `Authorization: Bearer sk_live_…`.
- Kasuta `handoff.summary` ja `handoff.intent`, et suunata helistaja ning anda
  kõne vastuvõtjale lühike ülevaade.

Zoom ei avalda nende vidinate jaoks väljade tasemel dokumentatsiooni, seega
kontrolli oma kontol, kas vidin saab saata päist `Authorization`. Vt
[Otsi edastatud kõne üles](/api-reference/calls#look-up-a-handed-off-call).

## Testi seda

Helista numbrile, mis jõuab Boti vidinani, palu agendilt inimest ja kontrolli,
et helistaja jõuab inimagendini ning vidin tagastab edastuse. Seejärel ava kõne
päringuga `GET /v1/calls/{call_id}`: `sip_headers` peaks sisaldama
`x-zoom-call-sid` ning `external_call_id` peaks ühtima sid-ga, mida sinu voog
kasutab.

## Piirangud

- ThunderPhone ei saada konnektori staatilisele URL-ile päringuid, seega saab
  Zoom edastuse otsingu kaudu või vastendatud päiste kaudu, kui sinu test näitab,
  et Zoom loeb neid `REFER`-ist.
- Magistraali loob Zoomi ISV-meeskond, seega ei saa sa seda ise seadistada ega
  testida.