Mango Office: интеграция

Mango Office — одна из самых распространённых виртуальных АТС в связке с Битрикс24. Разберём, как подключить её к CRM, что настраивается в личном кабинете, а что через API, и какие сценарии обработки звонков стоит заложить сразу.

Что даёт связка Mango Office и Битрикс

Mango Office (Mango Telecom) — облачная АТС с виртуальными номерами, IVR, записью разговоров и статистикой. При интеграции с CRM звонки перестают быть «слепыми»: каждый вызов привязывается к клиенту, а руководитель видит воронку телефонных обращений.

Базовые возможности связки:

• Screen pop — карточка клиента всплывает у менеджера при входящем.
• Автолид с нового номера и привязка к ответственному для повторных.
• Запись разговора в карточке сделки.
• Click-to-call — звонок по клику из CRM.
• Статистика по звонкам, пропущенным и длительности.

Подключение через приложение Маркета

Самый быстрый путь для Битрикс24 — установить официальное приложение Mango Office из Битрикс24.Маркет. Порядок действий:

1. Установить приложение из раздела Приложения → Маркет в Битрикс24.
2. В приложении указать реквизиты доступа к API кабинета Mango (ключ и код продукта).
3. Сопоставить сотрудников Битрикс24 с внутренними номерами (extensions) в АТС.
4. Включить нужные опции: всплывающая карточка, автосоздание лида, запись.

После этого звонки начинают попадать в CRM автоматически. Настройки маршрутизации, IVR и групп остаются на стороне личного кабинета Mango.

Интеграция через API Mango

Когда нужна своя логика — например, привязка к коробочному сайту на 1С-Битрикс или нестандартная маршрутизация — используют API Mango напрямую. Основные группы методов:

Запросы к Mango подписываются: формируется sign как SHA-256 от конкатенации api_key + JSON + api_salt. События АТС приходят на ваш обработчик, который перекладывает их в методы telephony.externalcall.* Битрикс24 или в свою CRM-логику.

Сценарии обработки звонков

Чтобы интеграция приносила пользу, а не просто фиксировала факт звонка, стоит заложить рабочие сценарии:

• Маршрут на «своего» менеджера: повторный клиент соединяется с ответственным из сделки.
• Пропущенный → задача: автоматическое напоминание перезвонить с дедлайном.
• IVR по отделам с маршрутом в соответствующую воронку продаж.
• Callback с сайта: посетитель заказывает обратный звонок, Mango через Commutation соединяет его с оператором.
• Оценка качества по записям — выборочное прослушивание разговоров прямо из карточек.

Для интернет-магазина полезно связать звонок с заказом: если клиент уже оформлял покупку, менеджер видит статус заказа ещё до приветствия.

Запись разговоров и хранение

Записи — частый источник вопросов. У Mango они формируются на стороне АТС и доступны по API, но появляются не мгновенно после завершения звонка.

• Ссылку на запись отдаёт метод статистики или событие summary.
• В Битрикс24 файл прикрепляется к звонку через telephony.externalCall.attachRecord.
• Хранение на стороне Mango ограничено тарифом — для длительного архива запись стоит выгружать в своё хранилище.

Частые проблемы и как их избежать

Опыт внедрений подсказывает набор типовых граблей именно для Mango:

• Расхождение форматов номеров между Mango и CRM → дубли и «неопознанные» звонки.
• Несопоставленные extensions → звонки без ответственного.
• Неверная подпись запроса (ошибка в api_salt) → API возвращает отказ авторизации.
• Запись цепляется раньше, чем готова → пустая ссылка; нужна отложенная привязка.
• Не обрабатываются исходящие — учитывайте оба направления вызова.

Все обращения к API полезно логировать: при разборе инцидента журнал запросов и ответов экономит часы.

Итог

Интеграция Mango Office с Битрикс сводится к двум путям: быстрое приложение из Маркета для типовых задач и связка через API, когда нужна собственная логика или работа с сайтом на коробочном 1С-Битрикс. В обоих случаях успех зависит от корректного сопоставления номеров, обработки пропущенных и продуманного хранения записей.

Мы настраиваем Mango Office под реальные процессы отдела продаж: маршрутизацию, IVR, callback с сайта и выгрузку записей, а при необходимости добавляем коллтрекинг и мессенджеры в единый омниканальный контур.