Подключение 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. Иначе можно оставить Не обрабатывать на стороне ВАТС |
| Режим DTMF | RFC2833 |
| Голосовые кодеки | G.711A |
| Режим работы | TCP |
| Количество линий | Максимум одновременных звонков между Mango Office и платформой. Сюда входят и входящие, и исходящие |
Mango Office авторизует транк по IP-адресу, логин и пароль не используются.
Вкладка «Маршрутизация»
| Поле | Значение |
|---|---|
| Исходящий номер | Номер Mango Office, который увидит абонент при исходящем звонке агента |
| Управление номером | Отметьте Разрешить изменение номера линии через заголовок "From:", если агент должен звонить с разных номеров Mango Office |
Сохраните транк. Статус подключения должен стать Подключено.
Шаг 2. Направьте входящие звонки в транк
- В личном кабинете Mango Office откройте Обработка звонков → Голосовое меню и распределение звонков.
- Выберите номер, звонки на который должен принимать агент.
- В схеме добавьте переадресацию, откройте вкладку SIP Trunk и выберите транк из шага 1.
- Сохраните схему.
Шаг 3. Настройте приём звонков в платформе
Зарегистрируйте номер
Откройте Интеграции → Номера телефонов и добавьте свой номер Mango Office, звонки на который вы направили в транк на шаге 2, в формате E.164 (например, +74951234567). Номера у каждой организации свои: один номер может принадлежать только одной организации.
Создайте входящий транк
- Откройте Интеграции → SIP → Входящие транки и нажмите создание транка.
- Укажите название и выберите номер.
- В поле Аутентификация выберите Только по IP: Mango Office не передаёт логин и пароль.
- В поле Разрешённые IP укажите адреса, с которых Mango Office отправляет звонки. Уточните их в поддержке Mango Office.
- Сохраните.
Создайте правило маршрутизации
- Откройте Интеграции → SIP → Правила маршрутизации.
- В фильтре по транкам выберите созданный входящий транк.
- Выберите голосового агента, который будет отвечать, и сохраните.
Позвоните на номер 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 её не выполнит, и звонок оборвётся.
Чтобы способ работал в исходящих звонках:
- В настройках SIP Trunk выберите Команды DTMF: Обрабатывать на стороне ВАТС.
- В Общие настройки → Безопасность и ограничения снимите флажок Игнорировать команды DTMF во время разговора.
- Чтобы переводить на внешние номера, там же отметьте Разрешать перевод звонка на произвольный внешний номер.
Почему не работает SIP REFER
Mango Office принимает запрос на перевод, но не выполняет его. Агент в этом случае сообщает абоненту, что соединить не удалось, и продолжает разговор.
Не указывайте в направлении перевода внутренний номер Mango Office, который маршрутизируется в тот же SIP Trunk. Абонент попадёт к новому агенту.
Если что-то не работает
| Что происходит | Вероятная причина | Что сделать |
|---|---|---|
| Статус транка в Mango Office не «Подключено» | Неверный IP-адрес или порт платформы, неверный режим работы | Проверьте вкладку «Настройка»: адрес платформы, порт 5060, режим TCP |
| Входящий звонок не доходит до агента | Номер не добавлен во входящий транк платформы, нет правила маршрутизации или адрес Mango Office не входит в Разрешённые IP | Проверьте номер, правило и список IP |
| Тестовый исходящий звонок не проходит | Неверный адрес шлюза, не задан Исходящий номер на вкладке «Маршрутизация» | Проверьте SIP-адрес исходящего транка и вкладку «Маршрутизация» в Mango Office |
| Абонент слышит «Линия занята» при свободном операторе | Заняты все линии транка | Увеличьте Количество линий в настройках SIP Trunk |
| При переводе слышен тоновый набор, затем обрыв | Способ DTMF во входящем звонке | Выберите способ «Подключить оператора» |