Интеграция Битрикс24 с Calltouch
Отдел маркетинга запускает рекламу в Директе и Google Ads, на сайте указан один номер телефона. Звонки идут, менеджеры обрабатывают. Но какой звонок пришёл с рекламы, а какой — от постоянного клиента? Сколько звонков принёс конкретный баннер? Без коллтрекинга эти вопросы остаются без ответа. Calltouch подменяет номера на сайте и связывает каждый звонок с рекламным источником. Интеграция с Битрикс24 доводит эти данные до CRM — лид создаётся с привязкой к каналу, кампании и ключевому слову.
Принцип работы Calltouch
Calltouch использует динамическую подмену номеров (Dynamic Number Insertion). На сайт устанавливается скрипт, который заменяет основной номер телефона на подменный — уникальный для каждого посетителя или группы источников.
Два режима подмены:
- Динамический коллтрекинг. Каждый посетитель видит свой номер. Calltouch привязывает номер к сессии: знает utm-метки, ключевое слово, страницу входа. Точность максимальная, но требуется пул номеров.
- Статический коллтрекинг. Один номер закрепляется за одним источником (например, отдельный номер для Директа, отдельный для SEO). Дешевле, но без детализации до ключевого слова.
При звонке Calltouch фиксирует: номер звонящего, подменный номер (определяет источник), длительность, статус (отвечен/пропущен), запись разговора.
Передача звонков в Битрикс24
Calltouch передаёт данные о звонках в CRM двумя путями:
| Параметр | Штатная интеграция | Через REST API (кастомная) |
|---|---|---|
| Подключение | Кабинет Calltouch → Интеграции → Битрикс24 | Вебхук из 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 к Битрикс24: авторизация, выбор режима интеграции
- Создание пользовательских полей в CRM для данных коллтрекинга
- Настройка логики создания лидов: дедупликация по номеру телефона, обработка повторных звонков
- Интеграция через Journal API: скрипт синхронизации, cron-задача, обработка ошибок
- Подключение callback-виджета с передачей данных в CRM
- Привязка записей разговоров к карточкам CRM
- Настройка передачи офлайн-конверсий для оптимизации рекламы
- Тестирование: входящий звонок с подменного номера → лид в CRM с UTM → запись разговора в таймлайне
- Обучение: чтение отчётов по звонкам, контроль пропущенных, анализ источников