Open in
Подключение из 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, поэтому вы не можете самостоятельно настроить или протестировать его.