---
title: "Подключение из Zoom Contact Center"
description: "Направляйте звонки Zoom Contact Center агенту ThunderPhone через сторонний коннектор голосового бота и возвращайте их оператору с помощью SIP REFER."
---

Виджет Bot в вашем сценарии Zoom Contact Center отправляет звонящего агенту с идентификатором звонка Zoom. Когда звонящему нужен человек, агент отправляет SIP `REFER` на адрес агента-человека Zoom, а ваш сценарий получает передачу по идентификатору звонка.

## Перед началом работы

- Агент ThunderPhone и [API-ключ](/ru/guides/api-keys) организации.
- **Общее приложение** Zoom Marketplace, которым управляет ваш администратор и которое доступно для Contact Center, с коннектором для виджета Bot
  ([руководство Zoom по сторонним голосовым ботам](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- SIP-транк от Zoom к провайдеру бота. Команда ISV Zoom создаёт его поэтапно (сбор требований, тестовый транк, затем продакшен), а название компании в приложении должно в точности совпадать с записью транка. Эта настройка начинается при участии поддержки ThunderPhone и Zoom, а не только в вашем аккаунте Zoom.

## 1. Создайте SIP-конечную точку

Коннектор Zoom набирает 15-значный номер, начинающийся с `999`, а не SIP-адрес. Сохранение коннектора генерирует этот номер. Транк Zoom использует TLS 1.2 на порту 5061 и SRTP для аудио, а доступ разрешается по подсетям Zoom, а не по паролю. Поэтому создайте конечную точку `ip_allowlist` с номером коннектора в качестве номера для входящих вызовов и обязательным SRTP (см.
[Платформы, набирающие номер телефона](/ru/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. Отправляйте вызовы с контекстом

Добавьте виджет **Бот** в ваш сценарий и привяжите его к коннектору. Попросите команду ISV Zoom направить транк на `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. Добавьте этот
номер перевода (см.
[Добавление номера перевода](/ru/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` с
метаданными.

Чтобы получить передачу без использования этих способов, настройте сценарий
так, чтобы он выполнял поиск после виджета бота с помощью виджета **HTTP-вызов**
или **Скрипт**:

- `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).

## Проверьте

Позвоните на номер, который направляет в виджет бота, попросите агента
соединить с человеком и убедитесь, что звонящий попадает к оператору, а виджет
возвращает данные о передаче. Затем откройте вызов с помощью
`GET /v1/calls/{call_id}`: в `sip_headers` должен быть указан
`x-zoom-call-sid`, а `external_call_id` должен соответствовать SID вызова,
который использует ваш сценарий.

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

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