Пользовательские поля
Что такое пользовательские поля и зачем они нужны
Пользовательские поля — это переменные, в которых бот хранит данные конкретного пользователя.
Они позволяют сохранять ответы, введённые пользователем, и использовать их дальше в логике бота, воронках, сообщениях и интеграциях.
Пример использования¶
Представим, что у вас турагентство. В бот зашло 10 разных пользователей, и каждый ответил на вопрос:
«Какой у вас бюджет на путешествие?»
Бот:
сохранит ответ каждого человека в его собственное пользовательское поле;
при открытии диалога вы увидите индивидуальные данные каждого пользователя;
сможете использовать эти данные дальше по воронке — например, подставлять бюджет в сообщения, пересылать эти данные себе или в google таблицу.
Где находятся пользовательские поля¶
Все пользовательские поля доступны в разделе:
Настройки → Пользовательские поля

Доступные действия с пользовательскими полями¶
Для каждого пользовательского поля доступны следующие действия:
✅ Создание
✍🏻Редактирование
📋 Копирование
🗑 Удаление
Управление действиями осуществляется через меню (три точки) справа от поля.

Создание пользовательского поля¶
Чтобы создать новое пользовательское поле:
Перейдите в Настройки → Пользовательские поля
Нажмите Добавить поле
Заполните параметры поля

Обязательные параметры¶

Название поля¶
Обязательное для заполнения
Можно использовать:
буквы (кириллица и латиница),
цифры,
нижнее подчёркивание (_)
Тип поля¶
Обязательный параметр
Можно выбрать только один тип
⚠️ После создания тип поля изменить невозможно
Необязательный параметр¶
Описание¶
Используется для внутренних комментариев
Видно только вам
Не влияет на работу бота
Типы пользовательских полей¶

В Botman доступны следующие типы пользовательских полей:
1. Текст¶
Используется для хранения любой текстовой информации:
имена,
комментарии,
ответы в свободной форме,
любые символы и буквы,
картинки и видео.
2. Число¶
Хранит числовые значения:
целые,
дробные.
Подходит для:
бюджета,
количества,
рейтингов,
сумм.
3. Дата¶
Используется для ввода только даты, без времени.
Выбор значения:
через календарь
или ручной ввод
Формат хранения:
DD-MM-YYYY
4. Дата и время¶
Используется для ввода даты с указанием времени.
Выбор значения:
через календарь,
или ручной ввод
Формат хранения:
DD-MM-YYYY HH:MM
5. Вложение¶
Используется для хранения файлов и медиа:
изображения,
видео,
другие вложения.
Часто применяется при:
сборе документов,
получении фотографий.

6. Массив¶
Массив хранит список значений одного типа у конкретного подписчика. Он подходит для корзины, избранного, выбранных дат и других данных, где одного значения недостаточно.
При создании массива выберите тип его элементов: текст, число, дата, дата и время или объект. Тип элементов задаётся при создании поля.
Значение пользовательского массива заполняется в сценарии через шаг «Действия». В нём можно установить весь список, добавить элемент, удалить элемент по индексу или значению и очистить поле.
Подробнее: «Массивы: создание, формат и использование», «Действия с массивами» и «Проверка массива».
Использование пользовательских полей в боте¶
После создания пользовательского поля вы можете:
записывать в него ответы пользователя;
выводить сохранённые значения в сообщениях;
использовать поля в условиях, воронках и логике бота.
Все операции с пользовательскими полями доступны непосредственно в редакторе бота.
Редактирование пользовательского поля¶
При редактировании пользовательского поля можно изменить:
Название
Описание
⚠️Тип поля изменить нельзя — если нужен другой тип, необходимо создать новое поле.
Удаление пользовательского поля¶
При удалении пользовательского поля:
оно исчезает из всех мест использования;
все сохранённые данные удаляются без возможности восстановления.
❗ Рекомендуется удалять поля только в том случае, если они больше не используются в логике бота.
Итог¶
Пользовательские поля — это ключевой инструмент для персонализации чат-ботов в Botman.
Они позволяют:
сохранять данные пользователей;
строить гибкие сценарии;
автоматизировать работу с клиентами;
делать общение с ботом максимально персональным.
Используйте пользовательские поля, чтобы ваши боты стали умнее и эффективнее! 🚀