Телефония
Интеграция с телефонными провайдерами в Voxagent
Voxagent интегрируется с телефонными провайдерами, позволяя AI-агентам принимать и совершать телефонные звонки.
Поддерживаемые провайдеры
| Провайдер | Входящие | Исходящие | Примечания |
|---|---|---|---|
| Twilio | Да | Да | Прямая интеграция через SIP trunk |
| VoxImplant | Да | Да | Через WebSocket Media Bridge (нет прямого доступа к SIP) |
| Свой SIP (Custom) | Да | Да | Подключение собственной АТС / SIP-trunk по стандартному SIP-протоколу |
Входящие звонки
При поступлении звонка на подключённый номер:
- Телефонный провайдер отправляет вебхук на платформу
- Вебхук принимается через Kafka
- Бэкенд определяет агента, привязанного к номеру
- Создаётся LiveKit-комната с SIP-участником
- AI-агент запускается в комнате
- Разговор начинается
Управление номерами
- Импорт существующих номеров из Twilio или VoxImplant
- Привязка номера к конкретному агенту
- Настройка параметров для каждого номера
Исходящие звонки
Исходящие звонки можно инициировать:
- Индивидуально через API
- Массово через Исходящие кампании
Платформа создаёт 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, который:
- Получает аудио от VoxImplant через WebSocket
- Стримит его в LiveKit-комнату
- Отправляет аудио из LiveKit обратно в VoxImplant
Это обеспечивает полную функциональность агента с VoxImplant в качестве телефонного бэкенда.
SIP Trunk (LiveKit)
LiveKit Server включает встроенный SIP-компонент, который обеспечивает:
- Регистрацию SIP trunk
- Правила диспатча для маршрутизации звонков в комнаты
- Прямой мост SIP-to-WebRTC (для провайдеров с поддержкой SIP)