SIP-транки и номера

Как подключить оператора связи по SIP, добавить номера и закрепить их за агентами для входящих и исходящих звонков.

Чтобы агент разговаривал по обычному телефону, нужны две вещи: SIP-транк — соединение с вашим оператором связи, и номер на этом транке, закреплённый за агентом. Тестировать агента можно и без них — кнопкой «Тест в браузере».

Кто может это настраивать

Управлять номерами может владелец аккаунта или сотрудник, которому он выдал это право. Удалять транки может только владелец. Подробнее о ролях — в разделе Команда и роли.

Что подготовить у оператора

Получите в личном кабинете оператора (Манго Офис, UIS, Телфин или любого другого SIP-оператора):

  • адрес SIP-сервера для исходящих звонков в формате host:port, например trunk.example.com:5060;
  • логин и пароль SIP-учётной записи (если оператор авторизует по логину);
  • номер, который будет показываться собеседнику (АОН);
  • сами номера в международном формате.

Шаг 1. Добавьте SIP-транк

  1. Откройте «Голосовые агенты» → «SIP-транки» и нажмите «Добавить транк».
  2. Укажите название транка — например, «Манго, основной».
  3. Введите исходящий адрес (host:port).
  4. Выберите пресет оператора: Манго Офис, UIS, Телфин или пользовательский оператор.
  5. Выберите транспорт: автоматически, UDP, TCP или TLS. Если не уверены — оставьте автоматический выбор.
  6. Укажите исходящий АОН, имя пользователя и пароль.
  7. Если на этот транк будут приходить входящие звонки, отметьте флажок приёма входящих звонков.
  8. Создайте транк.

Транк появится в списке со статусом «Активен» или «Ожидает».

Редактирование и проверка

В меню действий транка доступны:

  • «Редактировать» — сменить название, исходящий адрес и другие параметры. Новый адрес применяется к следующему звонку. Если транк общий с другим аккаунтом, адрес оператора изменить нельзя.
  • Проверка транка — если звонки перестали проходить, эта команда проверит соединение и при необходимости пересоздаст его. Вы увидите сообщение «Транк на месте, восстанавливать нечего» или «Транк пересоздан… — звонки снова пойдут».
  • «Удалить» — действие необратимо. Сначала удалите или перенесите номера, привязанные к транку.

Шаг 2. Добавьте номер

  1. Откройте «Номера» и нажмите «Добавить номер».
  2. Введите номер в формате E.164 — с плюсом и кодом страны, без пробелов: +74951234567.
  3. Выберите «Транк», через который идёт этот номер.
  4. Выберите «Направление»:
    • outbound — только исходящие: с этого номера агенты звонят клиентам;
    • inbound — только входящие: звонки на номер принимает агент;
    • both — и то и другое.
  5. Для входящих номеров обязательно выберите агента в поле «Агент (обязательно для входящих)».
  6. Нажмите «Добавить».

Ограничения:

  • один номер добавляется один раз. Чтобы использовать его и для исходящих, откройте существующую запись и поставьте направление both;
  • агент-слушатель не может отвечать на номер — выберите разговорного агента.

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

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

Входящий звонок отображается в разделе «Звонки» как «Входящий от …» с источником «SIP».

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

Есть четыре способа позвонить с помощью агента:

  1. Кнопка «Позвонить» на странице агента. Выберите номер «От» и введите «Номер получателя (E.164)». Если у аккаунта нет исходящих номеров, вы увидите подсказку «Сначала добавьте исходящий номер телефона».
  2. Кампания — обзвон списка номеров.
  3. REST API — POST /calls из вашей CRM или сайта.
  4. Перезвон, который агент назначил сам по просьбе клиента (встроенный инструмент «Перезванивать по просьбе»).

Исходящие звонки учитывают расписание агента: вне разрешённых часов звонок через API откладывается до ближайшего окна.

Статусы звонка

СтатусЗначение
«В очереди»Звонок принят и ждёт набора (в том числе до начала окна расписания)
«Набор» / «Вызов»Идёт набор номера
«Активен»Разговор идёт
«Завершён»Разговор состоялся
«Нет ответа» / «Голосовая почта»Не дозвонились или ответил автоответчик
«Ошибка» / «Отменён»Звонок не удался или был отменён

Если звонки не проходят, откройте звонок в разделе «Звонки», вкладка «Активность» — там видны события набора и ошибки.