Телефония

Интеграция с телефонными провайдерами в Voxagent

Voxagent интегрируется с телефонными провайдерами, позволяя AI-агентам принимать и совершать телефонные звонки.

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

ПровайдерВходящиеИсходящиеПримечания
TwilioДаДаПрямая интеграция через SIP trunk
VoxImplantДаДаЧерез WebSocket Media Bridge (нет прямого доступа к SIP)
Свой SIP (Custom)ДаДаПодключение собственной АТС / SIP-trunk по стандартному SIP-протоколу

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

При поступлении звонка на подключённый номер:

  1. Телефонный провайдер отправляет вебхук на платформу
  2. Вебхук принимается через Kafka
  3. Бэкенд определяет агента, привязанного к номеру
  4. Создаётся LiveKit-комната с SIP-участником
  5. AI-агент запускается в комнате
  6. Разговор начинается

Управление номерами

  • Импорт существующих номеров из Twilio или VoxImplant
  • Привязка номера к конкретному агенту
  • Настройка параметров для каждого номера

Исходящие звонки

Исходящие звонки можно инициировать:

Платформа создаёт LiveKit-комнату, запускает агента и инициирует исходящий звонок через настроенного телефонного провайдера.

Свой SIP (Custom)

Помимо готовых интеграций с Twilio и VoxImplant, Voxagent позволяет подключить любую SIP-телефонию — собственную АТС (Mango Office, Asterisk, FreeSWITCH, PBX-as-a-Service и т.д.) — по стандартному SIP-протоколу. LiveKit-сервер выступает SIP-узлом по обе стороны:

  • Входящие (PBX → LiveKit): ваш SIP-провайдер отправляет INVITE на публичный SIP-домен LiveKit. Проверка по списку разрешённых IP (allowlist) и опциональной Digest-аутентификации.
  • Исходящие (LiveKit → PBX): LiveKit инициирует INVITE к SIP-серверу вашей АТС. Аутентификация — опциональная Digest-пара логин/пароль либо IP-trust (PBX доверяет нашим IP).

Для каждого аккаунта администратор задаёт SIP-сервер, транспорт, страну назначения, список разрешённых IP и пары креденшелов. После создания аккаунта платформа отдаёт домен публичного SIP-шлюза и список наших исходящих IP — эти данные администратор передаёт владельцу АТС, чтобы тот настроил маршрутизацию.

Пошаговая настройка обеих сторон — в руководстве «Свой SIP (Custom)».

Интеграция с VoxImplant

VoxImplant не предоставляет прямой доступ к SIP trunk. Платформа использует WebSocket Media Bridge — сервис на Node.js, который:

  1. Получает аудио от VoxImplant через WebSocket
  2. Стримит его в LiveKit-комнату
  3. Отправляет аудио из LiveKit обратно в VoxImplant

Это обеспечивает полную функциональность агента с VoxImplant в качестве телефонного бэкенда.

SIP Trunk (LiveKit)

LiveKit Server включает встроенный SIP-компонент, который обеспечивает:

  • Регистрацию SIP trunk
  • Правила диспатча для маршрутизации звонков в комнаты
  • Прямой мост SIP-to-WebRTC (для провайдеров с поддержкой SIP)

Содержание