Передать данные пользователя в виджет

Скопируйте API-ключ

В аккаунте откройте раздел «Интеграции» (там же настраиваются вебхуки). Поле «API-ключ» открыто только для чтения, рядом — кнопка «Скопировать ключ»: после нажатия появится тост «API-ключ скопирован». Назначение поля кабинет поясняет дословно: «Используйте API-ключ для идентификации пользователей через JavaScript SDK или сервер-сайд API». Подробнее про сам ключ и его перегенерацию — в статье API-ключ.

Вызовите identify из JS SDK

Кабинет описывает подключение четырьмя шагами дословно: «Шаг 1. Получите API-ключ выше», «Шаг 2. Вызовите метод identify() из JS SDK», «Шаг 3. Передайте external_user_id и опциональные поля: name, email, phone», «Шаг 4. Посетитель будет связан с вашим пользователем».

Вызов на сайте выглядит так:

_nf('identify', {
  external_user_id: 'u123',
  name: 'Анна',
  email: 'anna@example.ru',
  custom: { city: 'Москва' }
});

Произвольные атрибуты передаются в объекте custom — каждый ключ сохраняется в свое поле контакта. Так, custom.city со значением «Москва» появится в карточке контакта отдельным полем, и то же самое работает для любых других пар.

Если менять код сайта неудобно, есть автосопоставление: кабинет сам подтягивает значение со страницы — по CSS-селектору, meta-тегу, data-атрибуту, параметру URL, JS-переменной, cookie или значению из localStorage — и вызывает identify без ручного кода.

Проверьте связку в списке посетителей

После identify анонимная история посетителя — визиты, сессии — связывается с контактом, а не теряется. Проверить результат можно в разделе «Аналитика» → «Посетители»: у идентифицированного посетителя в карточке появятся переданные поля.

Типовой прием для адресного показа виджетов — сегмент по полю «Внешний ID» с оператором «В списке»: тогда виджет увидят только посетители из переданного списка external_user_id. Как собрать такой сегмент — в статье сегменты.