Интеграция Битрикс24 с UIS (CoMagic)

Интеграция Битрикс24 с UIS (CoMagic)

UIS (CoMagic) — платформа телефонии и коллтрекинга. Подключение к Битрикс24 даёт команде продаж единое окно: звонки, записи разговоров, аналитику по источникам — всё внутри CRM. Настраиваем интеграцию так, чтобы каждый звонок превращался в сущность CRM с корректной атрибуцией источника.

Два подхода к подключению

Для базовых сценариев хватает SIP-коннектора. Если нужен коллтрекинг и расширенная аналитика — REST API.

Входящие звонки

При входящем звонке Битрикс24 должен:

1. Определить номер звонящего через АОН.
2. Найти контакт или компанию в CRM по номеру телефона.
3. Показать карточку клиента менеджеру до снятия трубки.
4. Создать запись о звонке в таймлайне сущности CRM.

Через SIP-коннектор это работает из коробки при правильной настройке SIP-учёток. Через REST API — вебхук из UIS вызывает telephony.externalcall.register с параметрами PHONE_NUMBER, USER_ID, TYPE=1 (входящий). Битрикс24 поднимает карточку автоматически.

Исходящие звонки

Менеджер нажимает на номер в карточке CRM. Дальше два варианта:

• SIP-коннектор. Звонок идёт через софтфон Битрикс24 напрямую на SIP-транк UIS.
• REST API + callback. Битрикс24 отправляет запрос в UIS через callback API — АТС звонит сначала менеджеру, затем клиенту. Менеджер снимает трубку — звонок соединяется.

Второй вариант удобнее для колл-центров: не нужен софтфон, звонок приходит на обычный рабочий телефон.

Запись разговоров

UIS хранит записи разговоров на своих серверах. Варианты загрузки в Б24:

• Прямая ссылка. Метод telephony.externalcall.attachRecord принимает URL файла записи. Битрикс24 скачивает и привязывает к звонку в таймлайне.
• Загрузка файла. Если UIS отдаёт файл через API, промежуточный скрипт скачивает MP3 и загружает в Б24 через disk.folder.uploadfile, затем привязывает к звонку.

Записи доступны в карточке контакта, сделки и в общем отчёте по звонкам.

Коллтрекинг и атрибуция лидов

Главная ценность связки UIS + Битрикс24 — понимание, откуда пришёл звонок. CoMagic подменяет номера на сайте: каждый посетитель видит уникальный номер, привязанный к его сессии. Когда клиент звонит, UIS знает:

• Источник трафика — Google Ads, Яндекс.Директ, SEO, прямой заход
• UTM-метки — campaign, medium, source, content, term
• Страница входа и страница звонка
• Ключевое слово (при интеграции с рекламными кабинетами)

Эти данные передаются в Битрикс24 при создании лида или звонка. Схема:

1. Посетитель заходит на сайт. CoMagic присваивает сессию и подменяет номер.
2. Посетитель звонит. UIS фиксирует звонок с привязкой к сессии.
3. Вебхук из UIS отправляет данные в Битрикс24: номер звонящего + источник + utm-метки.
4. Обработчик вебхука создаёт лид в CRM через crm.lead.add с заполненными полями UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN и пользовательским полем «Источник звонка».
5. Если контакт уже существует — звонок привязывается к существующей сущности, utm-метки записываются в примечание.

Для корректной работы пользовательские поля в CRM должны быть созданы заранее. Мы создаём:

• UF_CRM_CALL_SOURCE (строка) — название источника из CoMagic
• UF_CRM_CALL_KEYWORD (строка) — ключевое слово
• UF_CRM_CALL_LANDING (строка) — URL страницы входа

Отчёты по звонкам

Битрикс24 формирует встроенные отчёты: количество звонков по менеджерам, пропущенные, длительность. Для расширенной аналитики с учётом источников используем:

• Списки или смарт-процессы — агрегация данных коллтрекинга в отдельную сущность для построения отчётов в BI-конструкторе Б24.
• Выгрузка в Google Sheets / Power BI — через REST API crm.lead.list с фильтром по UTM-полям.

Что настраиваем при внедрении

• Подключение SIP-транка UIS или регистрация серверного приложения для REST API
• Маршрутизация входящих: распределение по отделам, очереди, IVR (на стороне UIS)
• Маппинг внутренних номеров UIS → пользователи Битрикс24
• Логика создания лидов: новый лид при каждом звонке или только при отсутствии контакта
• Передача данных коллтрекинга и настройка пользовательских полей CRM
• Подключение записи разговоров с хранением в Б24 или по ссылке
• Тестирование: входящий, исходящий, пропущенный, повторный звонок от существующего клиента