---
title: "Savienošana no Zoom Contact Center"
description: "Nosūtiet Zoom Contact Center zvanus uz ThunderPhone balss aģentu, izmantojot trešās puses balss robota savienotāju, un ar SIP REFER pārsūtiet tos atpakaļ cilvēka aģentam."
---

Bot logrīks jūsu Zoom Contact Center plūsmā nosūta zvanītāju uz balss aģentu ar
Zoom zvana SID. Kad zvanītājam nepieciešams cilvēks, balss aģents nosūta SIP `REFER`
uz Zoom cilvēka aģenta adresi, un jūsu plūsma izgūst pāradresēšanu pēc zvana SID.

## Pirms darba sākšanas

- ThunderPhone aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Zoom Marketplace **Vispārīgā lietotne**, ko pārvalda jūsu administrators un kas ir pieejama
  Contact Center, ar Bot logrīka savienotāju
  ([Zoom trešās puses balss bota ceļvedis](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP maģistrāle no Zoom uz bota pakalpojumu sniedzēju. Zoom ISV komanda to izveido
  posmos (izpēte, testēšanas maģistrāle un pēc tam ražošana), un lietotnes
  uzņēmuma nosaukumam ir precīzi jāsakrīt ar maģistrāles ierakstu. Šo iestatīšanu sāciet kopā ar ThunderPhone
  atbalsta komandu un Zoom, nevis tikai savā Zoom kontā.

## 1. Izveidojiet SIP galapunktu

Zoom savienotājs zvana uz 15 ciparu numuru, kas sākas ar `999`, nevis uz SIP
adresi. Saglabājot savienotāju, tiek ģenerēts šis numurs. Zoom maģistrāle izmanto TLS 1.2
portā 5061 ar SRTP audio datiem, un Zoom apakštīkliem tiek piešķirta atļauja, nevis izmantota parole. Tāpēc izveidojiet `ip_allowlist` galapunktu ar savienotāja
numuru kā iezvanes numuru un obligātu SRTP (skatiet
[Platformas, kas zvana uz tālruņa numuru](/lv/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 signalizācijas apakštīkli, ko nodrošina Zoom. Katram jābūt
  publiskam IPv4 diapazonam `/16` vai šaurākam (IPv6 `/48` vai šaurākam).
- `dial_in_numbers`: savienotāja numurs tieši tādā formā, kādā Zoom to nosūta, bez
  `+`.
- `srtp`: `required`, jo Zoom maģistrāle vienmēr izmanto SRTP.

Zoom adreses ir kopīgas visiem tā klientiem, tāpēc jebkurš cits Zoom klients,
kurš zvana uz šo numuru, sasniedz jūsu balss aģentu. Zoom piešķir numuru; nepublicējiet to.

## 2. Nosūtiet zvanus ar kontekstu

Pievienojiet savai plūsmai **Bot** logrīku un piesaistiet to savienotājam. Lūdziet Zoom ISV
komandai norādīt maģistrāli uz `sip.thunderphone.com`, izmantojot TLS portā 5061, ar
savienotāja numuru gan pieprasījuma URI, gan `To` galvenē. Galapunkts
noraida UDP, tāpēc pārliecinieties, ka maģistrāle uz to nepārslēdzas.

Zoom nosūta:

- `X-ZOOM-Call-Sid`, kas tiek saglabāts kā zvana `external_call_id`. Zoom datu
  kartēšanas lapā tas nav norādīts; to dokumentē cita AI pakalpojumu sniedzēja Zoom integrācija,
  tāpēc pārbaudiet to pirmajā testa zvanā.
- `X-ZOOM-DNIS`, numuru, uz kuru zvanītājs zvanīja, kā `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, savienotāja statisko URL.

## 3. Saņemiet zvanu atpakaļ

Aģents nosūta `REFER` uz cilvēka aģenta adresi Zoom SBC. Pievienojiet šo
pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)),
norādot Zoom sniegto SBC adresi:

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

Zoom ceļvedī ir aprakstīti divi veidi, kā bots nodod kontekstu: `POST` uz
savienotāja statisko URL pirms `REFER` (notikumi `voicebot_metadata` un līdzīgi),
kā arī SIP galvenes, kas kartētas sadaļā **Ienākošie no bota**. ThunderPhone
nesūta datus uz statisko URL. Zoom ceļvedī nav norādīts, vai tas nolasa
kartētās galvenes no `REFER`; ja vēlaties to izmēģināt, pievienojiet ierakstam
`headers`, piemēram, `"X-Handoff-Id": "{{handoff_id}}"`, un pārbaudiet testa zvanā. Tāpat
apstipriniet ar Zoom, ka tas pieņem `REFER` bez metadatu `POST` pirms tā.

Lai iegūtu pārsūtīšanas datus, nepaļaujoties ne uz vienu no šiem veidiem,
meklējiet tos savā plūsmā pēc Bot logrīka, izmantojot **HTTP izsaukuma** vai
**Skripta** logrīku:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  un pēc tam zvana sid.
- Galvene `Authorization: Bearer sk_live_…`.
- Izmantojiet `handoff.summary` un `handoff.intent`, lai novirzītu zvanītāju un
  sniegtu informāciju personai, kas pieņem zvanu.

Zoom nepublicē šo logrīku lauku līmeņa dokumentāciju, tāpēc savā kontā
apstipriniet, ka logrīks var nosūtīt `Authorization` galveni. Skatiet
[Uzmeklējiet pārsūtītu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet to

Zvaniet uz numuru, kas novirza uz Bot logrīku, lūdziet balss aģentam savienot ar
cilvēku un pārbaudiet, vai zvanītājs sasniedz cilvēka aģentu un logrīks atgriež
pārsūtīšanas datus. Pēc tam atveriet zvanu ar `GET /v1/calls/{call_id}`:
`sip_headers` jānorāda `x-zoom-call-sid`, un `external_call_id` jāatbilst zvana
sid, ko izmanto jūsu plūsma.

## Ierobežojumi

- ThunderPhone nesūta datus uz savienotāja statisko URL, tāpēc Zoom saņem
  pārsūtīšanas datus, izmantojot uzmeklēšanu vai kartētās galvenes, ja jūsu tests
  parāda, ka Zoom tās nolasa no `REFER`.
- Maģistrāli izveido Zoom ISV komanda, tāpēc jūs to nevarat iestatīt vai
  pārbaudīt patstāvīgi.
