Інтеграція Bitrix24 з Calltouch
Відділ маркетингу запускає рекламу в Директі та Google Ads, на сайті вказаний один номер телефону. Дзвінки приходять, менеджери обробляють. Але який дзвінок прийшов з реклами, а який — від постійного клієнта? Скільки дзвінків привніс конкретний банер? Без коллтрекінгу ці питання залишаються без відповіді. Calltouch підміняє номери на сайті і пов'язує кожен дзвінок з рекламним джерелом. Інтеграція з Bitrix24 доводить ці дані до CRM — лід створюється з прив'язкою до каналу, кампанії та ключового слова.
Принцип роботи Calltouch
Calltouch використовує динамічну підмену номерів (Dynamic Number Insertion). На сайт встановлюється скрипт, який замінює основний номер телефону на підмінний — унікальний для кожного відвідувача або групи джерел.
Два режими підмени:
- Динамічний коллтрекінг. Кожен відвідувач бачить свій номер. Calltouch прив'язує номер до сесії: знає utm-метки, ключове слово, сторінку входу. Точність максимальна, але потрібен пул номерів.
- Статичний коллтрекінг. Один номер закріплюється за одним джерелом (наприклад, окремий номер для Директу, окремий для SEO). Дешевше, але без деталізації до ключового слова.
При дзвінку Calltouch фіксує: номер того, хто дзвонить, підмінний номер (визначає джерело), тривалість, статус (відповідено/пропущено), запис розмови.
Передача дзвінків в Bitrix24
Calltouch передає дані про дзвінки в CRM двома шляхами:
| Параметр | Вбудована інтеграція | Через REST API (кастомна) |
|---|---|---|
| Підключення | Кабінет Calltouch → Інтеграції → Bitrix24 | Вебхук з Calltouch → обробник → REST API Б24 |
| Створення лідів | Автоматично при вхідному дзвінку | Через crm.lead.add з довільними полями |
| Джерело в CRM | Передає utm_source, utm_medium, utm_campaign |
Повний контроль: utm + ключове слово + сторінка |
| Запис розмови | Посилання в карточці дзвінку | telephony.externalcall.attachRecord |
| Пропущені дзвінки | Створення лід з позначкою "пропущено" | Кастомна логіка: завдання менеджеру + лід |
Вбудована інтеграція підключається за годину: в кабінету Calltouch вказуються URL портала та токен REST API. Calltouch при кожному дзвінку відправляє запит в Б24 — створюється лід з заповненими UTM-полями та записом розмови.
Для розширених сценаріїв використовується Calltouch Journal API — отримуємо повну історію дзвінків з деталізацією.
Journal API: синхронізація історії дзвінків
Journal API — основний інструмент для глибокої інтеграції. Endpoint /calls/journal повертає масив дзвінків за вказаний період з повною атрибуцією:
-
callerNumber— номер того, хто дзвонить -
source— джерело трафіку -
utmSource,utmMedium,utmCampaign,utmContent,utmTerm -
keyword— ключове слово з рекламної системи -
duration— тривалість в секундах -
callUrl— URL запису розмови -
waitDuration— час очікування на лінії -
status— успішний, пропущений, зайнято
Типовий сценарій: cron-задача кожні 5 хвилин опитує Journal API, отримує нові дзвінки і створює записи в Б24. Для кожного дзвінку:
- Пошук контакту за номером:
crm.contact.listз фільтромPHONE. - Контакт знайдено — реєстрація дзвінку через
telephony.externalcall.registerз прив'язкою до контакту. - Контакт не знайдено — створення лід через
crm.lead.addз заповненням UTM-полів та користувацьких полів. - Прив'язка запису розмови:
telephony.externalcall.attachRecordз URL зcallUrl.
Користувацькі поля для даних Calltouch:
-
UF_CRM_CT_SOURCE— джерело з Calltouch -
UF_CRM_CT_KEYWORD— ключове слово -
UF_CRM_CT_LANDING— сторінка, з якої дзвонили
Callback-віджет
Calltouch надає віджет зворотного дзвінку: відвідувач залишає свій номер, система дзвонить менеджеру і з'єднує з клієнтом. Дані callback-запитів також передаються в CRM — лід створюється до того, як менеджер зняв трубку.
Інтеграція callback-віджету з Б24:
- При запиті зворотного дзвінку Calltouch відправляє вебхук з номером клієнта та даними сесії.
- Обробник створює лід в CRM з позначкою "Зворотний дзвінок" та UTM-метками.
- Після з'єднання Calltouch оновлює запис: тривалість, статус, посилання на запис.
Офлайн-конверсії
Calltouch дозволяє передати назад результати обробки дзвінків — для оптимізації реклами в Яндекс.Директ та Google Ads. Коли угода в Б24 закривається як успішна, вебхук onCrmDealUpdate відправляє дані в Calltouch через API /calls/offline-conversion. Рекламна система отримує сигнал: цей клік привів до оплати — і оптимізує покази.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Вбудована інтеграція, створення лідів з дзвінків, запис розмов | 2-3 дні |
| Стандартний | Journal API, користувацькі поля, callback-віджет, маппінг джерел | 1 тиждень |
| Розширений | Офлайн-конверсії, мультиворонки, кастомні звіти, навчання | 1-2 тижні |
Що налаштовуємо
- Підключення Calltouch до Bitrix24: авторизація, вибір режиму інтеграції
- Створення користувацьких полів в CRM для даних коллтрекінгу
- Налаштування логіки створення лідів: дедублікація за номером телефону, обробка повторних дзвінків
- Інтеграція через Journal API: скрипт синхронізації, cron-задача, обробка помилок
- Підключення callback-віджету з передачею даних в CRM
- Прив'язка записів розмов до карточок CRM
- Налаштування передачі офлайн-конверсій для оптимізації реклами
- Тестування: вхідний дзвінок з підмінного номера → лід в CRM з UTM → запис розмови в таймлайні
- Навчання: читання звітів по дзвінкам, контроль пропущених, аналіз джерел