Телефония и SIP

Платформа поддерживает телефонные интеграции через SIP-протокол и внешних провайдеров телефонии. Это позволяет подключать голосовых AI-агентов к телефонным линиям для приёма и совершения звонков.

Раздел Интеграции содержит три вкладки для работы с телефонией:

Вкладка	Назначение
Телефония	Подключения к внешним провайдерам телефонии и привязка к ним голосовых агентов
Номера телефонов	Реестр телефонных номеров организации. Из него выбираются номера для SIP-транков
SIP	Входящие и исходящие транки, правила маршрутизации, тестовый звонок

---

Телефония (провайдеры телефонии)

Вкладка Телефония позволяет подключать внешних провайдеров телефонии и привязывать к ним голосовых агентов.

Доступные провайдеры

В блоке Доступные провайдеры показаны карточки провайдеров телефонии. Каждый провайдер имеет собственную схему конфигурации и аутентификации.

Создание подключения

1. Нажмите на карточку нужного провайдера — откроется окно Новое подключение.
2. Заполните форму:
   • Название подключения — например, «Production MMD».
   • Поля конфигурации, специфичные для провайдера (адрес сервера, порт и т.д.).
3. Нажмите Создать.

Подключение появится в блоке Подключения.

Привязка голосового агента

После создания подключения к нему можно привязать голосовых агентов:

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

Привязанные агенты отображаются в раскрывающейся строке подключения: голосовой агент, его статус и время последнего сигнала от провайдера (heartbeat).

Статус	Описание
connected	Агент активен и принимает звонки
error	Ошибка подключения
inactive	Агент неактивен

Примечание

Для привязки агента необходимо предварительно создать голосового агента в разделе агентов.

Управление подключениями

• Настройки — кнопка с иконкой шестерёнки открывает редактирование подключения.
• Удалить — нажмите кнопку удаления и подтвердите. Все привязанные агенты будут отвязаны.
• Отвязать агента — в развёрнутой строке подключения нажмите кнопку удаления рядом с агентом.

---

Номера телефонов

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

Добавление номера

Нажмите Добавить номер и заполните:

Поле	Описание	Обязательное
Номер телефона	Номер в формате E.164 (например, +15551234567). После добавления изменить его нельзя	Да
Название	Понятное название номера (например, «Основной номер»)	Нет
Провайдер	Способ подключения номера: SIP-транк (свой оператор)	Да
Агент	Голосовой агент, обрабатывающий звонки на этот номер	Нет

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

Таблица показывает номер, название, провайдера, привязанного агента (или «Не назначен»), статус и дату добавления. Через контекстное меню строки доступны действия: Копировать номер, Редактировать, Удалить. Несколько выбранных номеров можно удалить разом.

Внимание

Номер, который используется в SIP-транке, удалить нельзя: платформа сообщит, в каком транке он занят. Сначала уберите номер из транка, затем удалите его.

---

SIP (прямая настройка)

Вкладка SIP предоставляет низкоуровневое управление SIP-инфраструктурой: транки для входящих и исходящих звонков и правила маршрутизации.

В верхней части отображается SIP-домен — адрес SIP-сервера платформы, на который ваш оператор направляет звонки. Рядом находится кнопка Тестовый звонок.

Входящие транки

Входящие транки определяют, откуда могут поступать звонки.

Создание входящего транка

1. Откройте вкладку Входящие транки.
2. Нажмите Входящий транк.
3. Заполните форму:

Поле	Описание
Название транка	Название для списка (например, «Twilio Inbound»)
Номера телефонов (E.164)	Номера, звонки на которые принимает транк. Выбираются из номеров, добавленных на вкладке Номера телефонов. Нужен хотя бы один
Разрешённые IP	IP-адреса или CIDR через запятую, с которых разрешены подключения. Пустое значение — разрешены все
Логин аутентификации	Логин, который SIP-провайдер передаёт при звонке. Обязательное поле
Пароль аутентификации	Пароль транка. Обязательное поле, не короче 16 символов
Шифрование медиа	Выключено, Предпочтительно или Обязательно

4. Нажмите Создать.

Внимание

Логин и пароль у входящего транка обязательны: SIP-домен общий, и без учётных данных транк был бы защищён только номером телефона. Кнопка Сгенерировать создаёт надёжный пароль, Копировать пароль копирует его в буфер. Пароль показывается только при создании транка — сохраните его сразу, позже посмотреть его не получится.

Таблица отображает все входящие транки: название, номера, разрешённые IP, наличие аутентификации и статус (Активен, Неактивен, Ошибка).

Исходящие транки

Исходящие транки определяют, через какого провайдера будут совершаться исходящие звонки.

Создание исходящего транка

1. Откройте вкладку Исходящие транки.
2. Нажмите Исходящий транк.
3. Заполните форму:

Поле	Описание
Название транка	Название для списка (например, «Twilio Outbound»)
SIP-адрес	Адрес SIP-сервера провайдера (например, sip.twilio.com)
Caller ID (E.164)	Номера, от имени которых совершаются звонки. Выбираются из номеров, добавленных на вкладке Номера телефонов
Транспорт	Протокол транспорта: Авто, UDP, TCP, TLS
Логин авторизации	Имя пользователя для авторизации у провайдера (необязательно)
Пароль авторизации	Пароль для авторизации у провайдера (необязательно)

4. Нажмите Создать.

Подключение через Voximplant

Если звонки идут через Voximplant, в строке транка (и входящего, и исходящего) есть кнопка Сценарий VoxEngine. Она показывает готовый сценарий для вашего транка — скопируйте его и вставьте в приложение Voximplant. В сценарии нужно заменить заглушку пароля на пароль транка, который был показан при его создании.

Правила маршрутизации

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

Внимание

Для создания правила маршрутизации необходим хотя бы один входящий транк.

Создание правила

1. Нажмите Правило в блоке Правила маршрутизации.
2. Заполните форму:

Поле	Описание
Название правила	Название для списка правил (например, «Линия поддержки»). На маршрутизацию не влияет
Тип правила	Individual — каждый звонок попадает в отдельную комнату; Direct — звонки попадают в конкретную комнату
Префикс комнаты	Для Individual — префикс имени комнаты (например, sip-call-), к которому для каждого звонка добавляется уникальный суффикс
Фильтр по транкам	Входящие транки, к которым применяется правило. Звонки с других транков под него не попадают
Голосовой агент	Агент, который отвечает на звонки, попавшие под это правило
Скрывать номер телефона	Не раскрывать номер звонящего в звонке: вместо номера участник получает случайный идентификатор

3. Нажмите Создать.

Тестовый звонок

Для проверки настройки можно совершить тестовый исходящий звонок:

1. Нажмите Тестовый звонок (кнопка активна, когда есть хотя бы один исходящий транк).
2. Заполните форму:

Поле	Описание
Номер телефона	Номер, на который позвонит агент, в формате E.164
Агент	Голосовой агент, который будет вести разговор
Исходящий транк	Транк, через который пойдёт звонок
Номер отправителя (Caller ID)	Номер, который увидит абонент. Если не выбран — используется номер транка по умолчанию

3. Нажмите Позвонить.

Платформа сообщит номер созданной сессии. Звонок сразу появляется на вкладке Сессии раздела голосовых агентов — там видны его статус, итог и транскрипт.

Совет

Тестовый звонок позволяет быстро проверить работу всей цепочки: транк -> провайдер -> голосовой агент, без необходимости ожидать входящий звонок.

Подробнее

Смотрите параметры исходящих звонков через API, определение автоответчика и разбор сессий в разделе Телефония и SIP голосовых агентов.