Інтеграція Бітрікс24 з Comagic

Інтеграція Bitrix24 з CoMagic

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

Ця інтеграція відрізняється від базового підключення UIS-телефонії. Телефонія — це маршрутизація дзвінків, SIP-транк, софтфон. Тут мова про аналітичну сторону: звідки прийшов клієнт, який рекламний канал спрацював, скільки дотиків було до угоди.

Що відслідковує CoMagic

CoMagic працює на рівні сесії відвідувача. Скрипт на сайті присвоює кожному відвідуванню унікальний ідентифікатор і збирає:

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

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

Передача даних в Bitrix24

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

Вбудований коннектор підключається в кабінету CoMagic: розділ Інтеграції → Bitrix24. Працює в режимі "один дзвінок = один лід". При вхідному дзвінку 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 Bitrix24:

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 до Bitrix24 через вбудований коннектор або Data API
• Створення користувацьких полів в CRM для аналітичних даних CoMagic
• Розробка скрипту синхронізації: cron-задача, обробка дзвінків, чатів, форм
• Логіка дедублікації: пошук контакту за номером, обробка повторних звернень
• Прив'язка записів розмов до карточок CRM
• Налаштування lead scoring: пріоритизація лідів за тривалістю дзвінку та типом звернення
• Передача даних про закриті угоди назад в CoMagic для розрахунку ROI
• Тестування повного ланцюга: візит → звернення (дзвінок/чат/форма) → лід → угода → ROI в CoMagic
• Навчання маркетолога: звіти по джерелам, мультиканальна атрибуція, інтерпретація даних