Интеграции онлайн чата

Онлайн-чат поддерживает интеграции с системами аналитики и другими сервисами. Настройки интеграций находятся в личном кабинете: «Индивидуальные настройки» → «Интеграции».

1. Яндекс Метрика: события и цели

Для учёта обращений установите счётчик Метрики на сайт и настройте интеграцию чата. В разделе «Цели» создайте цель типа «Целевое событие»; в интерфейсах, где используется прежнее название, — «JavaScript-событие». Выберите условие «совпадает» и укажите полный идентификатор из списка ниже, сохраняя регистр.

• CHAT_SHOW_ON_BTN — открытие чата кнопкой.
• CHAT_SHOW_ON_INVITATION — открытие чата через автоприглашение.
• CHAT_INVITATION_CLOSE — закрытие автоприглашения.
• CHAT_FIRST_MESSAGE — первое сообщение посетителя в чат.
• CHAT_OFFLINE_MESSAGE — отправка сообщения через офлайн-форму, когда операторы недоступны.
• CHAT_VISITOR_INTRODUCED — отправка контактных данных через предусмотренную виджетом форму.
• CHAT_OPERATOR_CONNECT — подключение оператора к диалогу.
• UNIQUE_LEAD — единая цель оставления контактов; по логике интеграции учитывается один раз для одного посетителя. Её фактическую кратность проверьте при настройке.

Открытие окна чата ещё не является обращением или лидом. Первое сообщение и отправка контактов — разные действия. Email или телефон, написанный обычным сообщением, не заменяет проверку контактной формы и не гарантирует событие CHAT_VISITOR_INTRODUCED.

Создание цели в Метрике само по себе не отправляет событие: его должна передать интеграция. Если отправка уже настроена в виджете, не добавляйте второй обработчик того же действия без проверки. Отсутствие отдельной цели в отчёте не доказывает, что виджет не передаёт событие. Создавайте цели для тех сценариев, которые планируете учитывать.

Офлайн-форма чата отправляется с сайта через интернет; это не загрузка «офлайн-конверсий» в Метрику.

Официальная инструкция Метрики по целевым событиям.

2. Google Analytics 4

Для GA4 используйте события настроенного веб-потока. Прежнее описание интеграции через категорию ChatService и действия не является инструкцией настройки GA4. Само наличие Google Analytics на сайте не подтверждает передачу событий чата.

Сначала проверьте, какие события фактически доступны в вашей интеграции. Если передаёте их через Google Tag Manager, настройте соответствие события чата и события GA4, затем проверьте отправку. Названия в Метрике и Google Tag Manager различаются: например, CHAT_FIRST_MESSAGE и ChatFirstMessage.

Для проверки используйте режим предварительного просмотра Google Tag Manager / Tag Assistant и отчёт DebugView в GA4 с включённым режимом отладки для тестового устройства. Проверьте, что нужное действие даёт одно ожидаемое событие. Только после проверки выбирайте события обращений, которые будете учитывать как ключевые.

Официальная инструкция Google по DebugView.

3. Google Tag Manager и проверка дублей

В интеграции с Google Tag Manager используются следующие имена событий. Перед настройкой тегов проверьте их появление в режиме предварительного просмотра контейнера:

• ChatShowOnBtn — открытие чата кнопкой.
• ChatShowOnInvitation — открытие через автоприглашение.
• ChatInvitationClose — закрытие автоприглашения.
• ChatFirstMessage — первое сообщение.
• ChatOfflineMessage — отправка офлайн-формы.
• ChatVisitorIntroduced — отправка контактной формы.
• ChatOperatorConnect — подключение оператора.
• UniqueLead — единая цель оставления контактов.

Для передачи одного действия в одну систему аналитики выберите один путь: встроенную интеграцию либо тег Google Tag Manager. Одновременная прямая отправка и отправка через GTM могут задвоить событие. Не настраивайте цель первого сообщения на каждую отправку сообщения.

Как проверить настройку

