Виджет в личном кабинете: передаём имя и почту вошедшего

Если чат стоит в личном кабинете, вы уже знаете, кто перед вами. Спрашивать почту у человека, который прямо сейчас сидит под своей учётной записью, — глупо.

Сайт может сообщить виджету, кто вошёл: имя, почту и идентификатор пользователя. Тогда форма контактов не показывается, а обращения сразу попадают в правильный контакт.

Что это даёт

• Оператор видит настоящее имя и почту, а не псевдоним.
• Вся история клиента — в одном контакте, независимо от устройства.
• Человек не заполняет форму, которую вы и так могли бы не спрашивать.
• На общем компьютере переписка не покажется следующему вошедшему.

Два способа передать

Атрибуты в коде установки — для обычных сайтов, где страница перезагружается после входа:

<script src="https://chat.deskai.ru/w.js"
        data-provider="ваш-идентификатор"
        data-user-id="42"
        data-email="ivan@example.com"
        data-name="Иван Петров"
        data-hash="подпись"
        async></script>

Вызов из кода — для личных кабинетов на JavaScript-фреймворках, где вход происходит без перезагрузки:

window.DeskAI.identify({
  userId: '42',
  email: 'ivan@example.com',
  name: 'Иван Петров',
  hash: 'подпись',
});

Вызвать identify() можно в любой момент, в том числе до того, как виджет загрузился: вызов не потеряется.

Подпись обязательна

Без неё данные игнорируются, и разговор идёт анонимно. Причина простая: всё, что передаёт страница, посетитель может подменить через инструменты разработчика — и назваться чужой почтой.

Как считать подпись — в статье Подпись данных посетителя: зачем нужен секрет и как его посчитать. Это несколько строк на вашем бэкенде.

Смена пользователя

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

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

Что настроить заодно

Режим запроса контактов поставьте в «не спрашивать»: почта у вас уже есть. См. Запрос контактов у посетителя: три режима.

Что дальше

Подпись данных посетителя: зачем нужен секрет и как его посчитать.