---
title: "Conectați din Zoom Contact Center"
description: "Trimiteți apelurile Zoom Contact Center către un agent ThunderPhone cu un conector de voicebot terț și redirecționați-le înapoi către un agent uman cu un SIP REFER."
---

Un widget **Bot** din fluxul Zoom Contact Center trimite apelantul către agent cu
ID-ul apelului Zoom. Când apelantul are nevoie de o persoană, agentul trimite un SIP `REFER`
către adresa agentului uman din Zoom, iar fluxul dumneavoastră preia transferul după ID-ul apelului.

## Înainte de a începe

- Un agent ThunderPhone și o [cheie API](/ro/guides/api-keys) a organizației.
- O **aplicație generală** Zoom Marketplace, gestionată de administratorul dumneavoastră și pusă la dispoziția
  Contact Center, cu un conector pentru widgetul Bot
  ([ghidul Zoom pentru roboți vocali terți](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Un trunk SIP de la Zoom către furnizorul robotului. Echipa ISV Zoom îl construiește în
  etape (analiză, un trunk de test, apoi producție), iar câmpul Numele companiei al aplicației
  trebuie să corespundă exact înregistrării trunkului. Această configurare începe cu asistența
  ThunderPhone și Zoom, nu doar în contul dumneavoastră Zoom.

## 1. Creați endpointul SIP

Conectorul Zoom apelează un număr de 15 cifre care începe cu `999`, nu o adresă SIP.
Salvarea conectorului generează acel număr. Trunkul Zoom folosește TLS 1.2
pe portul 5061 cu SRTP pentru audio și este permis prin lista de adrese Zoom, nu printr-o parolă.
Prin urmare, creați un endpoint `ip_allowlist` cu numărul conectorului ca număr de apelare și cu SRTP obligatoriu (consultați
[Platforme care apelează un număr de telefon](/ro/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`: subrețelele de semnalizare SIP Zoom, furnizate de Zoom. Fiecare trebuie
  să fie un interval IPv4 public de `/16` sau mai restrâns (IPv6 `/48` sau mai restrâns).
- `dial_in_numbers`: numărul conectorului exact așa cum îl trimite Zoom, fără
  `+`.
- `srtp`: `required`, deoarece trunkul Zoom folosește întotdeauna SRTP.

Adresele Zoom sunt partajate de toți clienții săi, astfel încât orice alt client Zoom
care apelează numărul ajunge la agentul dumneavoastră. Zoom atribuie numărul; nu îl
publicați.

## 2. Trimiteți apeluri cu context

Adăugați un widget **Bot** în fluxul dumneavoastră și asociați-l cu conectorul. Cereți echipei ISV Zoom
să direcționeze trunkul către `sip.thunderphone.com`, prin TLS pe portul 5061, cu
numărul conectorului atât în URI-ul cererii, cât și în antetul `To`. Endpointul
respinge UDP, așa că asigurați-vă că trunkul nu revine la acesta.

Zoom trimite:

- `X-ZOOM-Call-Sid`, stocat ca `external_call_id` al apelului. Pagina proprie Zoom de
  mapare a datelor nu îl enumeră; integrarea Zoom a unui alt furnizor AI îl documentează,
  așa că verificați-l la primul apel de test.
- `X-ZOOM-DNIS`, numărul apelat de apelant, ca `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, URL-ul static al conectorului.

## 3. Primiți apelul înapoi

Agentul vocal trimite un `REFER` către adresa agentului uman de pe SBC-ul Zoom. Adăugați acest număr de transfer (consultați
[Adăugați numărul de transfer](/ro/guides/contact-centers/overview)),
cu adresa SBC furnizată de Zoom:

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

Ghidul Zoom descrie două modalități prin care un bot transmite contextul: un `POST` către
URL-ul static al conectorului înainte de `REFER` (evenimentele `voicebot_metadata` și
similare) și antete SIP mapate în **Intrare de la Bot**. ThunderPhone
nu trimite un POST către URL-ul static. Ghidul Zoom nu precizează dacă citește
antetele mapate dintr-un `REFER`; dacă doriți să încercați, adăugați `headers`, cum ar fi
`"X-Handoff-Id": "{{handoff_id}}"`, la intrare și verificați printr-un apel de test. De asemenea,
confirmați cu Zoom că acceptă un `REFER` fără un `POST` cu metadate înaintea acestuia.

Pentru a obține transferul fără a vă baza pe niciuna dintre acestea, configurați fluxul
să îl caute după widgetul Bot, cu un widget **Apel HTTP** sau **Script**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  urmat de SID-ul apelului.
- Antetul `Authorization: Bearer sk_live_…`.
- Utilizați `handoff.summary` și `handoff.intent` pentru a direcționa apelantul și a informa
  persoana care preia apelul.

Zoom nu publică documentație la nivel de câmp pentru aceste widgeturi, așadar confirmați în
contul dumneavoastră că widgetul poate trimite un antet `Authorization`. Consultați
[Consultați un apel transferat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Apelați un număr care ajunge la widgetul Bot, cereți agentului vocal să vorbească cu o persoană și verificați
că apelantul ajunge la un agent uman și că widgetul returnează transferul. Apoi
deschideți apelul cu `GET /v1/calls/{call_id}`: `sip_headers` ar trebui să includă
`x-zoom-call-sid`, iar `external_call_id` ar trebui să corespundă SID-ului apelului pe care îl
utilizează fluxul dumneavoastră.

## Limitări

- ThunderPhone nu trimite un POST către URL-ul static al conectorului, astfel încât Zoom primește
  transferul prin căutare sau prin antete mapate dacă testul dumneavoastră arată că
  Zoom le citește din `REFER`.
- Trunchiul este construit de echipa ISV a Zoom, așadar nu îl puteți configura sau testa
  pe cont propriu.
