​
Обзор

Агентика поддерживает прием входящих звонков через всех поддерживаемых провайдеров телефонии. Когда кто-то звонит на настроенный вами номер телефона, ваш голосовой агент автоматически отвечает и обрабатывает разговор. Входящие и исходящие звонки используют одну и ту же конфигурацию телефонии.

​
Поддерживаемые провайдеры для входящих звонков

Asterisk ARI

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

Плюсофон

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

​
Как работают входящие звонки

Агентика предоставляет единый URL вебхука входящих звонков на всю организацию:
Когда поступает звонок:
  1. Звонок получен: ваш провайдер телефонии принимает входящий звонок
  2. Срабатывает вебхук: провайдер отправляет вебхук на /inbound/run
  3. Определяются организация и агент: Агентика определяет организацию по учётным данным аккаунта из вебхука, затем находит, какой агент должен ответить, на основе назначения Inbound workflow для набранного номера в вашей конфигурации телефонии
  4. Потоковая передача аудио: аудио в реальном времени передается между абонентом и агентом через WebSocket
  5. Обработка разговора: ваш голосовой агент ведет весь разговор
Вам больше не нужно формировать URL для каждого воркфлоу отдельно — маршрутизация выполняется по назначению inbound-воркфлоу для набранного номера в Агентике.

​
Настройка в Агентике

Настройка входящих звонков состоит из трех шагов:

​
Шаг 1: Настройте провайдера телефонии

Конфигурация телефонии для входящих звонков идентична конфигурации для исходящих звонков. Добавьте (или откройте) конфигурацию на /telephony-configurations, следуя документации своего провайдера:

​
Шаг 2: Назначьте Inbound workflow номеру телефона

  1. Перейдите на /telephony-configurations и откройте свою конфигурацию
  2. В разделе Phone numbers отредактируйте номер, который должен принимать входящие звонки
  3. Установите его Inbound workflow на агента, который должен отвечать
  4. Сохраните
Это то, что сообщает Агентике, какого агента запускать при поступлении звонка на этот номер.

​
Шаг 3: Направьте своего провайдера на /inbound/run

Каждому провайдеру нужно указать свой вебхук входящих звонков на глобальный эндпоинт Агентики:
Если вы разворачиваете Агентику самостоятельно (self-hosted), замените api.agentika.ai на свой собственный домен.
Точное место для указания этого URL зависит от провайдера — следуйте инструкциям для конкретного провайдера:

​
Проверка входящих звонков

После завершения настройки в Агентике и настройки у провайдера:
  1. Тестовый звонок: позвоните на настроенный номер телефона с другого телефона
  2. Проверка соединения: убедитесь, что ваш голосовой агент отвечает и реагирует корректно
  3. Проверка логов: отслеживайте логи звонков и в Агентике, и в дашборде провайдера
  4. Качество звука: убедитесь в четкой двусторонней аудиосвязи

​
Устранение распространенных проблем

  • Убедитесь, что URL вебхуков правильно настроены у провайдера
  • Проверьте, что эндпоинты вебхука публично доступны
  • Убедитесь, что номера телефонов правильно привязаны к вашему приложению
  • Убедитесь, что воркфлоу голосового агента настроен правильно
  • Проверьте, что проверка подписи вебхука работает корректно
  • Убедитесь, что WebSocket-соединения устанавливаются успешно
  • Ошибка: “Configuration error: This phone number is configured for a different telephony provider”
  • Решение: проверьте настройки дашборда и обновите конфигурацию URL вебхука, чтобы она соответствовала правильному провайдеру
  • Убедитесь, что номер телефона настроен для одного и того же провайдера и в Агентике, и в консоли вашей телефонии
  • Ошибка: “Workflow not found”
  • Решение: откройте набранный номер в /telephony-configurations и убедитесь, что назначен Inbound workflow. Без этого назначения Агентике некуда направить звонок.
  • Проверьте, что назначенный воркфлоу все еще существует в вашем дашборде
  • Ошибка: “Authentication error: Account credentials do not match”
  • Решение: убедитесь, что настройки SID/учётных данных аккаунта в Агентике совпадают с настройками у вашего провайдера телефонии
  • Заново введите учётные данные провайдера на странице конфигурации телефонии
  • Ошибка: “Phone number not configured: This number is not set up for inbound calls”
  • Решение: добавьте этот номер телефона в разделе Phone numbers в конфигурации телефонии на /telephony-configurations
  • Убедитесь, что номер телефона также привязан к аккаунту у вашего провайдера
  • Ошибка: “Security error: Webhook signature validation failed”
  • Решение: убедитесь, что настройка auth-токена в Агентике совпадает с настройками у провайдера
  • Убедитесь, что запросы вебхука приходят из проверенных диапазонов IP вашего провайдера телефонии
  • Проверьте, что URL вебхука доступен и корректно отвечает
  • Ошибка: “Service temporarily unavailable: Your account has exceeded usage limits”
  • Решение: обратитесь к администратору или обновите тарифный план, чтобы продолжать принимать звонки
  • Проверьте биллинг и лимиты использования у аккаунта провайдера
  • Ошибка: “Authentication failed”
  • Решение: проверьте конфигурацию URL вебхука и убедитесь, что настройки провайдера телефонии совпадают с конфигурацией в дашборде
  • Убедитесь, что все учётные данные введены верно и не истекли
  • Проверьте, что URL вебхука публично доступен с серверов вашего провайдера
  • Проверьте пропускную способность сети и задержку между провайдером и Агентикой
  • Убедитесь, что конфигурация аудиопайплайна соответствует требованиям провайдера
  • Проверьте стабильность WebSocket-соединения

​
Рекомендации

  • Единая конфигурация: используйте одну и ту же конфигурацию телефонии для входящих и исходящих звонков
  • Тестирование: всегда проверяйте прием входящих звонков после изменения конфигурации
  • Мониторинг: отслеживайте и логи Агентики, и дашборды провайдера для аналитики звонков
  • Безопасность: убедитесь, что проверка подписи вебхука включена для безопасности

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

  1. Выберите провайдера телефонии и завершите базовую настройку
  2. Следуйте инструкциям по настройке конкретного провайдера
  3. Назначьте inbound-воркфлоу каждому номеру телефона, который должен принимать звонки
  4. Протестируйте настройку приема входящих звонков