Кастомеры: как настроить

Кастомеры
Версия: v2Дата: 15.06.2026

Когда нужна настройка

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

Кастомеры: где находятся настройки
Откройте /projects/{projectUuid}/customers и /settings/customer-fields и проверьте, что выбран правильный проект.

Что настраивать

Настраиваются custom fields проекта: fieldKey, label, тип TEXT/NUMBER/BOOLEAN/DATETIME/JSON и обязательность.

  1. Изменяйте один параметр за раз.
  2. Сохраняйте изменение и сразу проверяйте результат.
  3. Не редактируйте env вручную: runtime-конфигурацию должен формировать CLI.
  4. Не вставляйте секреты в описание или публичные поля.
Кастомеры: параметры
Перед сохранением проверьте обязательные поля, предупреждения и выбранные переключатели.

Проверка после настройки

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

Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → cdp_customer; события связаны через customerUUID, uuidVisitor, softId, email, phone и fingerprint. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.

Кастомеры: проверка настройки
После сохранения выполните тестовое действие и проверьте статус в интерфейсе.