---
title: "Свързване от Zoom Contact Center"
description: "Насочвайте обаждания от Zoom Contact Center към агент на ThunderPhone чрез конектор за гласов бот на трета страна и ги връщайте към човешки агент чрез SIP REFER."
---

Приспособление „Бот“ във вашия поток на Zoom Contact Center изпраща обаждащия се към агента с идентификатора на обаждането от Zoom. Когато обаждащият се има нужда от човек, агентът изпраща SIP `REFER` към адреса на Zoom за човешки агент, а вашият поток извлича прехвърлянето по идентификатора на обаждането.

## Преди да започнете

- Агент на ThunderPhone и [API ключ](/bg/guides/api-keys) за организацията.
- **Общо приложение** в Zoom Marketplace, управлявано от вашия администратор и предоставено за Contact Center, с конектор за приспособлението „Бот“
  ([ръководството на Zoom за гласови ботове на трети страни](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP магистрала от Zoom към доставчика на бота. Екипът на Zoom за ISV я изгражда
  на етапи (проучване, тестова магистрала, след това продукционна среда), а полето „Име на компанията“ на приложението трябва да съвпада точно със записа за магистралата. Тази настройка започва с поддръжката на ThunderPhone и Zoom, а не само във вашия акаунт в Zoom.

## 1. Създайте SIP крайна точка

Конекторът на Zoom набира 15-цифрен номер, започващ с `999`, а не SIP
адрес. Записването на конектора генерира този номер. Магистралата на Zoom използва TLS 1.2
на порт 5061 със SRTP за аудио и е в списък с разрешени източници чрез подмрежите на Zoom, а не чрез парола. Затова създайте крайна точка `ip_allowlist` с номера на конектора като номер за набиране и със задължителен SRTP (вижте
[Платформи, които набират телефонен номер](/bg/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`: подмрежите за SIP сигнализация на Zoom, предоставени от Zoom. Всяка трябва
  да е публичен диапазон IPv4 с `/16` или по-тесен (IPv6 `/48` или по-тесен).
- `dial_in_numbers`: номерът на конектора точно както Zoom го изпраща, без
  `+`.
- `srtp`: `required`, тъй като магистралата на Zoom винаги използва SRTP.

Адресите на Zoom се споделят от всички негови клиенти, така че всеки друг клиент на Zoom,
който набере номера, достига до вашия агент. Zoom назначава номера; не го публикувайте.

## 2. Изпращайте обаждания с контекст

Добавете приспособление **Бот** към вашия поток и го свържете с конектора. Поискайте от екипа на Zoom за ISV
да насочи магистралата към `sip.thunderphone.com`, с TLS на порт 5061 и с
номера на конектора както в URI на заявката, така и в заглавката `To`. Крайната точка
отказва UDP, затова се уверете, че магистралата не преминава към него.

Zoom изпраща:

- `X-ZOOM-Call-Sid`, съхраняван като `external_call_id` на обаждането. Собствената страница на Zoom за съпоставяне на данни
  не го изброява; интеграцията с Zoom на друг доставчик на AI го документира,
  затова го проверете при първото си тестово обаждане.
- `X-ZOOM-DNIS`, номера, който обаждащият се е набрал, като `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, статичния URL на конектора.

## 3. Получете обратно обаждането

Агентът изпраща `REFER` до адреса на човешкия агент в SBC на Zoom. Добавете този
номер за прехвърляне (вижте
[Добавяне на номера за прехвърляне](/bg/guides/contact-centers/overview)),
с адреса на SBC, който Zoom ви предоставя:

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

Ръководството на Zoom описва два начина, по които бот предава контекст: `POST` към
статичния URL на конектора преди `REFER` (`voicebot_metadata` и подобни
събития), както и SIP заглавки, съпоставени под **Входящо от бот**. ThunderPhone
не изпраща данни към статичния URL. Ръководството на Zoom не уточнява дали чете
съпоставени заглавки от `REFER`; ако искате да опитате, добавете `headers`, като
`"X-Handoff-Id": "{{handoff_id}}"`, към записа и проверете с тестово обаждане. Също
потвърдете със Zoom, че приема `REFER` без `POST` с метаданни преди него.

За да получите прехвърлянето, без да разчитате на нито един от двата начина,
настройте потока си да го търси след уиджета Bot чрез уиджет **HTTP Call** или
**Script**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  последвано от SID на обаждането.
- Заглавка `Authorization: Bearer sk_live_…`.
- Използвайте `handoff.summary` и `handoff.intent`, за да насочите обаждащия се
  и да информирате човека, който приема обаждането.

Zoom не публикува документация на ниво поле за тези уиджети, затова потвърдете в
акаунта си, че уиджетът може да изпраща заглавка `Authorization`. Вижте
[Търсене на прехвърлено обаждане](/api-reference/calls#look-up-a-handed-off-call).

## Тествайте

Обадете се на номер, който достига до уиджета Bot, поискайте от агента човек и
проверете дали обаждащият се достига до човешки агент и уиджетът връща
прехвърлянето. След това отворете обаждането с `GET /v1/calls/{call_id}`:
`sip_headers` трябва да съдържа `x-zoom-call-sid`, а `external_call_id` трябва да
съответства на SID на обаждането, който използва вашият поток.

## Ограничения

- ThunderPhone не изпраща данни към статичния URL на конектора, така че Zoom
  получава прехвърлянето чрез търсенето или чрез съпоставени заглавки, ако тестът
  ви покаже, че Zoom ги чете от `REFER`.
- Трънкът се изгражда от екипа на Zoom за ISV, така че не можете да го настроите
  или тествате самостоятелно.
