Справочник атрибутов профиля клиента

Что такое атрибут и чем он отличается от тега — в статье «Атрибуты профиля и теги».
Здесь — предметно про сами атрибуты: где их заводить, какие типы бывают и какие поля у них есть.

Раздел находится в Настройки → Данные → Атрибуты клиента.

Системные и пользовательские атрибуты

Вкладка «Системные» — четыре атрибута, которые есть в любом проекте по умолчанию и создавать которые не нужно:

АтрибутКлюч
Имяprofile_full_name
Телефонprofile_phone_number
Почтаprofile_email
Внешний IDprofile_external_id

Вкладка «Пользовательские» — всё, что вы создали сами через кнопку Создать атрибут: список с колонками # (позиция), Атрибут (название), Ключ, Тип, Показывать в профиле.

Восемь типов атрибута

ТипЧто это
stringКороткая строка
textБолее длинный текст
numberЧисло
datetimeДата/время
selectОдин вариант из заранее заданного списка значений
multiselectНесколько вариантов из заранее заданного списка значений
booleanДа/нет
uuidИдентификатор в формате UUID

Важно: тип атрибута фиксируется при создании и в форме редактирования уже не меняется

Для select и multiselect при создании появляется дополнительное поле — сюда через + Добавить значение вносится сам список вариантов, из которых потом будет выбирать бот или оператор.

Поля при создании атрибута

ПолеЧто задаёт
ТипОдин из восьми типов выше — фиксируется при создании
НазваниеНазвание для списка атрибутов и клиентского профиля
Произвольное описаниеНеобязательная заметка об атрибуте. Отображается в списке атрибутов в настройках
ГруппыК какой группе (или группам) атрибутов отнести — для удобной фильтрации списка атрибутов
ПозицияПорядок в списке атрибутов в профиле клиента
Показывать в профилеПоказывать ли атрибут в профиле клиента в чат-центре
КлючНазвание атрибута латинскими буквами для доступа к нему в сценариях — платформа сама подставляет префикс profile_, дальше дописываете суффикс

Ключ можно поменять и после создания — в отличие от типа, поле «Ключ» в форме редактирования остаётся обычным редактируемым полем.

Группы атрибутов

Группа — это просто способ организовать список атрибутов: создаётся кнопкой Создать группу, в форме только одно поле — «Название». Группы используются исключительно для фильтрации списка атрибутов (фильтр «Группа» над таблицей)

Где значения атрибутов видны дальше

Атрибуты со включённым параметром «Показывать в профиле» видны в блоке «Атрибуты клиента» в панели профиля в чат-центре — просто как пары «название: значение».