ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Contact centers

Подключение из Zoom Contact Center

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

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

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

  • Агент ThunderPhone и API-ключ организации.
  • Общее приложение Zoom Marketplace, которым управляет ваш администратор и которое доступно для Contact Center, с коннектором для виджета Bot (руководство Zoom по сторонним голосовым ботам).
  • SIP-транк от Zoom к провайдеру бота. Команда ISV Zoom создаёт его поэтапно (сбор требований, тестовый транк, затем продакшен), а название компании в приложении должно в точности совпадать с записью транка. Эта настройка начинается при участии поддержки ThunderPhone и Zoom, а не только в вашем аккаунте Zoom.

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

Коннектор Zoom набирает 15-значный номер, начинающийся с 999, а не SIP-адрес. Сохранение коннектора генерирует этот номер. Транк Zoom использует TLS 1.2 на порту 5061 и SRTP для аудио, а доступ разрешается по подсетям Zoom, а не по паролю. Поэтому создайте конечную точку ip_allowlist с номером коннектора в качестве номера для входящих вызовов и обязательным SRTP (см. Платформы, набирающие номер телефона):

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. Добавьте этот номер перевода (см. Добавление номера перевода), указав адрес SBC, предоставленный Zoom:

{"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. См. Поиск переданного вызова.

Проверьте

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

Ограничения

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