Обзор

Система интеграции с телефонией Агентики предоставляет единый интерфейс для подключения к различным провайдерам телефонии. Одна и та же конфигурация обслуживает и исходящие звонки (инициируемые из Агентики), и входящие звонки (принимаемые на номер, которым вы владеете).

Поддерживаемые провайдеры

Asterisk ARI

Подключитесь к своей собственной Asterisk PBX через Asterisk REST Interface

Плюсофон

Российский оператор облачной телефонии, подключаемый через Asterisk PBX

Собственный провайдер

Создайте собственную интеграцию с провайдером телефонии

Настройка

Все провайдеры телефонии настраиваются на одной странице в Агентике:
  1. Перейдите на /telephony-configurations и нажмите Add configuration
  2. Выберите вашего провайдера
  3. Введите учётные данные и сохраните
  4. Откройте созданную конфигурацию и добавьте хотя бы один номер телефона
  5. (Необязательно) Назначьте Inbound workflow номеру телефона, чтобы включить прием входящих звонков
Одна организация может содержать несколько конфигураций и несколько номеров телефона на каждую конфигурацию. Отметьте одну конфигурацию как default outbound, чтобы использовать ее по умолчанию для тестовых звонков и кампаний.

Общие возможности

Интеграция с телефонией в Агентике поддерживает:
  • Исходящие звонки: инициируйте звонки на любой номер телефона из воркфлоу или кампании
  • Входящие звонки: направляйте входящие звонки нужному голосовому агенту — см. руководство по входящим звонкам
  • Перевод звонка: переводите звонок в процессе на человека или другой номер (зависит от провайдера)
  • Отслеживание статуса звонка: следите за событиями жизненного цикла звонка (initiated, ringing, answered, completed, failed)
  • Потоковая передача аудио через WebSocket: аудио в реальном времени, двунаправленное между абонентом и агентом
  • Проверка подписи вебхука: входящие вебхуки проверяются по учётным данным сопоставленной конфигурации

Входящие звонки

Входящие звонки используют единый URL вебхука на всю организацию:
Агентика определяет организацию по учётным данным аккаунта из вебхука, а агента — по назначению Inbound workflow для набранного номера. См. Входящие звонки для полной инструкции по настройке.

Устранение неполадок

  • Убедитесь, что учётные данные настроены правильно
  • Проверьте формат номера телефона (E.164 с кодом страны, например +1234567890)
  • Убедитесь, что URL вебхуков публично доступны
  • Просмотрите логи ошибок конкретного провайдера
  • Проверьте пропускную способность сети и задержку
  • Убедитесь в совместимости аудиокодека
  • Проверьте стабильность WebSocket-соединения
  • Убедитесь, что auth-токены / API-секреты совпадают у провайдера и в конфигурации Агентики
  • Убедитесь, что URL вебхука совпадает в точности (включая путь /inbound/run)
  • Проверьте, не изменяет ли запросы прокси или балансировщик нагрузки

Дальнейшие шаги