Інтеграція Bitrix24 з Roistat
Маркетолог звітує: "Ми витратили 400 тисяч на рекламу і отримали 120 лідів." Директор запитує: "А скільки з них дійшло до оплати і з якого каналу?" Мовчання. Вбудована аналітика Б24 показує джерела за UTM, але не пов'язує витрати з конкретними угодами по всій воронці. Roistat вирішує цю задачу — наскрізна аналітика від клацання до оплати. Проте "підключити Roistat" і "отримати працюючу аналітику" — різні речі. Налаштовуємо інтеграцію так, щоб дані збігалися.
Як працює зв'язка Roistat + Bitrix24
Roistat відслідковує відвідувача з моменту входу на сайт. При першому відвідуванні встановлюється cookie roistat_visit — унікальний ідентифікатор відвідування. Цей номер прив'язує весь ланцюг: рекламний клік → поведінка на сайті → заявка → лід в CRM → угода → оплата.
Схема передачі даних:
- Відвідувач входить на сайт. Скрипт Roistat (пікселю) присвоює
roistat_visitі зберігає в cookie. - Відвідувач залишає заявку. Форма на сайті передає
roistat_visitу прихованому полі. - Roistat перехоплює заявку і створює лід в Bitrix24 через REST API (
crm.lead.add) або через вбудовану інтеграцію. У лідові заповнюється користувацьке полеUF_CRM_ROISTAT_VISIT— номер відвідування. - Менеджер обробляє лід, конвертує в угоду. Поле відвідування успадковується.
- Угода закривається з сумою. Roistat отримує дані через
crm.deal.listі пов'язує виручку з рекламним каналом.
Критично важливо: якщо roistat_visit не передається в CRM — Roistat не пов'яже угоду з рекламою. Відвідування залишиться "без конверсії", а угода — "без джерела". Тому першим, що перевіряємо при налаштуванні — коректність передачі цього поля.
Налаштування передачі roistat_visit в CRM
Roistat пропонує два варіанти інтеграції з Bitrix24:
| Параметр | Вбудована інтеграція (з кабінету Roistat) | Кастомна через REST API |
|---|---|---|
| Складність | Низька — налаштування в інтерфейсі | Середня — потрібна доробка форм та обробників |
| Створення лідів | Автоматично через коннектор | Через crm.lead.add з полем roistat_visit |
| Статуси угод | Маппінг стадій воронки в інтерфейсі Roistat | Вебхук onCrmDealUpdate → Roistat API |
| Мультиворонки | Підтримка з обмеженнями | Повна гнучкість маппінгу |
| Телефонія | Інтеграція через коллтрекінг Roistat | Потрібне окреме налаштування |
Вбудована інтеграція підключається в кабінету Roistat: Налаштування → Інтеграції → Bitrix24. Вказується URL портала та токен REST API з правами на CRM. Roistat автоматично створює користувацьке поле UF_CRM_ROISTAT_VISIT у лідах та угодах.
Для кастомної інтеграції поле створюється вручну через crm.lead.userfield.add:
-
FIELD_NAME:UF_CRM_ROISTAT_VISIT -
USER_TYPE_ID:string -
LABEL:Roistat Visit ID
Аналогічне поле — в угодах через crm.deal.userfield.add.
Коллтрекінг та офлайн-конверсії
Roistat підміняє номери телефонів на сайті — аналогічно CoMagic і Calltouch. Кожен відвідувач бачить унікальний номер, прив'язаний до його roistat_visit. При дзвінку Roistat знає джерело і передає дані в CRM.
Для роботи коллтрекінгу:
- У Roistat налаштовується пул підмінних номерів і прив'язка до рекламних каналів.
- Дзвінки передаються в Б24 через
telephony.externalcall.registerз прив'язкою доroistat_visit. - Запис розмови завантажується через
telephony.externalcall.attachRecord. - Лід створюється автоматично з заповненим джерелом.
Офлайн-конверсії (оплата через касу, підписання договору в офісі) передаються назад в Roistat через статус угоди. Коли менеджер переводить угоду в стадію "Успішно завершена" — вебхук відправляє дані в Roistat API разом з сумою.
ROI за каналами, кампаніями та ключовими словами
Roistat імпортує витрати з рекламних платформ:
- Яндекс.Директ — витрати за кампаніями, групами, ключовими словами
- Google Ads — аналогічно, включаючи Performance Max
- VK Реклама, myTarget — витрати за кампаніями
- Facebook / Instagram Ads — через бізнес-аккаунт Meta
Дані про витрати порівнюються з виручкою з CRM. У звітах Roistat видно:
- Витрати та доходи за кожним каналом
- ROI = (дохід − витрати) / витрати × 100%
- CPL (вартість лід), CPO (вартість замовлення), LTV
- Детальність аж до ключового слова — який запит у Директі привів оплачені угоди
Для коректного розрахунку ROI менеджери обов'язані закривати угоди з заповненою сумою. Угода без суми = нульовий дохід. Це організаційна задача, але без неї технічна інтеграція безглузда.
Кастомні звіти та мультиканальна атрибуція
Стандартні звіти Roistat покривають 80% задач. Для решти 20% використовуються:
- Мультиканальна аналітика — Roistat враховує всі дотики клієнта, а не тільки перше або останнє. Моделі: лінійна, з затуханням, за позицією, кастомна.
- Когортний аналіз — виручка від клієнтів, привернених у конкретний місяць, розтягнута в часі. Показує реальний LTV.
- Звіт за менеджерами — хто з менеджерів ефективніше конвертує ліди з платного трафіку.
Для вивантаження даних в сторонні BI-системи використовується Roistat API: /project/analytics/data — повертає сирі дані по відвідуванням, лідам та угодам.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Вбудована інтеграція, одна воронка, 1-2 рекламні канали, перевірка передачі roistat_visit |
3-5 днів |
| Стандартний | Мультиворонки, коллтрекінг, 3-5 рекламних каналів, налаштування звітів | 1-2 тижні |
| Розширений | Кастомна інтеграція через REST, мультиканальна атрибуція, офлайн-конверсії, навчання команди | 2-3 тижні |
Що налаштовуємо
- Встановлення пікселю Roistat на сайт, перевірка коректності
roistat_visitв cookie - Підключення Bitrix24 до Roistat: авторизація, маппінг полів, створення
UF_CRM_ROISTAT_VISIT - Налаштування передачі номера відвідування через форми сайту (приховані поля, JavaScript)
- Маппінг стадій воронки CRM → статуси в Roistat
- Підключення рекламних кабінетів для імпорту витрат
- Налаштування коллтрекінгу: пул номерів, підмена на сайті, передача дзвінків в CRM
- Налаштування вебхуків для передачі закритих угод та сум назад в Roistat
- Перевірка наскрізного ланцюга: клік → відвідування → лід → угода → оплата → ROI
- Навчання маркетолога: читання звітів, вибір моделі атрибуції, типові помилки (втрачений
roistat_visit, угоди без суми)







