Что это даёт и как устроено
По умолчанию чат знает о посетителе только то, что видно из браузера: город, устройство, страницу. Сайт знает больше — кто вошёл в личный кабинет, что он купил, какой у него тариф. Передав это чату, вы получаете:
- оператор видит имя, тариф и номер заказа прямо в шапке диалога — не нужно спрашивать «представьтесь, пожалуйста»;
- один и тот же человек с телефона и компьютера склеивается в одного собеседника: история переписки не теряется;
- важных клиентов видно в списке — своим цветом, бейджем и подъёмом наверх;
- поиск в панели находит диалог по номеру заказа или идентификатору клиента.
Четыре канала #
Работа делится на фронтенд (каналы 1 и 1б — несколько строк на странице) и бэкенд (каналы 2 и 3 — нужны, только если вы хотите выделять посетителей метками).
| Канал | Направление | Когда | Что передаёт |
|---|---|---|---|
| 1. Ключи посетителя | страница сайта → виджет | при загрузке страницы и при входе/выходе из аккаунта | кто это у вас: user:98765 |
| 1б. Данные посетителя необязательно |
страница сайта → виджет | когда страница узнала значение или оно изменилось | поля «подпись — значение» для шапки диалога |
| 2. Проверка посетителя необязательно |
«Прямой Диалог» → сервер сайта | изменились ключи; истёк ttl прошлого ответа; пришло уведомление |
запрос: ключи · ответ: метки |
| 3. Уведомление об изменении необязательно |
сервер сайта → «Прямой Диалог» | оплата, смена тарифа, любое событие, меняющее метку | только ключи, у которых что-то изменилось |
Истина о посетителе всегда в одном месте — в ответе вашего сервера на канал 2. Уведомление (канал 3) данных не содержит: оно лишь говорит «перепроверь этих посетителей». Потерялось уведомление — выделение всё равно обновится при следующей плановой проверке.
Что нужно взять в панели #
Меню в правом верхнем углу панели → «Сайты» → карточка вашего сайта → блок «Интеграция: метки посетителей». Там же кнопка «Проверить», которой удобно отлаживаться.
| Поле в панели | Зачем |
|---|---|
| Адрес проверки посетителя | Куда чат будет слать запрос канала 2. Пусто — проверка выключена, метки не работают |
| Серверный секрет | Ключ подписи каналов 2 и 3. Живёт в конфигурации вашего сервера, не в git и не на странице |
| Секрет подписи личности | Только если вы подтверждаете ключи токеном (подтверждение ключей) |
| Доверять только подтверждённым ключам | Ключи без подписи не учитываются — см. подтверждение ключей |
Ключи — минимум, метки — по желанию. Каналы 1 и 1б работают сами по себе: оператор увидит, кто пишет, и найдёт диалог поиском. Эндпоинт и уведомления нужны только тем, кто хочет выделять посетителей цветом и поднимать их наверх списка.