Интеграция Битрикс24 с Comagic

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

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

Эта интеграция отличается от базового подключения UIS-телефонии. Телефония — это маршрутизация звонков, SIP-транк, софтфон. Здесь речь об аналитической стороне: откуда пришёл клиент, какой рекламный канал сработал, сколько касаний было до сделки.

Что отслеживает CoMagic

CoMagic работает на уровне посетительской сессии. Скрипт на сайте присваивает каждому визиту уникальный идентификатор и собирает:

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

CoMagic подменяет номера на сайте (динамический коллтрекинг) и отслеживает чаты через собственный виджет. Каждое обращение привязано к сессии с полной атрибуцией.

Передача данных в Битрикс24

Данные из CoMagic попадают в CRM двумя путями: через штатный коннектор и через Data API.

Штатный коннектор подключается в кабинете CoMagic: раздел Интеграции → Битрикс24. Работает в режиме «один звонок = один лид». При входящем звонке CoMagic отправляет данные в Б24 — создаётся лид с UTM-полями. Ограничения: нет гибкости в маппинге полей, нет обработки чатов.

Data API — REST-интерфейс CoMagic для выгрузки аналитических данных. Основные методы:

• get /calls/report — отчёт по звонкам с атрибуцией
• get /chats/report — отчёт по чатам
• get /goals/report — отчёт по целям (формы, callback)
• get /visitors/report — данные по посетительским сессиям

Через Data API строится полноценная двусторонняя интеграция.

Архитектура кастомной интеграции

Для максимальной точности аналитики используем связку Data API + REST API Битрикс24:

1. Звонки. Cron-задача опрашивает /calls/report каждые 5 минут. Для каждого нового звонка:

   • Поиск контакта: crm.contact.list по номеру телефона.
   • Контакт найден → регистрация звонка: telephony.externalcall.register с привязкой к контакту. UTM и источник записываются в примечание или пользовательские поля сделки.
   • Контакт не найден → создание лида: crm.lead.add с полями UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN и пользовательскими полями.
   • Привязка записи: telephony.externalcall.attachRecord.

2. Чаты. Обращения из чат-виджета CoMagic передаются аналогично. /chats/report возвращает текст переписки, источник, UTM-метки. В Б24 создаётся лид или активность в таймлайне существующего контакта.

3. Формы и callback. /goals/report содержит данные по заполненным формам и запросам обратного звонка. Каждая цель = лид в CRM.

Пользовательские поля для CoMagic-данных:

• UF_CRM_CM_SOURCE (строка) — название источника
• UF_CRM_CM_KEYWORD (строка) — ключевое слово
• UF_CRM_CM_CHANNEL (строка) — рекламный канал
• UF_CRM_CM_SESSION_ID (строка) — ID сессии CoMagic

Lead scoring и мультиканальная атрибуция

CoMagic оценивает качество обращений: длительность звонка, наличие разговора (не сброс), повторное обращение. Эти данные используются для скоринга лидов в CRM.

Схема:

• Звонок длительностью менее 15 секунд → лид с низким приоритетом.
• Первичный звонок длительностью более 2 минут → высокий приоритет. Робот в Б24 автоматически назначает ответственного менеджера.
• Повторный звонок от существующего контакта → не создаётся новый лид, обновляется активность.

Мультиканальная атрибуция показывает все касания клиента до обращения. CoMagic фиксирует: первый визит из Директа → второй визит из SEO → звонок после перехода из email-рассылки. В Б24 эта цепочка записывается в примечание лида или в отдельное пользовательское поле — маркетолог видит полный путь клиента.

Синхронизация данных о сделках обратно в CoMagic

Для расчёта ROI в CoMagic нужны данные о выручке из CRM. При закрытии сделки вебхук onCrmDealUpdate отправляет в CoMagic:

• ID сессии (UF_CRM_CM_SESSION_ID)
• Сумму сделки
• Статус (выиграна / проиграна)

CoMagic связывает выручку с рекламным источником и рассчитывает ROI по каналам, кампаниям и ключевым словам.

Сроки внедрения

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

• Подключение CoMagic к Битрикс24 через штатный коннектор или Data API
• Создание пользовательских полей в CRM для аналитических данных CoMagic
• Разработка скрипта синхронизации: cron-задача, обработка звонков, чатов, форм
• Логика дедупликации: поиск контакта по номеру, обработка повторных обращений
• Привязка записей разговоров к карточкам CRM
• Настройка lead scoring: приоритизация лидов по длительности звонка и типу обращения
• Передача данных о закрытых сделках обратно в CoMagic для расчёта ROI
• Тестирование полной цепочки: визит → обращение (звонок/чат/форма) → лид → сделка → ROI в CoMagic
• Обучение маркетолога: отчёты по источникам, мультиканальная атрибуция, интерпретация данных