Интеграция телефонии Mango, Telfin, UIS

Mango Office, Telfin и UIS — облачные АТС с готовыми приложениями в Битрикс24.Маркет. В отличие от SIP-коннектора, интеграция идёт через REST: событие звонка пробрасывается в CRM, открывается карточка клиента, работает звонок по клику. Разберём, чем отличаются провайдеры и как их подключить.

Как работает интеграция через приложение

В отличие от подключения своей SIP-АТС, интеграции Mango, Telfin и UIS работают не по SIP-регистрации, а через REST API Битрикс24. Звонки физически обслуживает виртуальная АТС провайдера, а приложение синхронизирует события с CRM.

• Приложение регистрирует у себя внешнюю линию в телефонии Битрикс24.
• При звонке провайдер отправляет событие в CRM — открывается всплывающая карточка контакта.
• Запись разговора и статистика подтягиваются в дело и в отчёты по звонкам.
• Реализуется click-to-call — звонок из карточки лида или сделки одним кликом.

Установка приложения из Маркета

Все три провайдера публикуют приложения в каталоге Приложения → Маркет внутри портала. Общий порядок одинаков.

1. Найдите приложение провайдера (Mango Office, Telfin или UIS) в Маркете и установите его.
2. Примите запрашиваемые права: доступ к телефонии, CRM, пользователям.
3. Авторизуйтесь в личном кабинете провайдера — обычно нужен API-ключ или логин/пароль ЛК.
4. Сопоставьте сотрудников Битрикс24 с внутренними номерами (extension) на стороне АТС.
5. Настройте, какие линии считать входящими в CRM и правила создания лидов.

Сравнение Mango, Telfin и UIS

Провайдеры близки по базовым сценариям, но различаются в деталях интеграции и специализации.

Если ключевая задача — сквозная аналитика и коллтрекинг, UIS исторически силён именно в этом. Mango удобен как универсальная виртуальная АТС, Telfin гибок для нестандартных телеком-схем. При выборе ориентируйтесь не только на функции, но и на покрытие нужных вам городов номерами, тарифы на исходящие направления и наличие поддержки, готовой помочь именно с интеграцией в Битрикс24. Технически все три подключаются похоже, поэтому решающими часто оказываются коммерческие условия и качество линий в вашем регионе.

Проброс события звонка и карточка

Ядро интеграции — событие входящего/исходящего вызова. Приложение вызывает методы телефонии REST API, чтобы Битрикс24 знал о звонке в реальном времени.

• telephony.externalcall.register — регистрирует начало звонка, открывает карточку.
• telephony.externalcall.show — показывает всплывающее окно нужному сотруднику.
• telephony.externalcall.finish — завершает звонок, передаёт статус и длительность.
• telephony.externalCall.attachRecord — прикрепляет файл записи разговора.

Благодаря этому при входящем менеджер сразу видит, кто звонит: если номер найден в CRM — открывается карточка контакта, если нет — предлагается создать лид. Пропущенные фиксируются автоматически, а по завершении вызова в CRM создаётся дело с длительностью, направлением и ссылкой на запись. Именно эта цепочка методов отличает REST-интеграцию от простого SIP-транка: телефония становится частью воронки, а не отдельным каналом.

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

Звонок по клику и исходящие

Click-to-call позволяет звонить прямо из карточки лида, контакта или сделки. Механика зависит от режима работы провайдера.

1. Менеджер нажимает на номер телефона в карточке CRM.
2. Приложение отправляет команду в АТС провайдера.
3. АТС инициирует вызов: сначала звонит на телефон/софтфон менеджера, затем соединяет с клиентом (callback), либо звонок идёт через WebRTC.

Что учесть при выборе и настройке

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

• Дубли лидов. Проверьте правила создания лида, чтобы повторные звонки не плодили новые карточки.
• Ответственный. Настройте, кто становится ответственным по звонку от нового клиента.
• Рабочее время. Логика нерабочих часов и переадресации, как правило, живёт на стороне АТС провайдера.
• Хранение записей. Уточните, где хранятся записи — у провайдера или в Битрикс24 — и сроки хранения.

Итог

Mango Office, Telfin и UIS подключаются к Битрикс24 через готовые приложения из Маркета и работают по REST: проброс события звонка, всплывающая карточка клиента, click-to-call и запись разговоров в деле. Провайдеры схожи по базовым возможностям, но различаются акцентами — UIS силён в коллтрекинге и аналитике, Mango универсален, Telfin гибок в телеком-сценариях.

Если нужно выбрать провайдера под ваши задачи, корректно сопоставить сотрудников с номерами и настроить правила лидов без дублей — мы подключим телефонию, свяжем её с воронкой продаж и выстроим сквозную аналитику по звонкам.