Кроме серверного REST API, у RetailCRM есть браузерные JS API: Consultant управляет чат-виджетом, а Tracker собирает поведение посетителей и связывает его с клиентами CRM. Оба работают на стороне сайта и дополняют серверную интеграцию данными о реальных действиях пользователей.
Два клиентских API и их роли
JS API RetailCRM решают разные задачи, но оба живут в браузере посетителя:
- Consultant JS API — программное управление виджетом онлайн-консультанта: открыть чат, подставить данные, реагировать на события диалога;
- Tracker (Daemon Collector) — сбор поведения на сайте: просмотры, корзина, оформление, идентификация посетителя для связи с профилем в CRM.
В связке они дают картину: Tracker фиксирует, что делал посетитель, а Consultant позволяет вовремя вовлечь его в диалог. Данные с обоих обогащают клиентский профиль в CRM наравне с заказами из REST API.
Установка скриптов на сайт
Оба инструмента подключаются вставкой асинхронного сниппета в разметку страницы. Виджет и трекер получают в интерфейсе CRM свой код, привязанный к аккаунту. Общая схема установки:
- получить код виджета Consultant в настройках онлайн-консультанта;
- получить код Tracker (Daemon Collector) в настройках сбора данных;
- вставить сниппеты перед закрывающим
</body>на всех страницах; - убедиться, что скрипт грузится асинхронно и не блокирует рендер.
После установки на странице появляется глобальный объект, через который вызываются методы API. Инициализацию своих обработчиков лучше откладывать до готовности этого объекта, чтобы не обращаться к нему раньше загрузки.
Consultant JS API: управление чатом
Consultant API позволяет управлять виджетом из кода сайта, а не только полагаться на стандартное поведение. Типовые возможности:
- программно открыть или закрыть окно чата;
- предзаполнить контактные данные посетителя (имя, email, телефон);
- отправить служебные данные о контексте страницы;
- подписаться на события: открытие диалога, отправка сообщения, старт чата.
Например, кнопка «Задать вопрос» на карточке товара может открывать чат и передавать в него артикул товара, чтобы менеджер сразу видел контекст. Событийная модель даёт триггерить свою аналитику: считать, сколько посетителей начали диалог с конкретной страницы.
Tracker: сбор поведения и события
Tracker (Daemon Collector) собирает поведенческие события и отправляет их в CRM. Помимо автоматического отслеживания просмотров, вы явно сообщаете о значимых действиях через методы трекера:
| Событие | Смысл |
|---|---|
| Просмотр товара | Посетитель открыл карточку |
| Действия с корзиной | Добавление и изменение состава корзины |
| Оформление | Начало и завершение оформления заказа |
| Идентификация | Передача контактов известного клиента |
Вызовы имеют вид _rc('send', 'event', {...}) или аналогичной обёртки, где вы передаёте тип события и его параметры. Эти данные формируют динамические сегменты и триггеры — например, брошенная корзина.
Идентификация посетителя
Ценность Tracker раскрывается, когда анонимные события связываются с конкретным клиентом. Для этого при авторизации на сайте или оформлении заказа трекеру передают идентификатор клиента:
_rc('send', 'setCustomerId', {externalId: 'u-501'})
После идентификации поведение посетителя привязывается к профилю в CRM, и история просмотров и корзин дополняет карточку клиента. Согласованность externalId между сайтом, Tracker и REST API — то же самое условие целостности, что и в серверных интеграциях.
Производительность и приватность
Поскольку скрипты работают у каждого посетителя, важны нюансы фронтенда:
- грузите сниппеты асинхронно, чтобы не тормозить рендер и не портить метрики скорости;
- не передавайте в события лишние персональные данные — только то, что нужно для сценария;
- учитывайте баннер согласия на cookies: трекинг должен уважать выбор пользователя;
- тестируйте на мобильных, где виджет чата занимает заметную часть экрана.
Грамотная настройка даёт полезную аналитику и вовлечение, не превращаясь в источник тормозов или юридических рисков.
Итог
JS API RetailCRM — это Consultant для управления чат-виджетом и Tracker для сбора поведения и идентификации посетителей. Оба подключаются сниппетами, работают в браузере и обогащают клиентский профиль данными о действиях на сайте, дополняя серверный REST API. Ключевые условия — согласованный externalId, асинхронная загрузка и уважение к приватности.
Мы связываем сайт на 1С-Битрикс с RetailCRM целиком: серверный обмен через API v5 и клиентские JS API с корректной идентификацией и триггерами. Если нужно, чтобы поведение на сайте и коммуникации работали как единая система с CRM, поможем это выстроить.
Частые вопросы
Чем Consultant отличается от Tracker?
Consultant управляет чат-виджетом (открыть диалог, подставить данные, ловить события), а Tracker собирает поведение посетителей и идентифицирует их для связи с CRM.
Заменяют ли JS API серверный REST?
Нет. Они работают в браузере и обогащают профиль поведенческими данными. Критичные операции вроде создания заказов проводят через серверный API v5.
Как связать поведение с конкретным клиентом?
Передать трекеру идентификатор клиента (например, externalId) при авторизации или оформлении. После этого события привяжутся к профилю в CRM.
Как подключить виджет и трекер?
Вставить асинхронные сниппеты из настроек CRM перед закрывающим тегом body на всех страницах и инициализировать обработчики после загрузки объекта.
Какие события отправляет Tracker?
Просмотры товаров, действия с корзиной, шаги оформления и идентификацию посетителя. Они формируют сегменты и триггеры вроде брошенной корзины.
Нужно ли учитывать согласие на обработку данных?
Да. Идентификация и трекинг — обработка персональных данных, поэтому нужны правовое основание, информирование и уважение к выбору пользователя по cookies.
Влияют ли скрипты на скорость сайта?
При асинхронной загрузке влияние минимально. Важно не блокировать рендер и не передавать в события избыточные данные.
Поможем с настройкой и поддержкой Для разработчиков
Поможем с настройкой, доработкой и поддержкой Для разработчиков.