1. Запишите время теста и откройте чат. Убедитесь, что простое открытие не учитывается как обращение.
2. Отправьте первое тестовое сообщение, затем второе в том же диалоге. Проверьте получение сообщений в кабинете оператора и количество достижений цели первого сообщения: повторное сообщение не должно создавать ещё одно первое сообщение в этом диалоге.
3. Пройдите автоматический запрос контактов, если он включён. Проверьте сохранение данных в карточке посетителя и соответствующие события. Один ввод в поле без подтверждения отправки не считается успешным тестом.
4. Для офлайн-теста согласуйте время и переведите всех операторов в офлайн, включая мобильные приложения. Обновите страницу и убедитесь, что появилась офлайн-форма. Отправьте помеченную тестовую заявку, проверьте подтверждение и её получение в предусмотренном канале, затем верните операторов онлайн.
5. Сопоставьте время теста с отчётом «Конверсии» в Метрике или DebugView в GA4. Сравнивайте достижения цели за интервал теста, а не общий итог за день или только число целевых визитов. Проверяйте контактные и офлайн-события отдельно.

Письмо или сообщение в кабинете подтверждает доставку обращения, но не приём события системой аналитики. Не передавайте в параметры аналитических событий текст переписки, имя, телефон или email посетителя. Используйте тестовые данные и не публикуйте контакты из проверок.

4.Рейтинг Mail.ru:

Наш сервис автоматически отправляет в Рейтинг Mail.Ru цели со следующими именами:

ChatShowOnBtn — при нажатии на кнопку;

ChatShowOnInvitation — при нажатии на автоприглашение;

ChatInvitationClose — при закрытии автоприглашения;

ChatFirstMessage — при первом сообщении в чат;

ChatOfflineMessage — при оффлайн сообщении;

ChatVisitorIntroduced — при отправке контактных данных;

ChatOperatorConnect — при подключении оператора к чату;

UniqueLead — единая цель, отправляется, когда посетитель оставляет контакты в онлайн чате; отправляется только один раз для одного посетителя.

5.Yagla:

Мы автоматически отправляем событие начале общения в онлайн чате в систему подмены динамического контента Ягла.

6. Почтовые сервисы: MailerLite, GetResponse, MailChimp, SendPulse, JustClick, Unisender, Mail365.

Эти сервис отправляет Email посетителя, оставившего контактные данные в чате.

7. Платежная система: Яндекс.Касса.

8. WebHooks:

Передаваемые события:

• Отправка заявки из оффлайн формы (телефон, имя, почта, сообщение)
• Отправка заявки из онлайн форм (телефон, имя, почта)
• Отправка из чата

Передаваемые параметры:

webhooktype — тип события (4 — отправка заявки);

phone — телефон клиента;

name — имя клиента;

email — email клиента;

created_at — время заявки по Московскому времени;

referrer — откуда пришел;

keyword — что искал;

ip — IP-адрес;

place — местоположение клиента;

site — адрес сайта, на котором оставил заявку;

url — адрес страницы, на которой оставил заявку;

utm_source — метка utm_source;

utm_medium — метка utm_medium;

utm_campaign — метка utm_campaign;

utm_content — метка utm_content;

utm_term — метка utm_term;

adv_uid — параметр uid сервиса advertise.ru;

calltracking_id — идентификатор сайта в сервисе CallTracking.ru

9. OgnemetCRM;

10. Roistat:

В сервис Roistat передаются все данные о заявке из чата. Если в RoiStat настроена интеграция с CRM системой, данные передаются в CRM.

11. АmoCRM:

Передаваемая информация:

• телефон клиента;
• имя клиента;
• email клиента;
• сообщение клиента;
• время отправки заявки по Московскому времени;
• откуда пришел;
• что искал;
• IP-адрес;
• местоположение клиента;
• адрес страницы, на которой оставил заявку;
• метка utm_source;
• метка utm_medium;
• метка utm_campaign;
• метка utm_content;
• метка utm_term;
• Google UserID.

12. Bitrix 24:

Передаваемая информация:

• телефон клиента;
• имя клиента;
• email клиента;
• сообщение клиента;
• время отправки заявки по Московскому времени;
• откуда пришел;
• что искал;
• IP-адрес;
• местоположение клиента;
• адрес страницы, на которой оставил заявку;
• как появилась форма;
• метка utm_source;
• метка utm_medium;
• метка utm_campaign;
• метка utm_content;
• метка utm_term;
• Google UserID.

11. U-on Travel:

Передает все полученные данные о заявке в систему.

12. RetailCRM;

Интеграции онлайн чата доступны в платной версии (990 рублей для России, 250 гривен для Украины, 3750 тенге для Казахстана)

Посмотреть подробные инструкции Вы можете в личном кабинете, во вкладке «Индивидуальные настройки» — «Интеграции»