Mango Office: настройка и всплывающая карточка

Mango Office — одна из самых распространённых виртуальных АТС в связке с RetailCRM, и модуль для неё есть прямо в Маркетплейсе. Разбираем полный цикл настройки: от ключей API до всплывающей карточки оператора и записи разговоров в заказе.

Что даёт интеграция Mango Office с RetailCRM

После подключения модуля телефонии Mango Office операторы работают со звонками, не выходя из CRM. Появляются:

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

Технически всё держится на обмене событиями между АТС Mango и RetailCRM по API — CRM выступает приёмником, Mango отправляет вызовы и статусы линий.

Что подготовить до настройки

Чтобы не прерываться в процессе, соберите доступы заранее:

Ключи API создаются в личном кабинете Mango в разделе интеграций (VPBX API). Без пары ключ+соль CRM не сможет ни принимать события, ни инициировать звонки.

Подключение модуля в RetailCRM

Порядок действий в интерфейсе RetailCRM:

1. Откройте Настройки → Интеграции → Маркетплейс и найдите модуль Mango Office.
2. Установите модуль и перейдите в его настройки.
3. Впишите vpbx_api_key и vpbx_api_salt из личного кабинета Mango.
4. В личном кабинете Mango укажите адрес обработки событий (webhook), который выдал модуль RetailCRM.
5. Сопоставьте сотрудников: внутренний номер Mango — пользователь RetailCRM.

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

После сохранения настроек не спешите закрывать окно: модуль обычно показывает статус подключения и результат тестового обращения к API Mango. Если статус «ошибка авторизации», значит ключ или соль скопированы с лишними пробелами либо взяты не из того аккаунта. Проверьте, что VPBX API включён в тарифе именно для этой виртуальной АТС, а не для другого юрлица в кабинете Mango. Только после успешного статуса имеет смысл переходить к тестовым звонкам.

Как работает всплывающая карточка

Всплывающая карточка — реакция RetailCRM на событие telephony/call/event с типом входящего вызова. Логика такая:

1. Клиент звонит на номер, обслуживаемый Mango.
2. Mango отправляет событие в RetailCRM с номером клиента и оператором.
3. RetailCRM ищет клиента по номеру и показывает нужному оператору карточку.

В карточке оператор сразу видит имя, последние заказы, сегмент и незакрытые задачи. Если клиент новый — предлагается быстро создать его и оформить заказ. Карточка появляется только у того оператора, чей extension указан в событии, поэтому корректная привязка сотрудников критична.

Запись разговоров и исходящие звонки

Записи разговоров Mango передаёт в RetailCRM ссылкой в истории звонка — оператор и руководитель могут прослушать их в карточке клиента или заказа. Хранятся файлы на стороне Mango, CRM отдаёт на них ссылку.

Исходящий звонок работает по схеме click-to-call: оператор нажимает на номер в карточке, RetailCRM даёт Mango команду, АТС сначала дозванивается до оператора, затем — до клиента. Для этого у API-ключа должны быть разрешены исходящие, а у оператора — рабочий внутренний номер или подключённый софтфон.

Записи полезны не только для разбора конфликтов: на их основе руководитель отдела продаж строит обучение операторов, а выборочное прослушивание помогает найти узкие места в скриптах. В RetailCRM запись привязана к конкретному заказу, поэтому не нужно искать её в отдельном журнале АТС — всё лежит в истории клиента рядом с остальными обращениями. Это заметно ускоряет работу супервайзера, особенно когда звонков сотни в день.

Проверка и типичные ошибки

После настройки прогоните короткий чек-лист:

• Позвоните на рабочий номер — должна появиться карточка у нужного оператора.
• Нажмите «позвонить» из карточки — проверьте исходящий.
• Завершите разговор — убедитесь, что в истории есть запись и длительность.

Что чаще всего ломается:

Итог

Настройка Mango Office с RetailCRM сводится к трём вещам: корректным ключам VPBX API, указанному webhook и точному сопоставлению сотрудников с внутренними номерами. Когда всё связано, оператор получает всплывающую карточку, звонит в один клик и видит записи разговоров прямо в заказе.

Мы подключаем Mango Office к RetailCRM под ключ: настраиваем ключи, привязку операторов, всплывающую карточку и запись разговоров, проверяем входящие и исходящие на боевых номерах. Если хотите, чтобы телефония заработала без экспериментов, возьмём настройку и сопровождение на себя.