Перейти к основному содержимому

Подключение Mango Office

Инструкция для администратора организации (право manage_integrations). После настройки звонки на номер Mango Office обслуживает голосовой агент, а агент может звонить сам через номер Mango Office.

Связь строится через внешний SIP Trunk Виртуальной АТС Mango Office:

Входящий:  абонент → номер Mango Office → схема распределения → SIP Trunk → платформа → агент
Исходящий: агент → платформа → шлюз Mango Office → абонент

Что понадобится​

  • Виртуальная АТС Mango Office с услугой SIP Trunk и номером.
  • Доступ в личный кабинет Mango Office с правом настраивать SIP и схемы распределения звонков.
  • Созданный голосовой агент.
  • В платформе: доступ к разделу Интеграции (вкладки Номера телефонов и SIP).

Шаг 1. Создайте SIP Trunk в Mango Office​

В личном кабинете Mango Office откройте Настройки и инструменты → Настройки SIP → SIP Trunk, нажмите Добавить SIP Trunk и выберите Внешний.

Вкладка «Настройка»​

ПолеЗначение
IP-адресIP-адрес SIP-сервера платформы. Это адрес, на который указывает SIP-домен из раздела Интеграции → SIP. Для sip.lia.chat это 135.106.167.127
Порт5060
Команды DTMFОбрабатывать на стороне ВАТС, если планируете перевод на оператора способом DTMF. Иначе можно оставить Не обрабатывать на стороне ВАТС
Режим DTMFRFC2833
Голосовые кодекиG.711A
Режим работыTCP
Количество линийМаксимум одновременных звонков между Mango Office и платформой. Сюда входят и входящие, и исходящие

Mango Office авторизует транк по IP-адресу, логин и пароль не используются.

Вкладка «Маршрутизация»​

ПолеЗначение
Исходящий номерНомер Mango Office, который увидит абонент при исходящем звонке агента
Управление номеромОтметьте Разрешить изменение номера линии через заголовок "From:", если агент должен звонить с разных номеров Mango Office

Сохраните транк. Статус подключения должен стать Подключено.


Шаг 2. Направьте входящие звонки в транк​

  1. В личном кабинете Mango Office откройте Обработка звонков → Голосовое меню и распределение звонков.
  2. Выберите номер, звонки на который должен принимать агент.
  3. В схеме добавьте переадресацию, откройте вкладку SIP Trunk и выберите транк из шага 1.
  4. Сохраните схему.

Шаг 3. Настройте приём звонков в платформе​

Зарегистрируйте номер​

Откройте Интеграции → Номера телефонов и добавьте свой номер Mango Office, звонки на который вы направили в транк на шаге 2, в формате E.164 (например, +74951234567). Номера у каждой организации свои: один номер может принадлежать только одной организации.

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

  1. Откройте Интеграции → SIP → Входящие транки и нажмите создание транка.
  2. Укажите название и выберите номер.
  3. В поле Аутентификация выберите Только по IP: Mango Office не передаёт логин и пароль.
  4. В поле Разрешённые IP укажите адреса, с которых Mango Office отправляет звонки. Уточните их в поддержке Mango Office.
  5. Сохраните.

Создайте правило маршрутизации​

  1. Откройте Интеграции → SIP → Правила маршрутизации.
  2. В фильтре по транкам выберите созданный входящий транк.
  3. Выберите голосового агента, который будет отвечать, и сохраните.

Позвоните на номер Mango Office: должен ответить агент.


Шаг 4. Настройте исходящие звонки​

Исходящий транк нужен, чтобы агент звонил сам, и для перевода на оператора способом «Подключить оператора».

Откройте Интеграции → SIP → Исходящие транки и добавьте транк:

ПолеЗначение
Название транкаНапример, Mango
SIP-адресАдрес SIP-шлюза Mango Office. В руководстве Mango Office по SIP Trunk указан 81.88.86.55. Если в настройках транка Mango Office задано поле Домен, используйте ваш-домен.mangosip.ru
Caller ID (E.164)Номер Mango Office, с которого звонит агент
ТранспортTCP
Логин и пароль авторизацииОставьте пустыми
Адрес шлюза

Mango Office предупреждает, что адрес шлюза может измениться. Если исходящие звонки не проходят, уточните актуальный адрес в поддержке Mango Office.

Проверьте транк кнопкой Тестовый звонок на вкладке SIP: укажите свой номер, агента и транк. Телефон должен зазвонить с номера Mango Office.


Перевод на оператора​

Перевод на оператора с Mango Office работает не всеми способами:

СпособВходящие звонкиИсходящие звонки
Подключить оператораРаботаетРаботает
DTMFНе работаетРаботает
SIP REFERНе работаетНе работает

Рекомендуемый способ: Подключить оператора. Нужен исходящий транк из шага 4. В направлении можно указать внутренний номер сотрудника или группы Mango Office либо внешний телефон.

Особенности способа DTMF​

Mango Office выполняет команду ## только в звонках, которые начала платформа, то есть в исходящих. Во входящих звонках агент наберёт команду, но Mango Office её не выполнит, и звонок оборвётся.

Чтобы способ работал в исходящих звонках:

  1. В настройках SIP Trunk выберите Команды DTMF: Обрабатывать на стороне ВАТС.
  2. В Общие настройки → Безопасность и ограничения снимите флажок Игнорировать команды DTMF во время разговора.
  3. Чтобы переводить на внешние номера, там же отметьте Разрешать перевод звонка на произвольный внешний номер.

Почему не работает SIP REFER​

Mango Office принимает запрос на перевод, но не выполняет его. Агент в этом случае сообщает абоненту, что соединить не удалось, и продолжает разговор.

Номер, который ведёт на агента

Не указывайте в направлении перевода внутренний номер Mango Office, который маршрутизируется в тот же SIP Trunk. Абонент попадёт к новому агенту.


Если что-то не работает​

Что происходитВероятная причинаЧто сделать
Статус транка в Mango Office не «Подключено»Неверный IP-адрес или порт платформы, неверный режим работыПроверьте вкладку «Настройка»: адрес платформы, порт 5060, режим TCP
Входящий звонок не доходит до агентаНомер не добавлен во входящий транк платформы, нет правила маршрутизации или адрес Mango Office не входит в Разрешённые IPПроверьте номер, правило и список IP
Тестовый исходящий звонок не проходитНеверный адрес шлюза, не задан Исходящий номер на вкладке «Маршрутизация»Проверьте SIP-адрес исходящего транка и вкладку «Маршрутизация» в Mango Office
Абонент слышит «Линия занята» при свободном оператореЗаняты все линии транкаУвеличьте Количество линий в настройках SIP Trunk
При переводе слышен тоновый набор, затем обрывСпособ DTMF во входящем звонкеВыберите способ «Подключить оператора»