Документация / Передача данных в «Прямой Диалог»

Проверка и частые ошибки

Порядок приёмки #

Зайти на сайт под тестовым пользователем и написать в чат. В панели → «Сайты» → «Проверить» с ID посетителя видны его ключи.
Выйти из аккаунта (logout) — ключи исчезли; войти под другим — появились новые.
Если сделан setData — открыть диалог: в шапке строка «Заказ: RU-554433», ссылка кликабельна, value: null убирает поле.
«Проверить» для посетителя с меткой — ответ 200, принята 1 метка, expires_at совпадает с вашим сроком.
Для посетителя без метки — marks: [], строка в списке обычная.
Запрос с неверной подписью или старым timestamp (curl вручную) — 401.
Источник данных недоступен — 503, у уже выделенных посетителей выделение сохранилось.
Изменение статуса, пока посетитель на сайте, — в течение ~30 секунд строка в «Кто на сайте» поменяла вид, посетитель поднялся вверх, у диалога появилась полоса.
Уведомление с неверной подписью — 401; с верной на неизвестный ключ — 202.
Чат недоступен — основной сценарий сайта (оплата, вход) проходит как обычно, в логе запись об ошибке уведомления.

Что обычно идёт не так #

Симптом	Причина
Ключи не доходят, в консоли `[DirectDialog] …`	Формат ключа: кириллица, пробел, слишком длинное значение или нет пространства перед двоеточием
Ключи видны в «Проверить», но метки нет	Пустой адрес проверки в панели, либо эндпоинт ответил не-200 — посмотрите статус и время ответа там же
Эндпоинт отвечает 401 на наш запрос	Подпись считается по сырому телу и строке `<timestamp>.<тело>`; фреймворк, который парсит и пересобирает JSON, ломает байты
«Проверить» показывает ошибку редиректа	Адрес отвечает `301/302` (слэш, `www`, http→https). Нужен конечный адрес
Метка появляется и пропадает	Часть ответов — ошибки: при ошибке метки сохраняются, при следующем удачном пустом ответе снимаются. Проверьте таймаут 3 секунды
Цвет не применился	Принимается только hex (`#2e9e7a`); `rgb()`, `var()` и имена цветов игнорируются
Ключи перестали учитываться после включения строгого режима	Включена галочка «Доверять только подтверждённым ключам», а страница передаёт ключи без `token`

Прямой Диалог · передача данных о посетителе · протокол visitor.marks, версия 2