# Пользовательские поля

Source: https://docs.botman.pro/a/180-polzovatelskie-polya

**Пользовательские поля** — это переменные, в которых бот хранит данные конкретного пользователя.\
Они позволяют сохранять ответы, введённые пользователем, и использовать их дальше в логике бота, воронках, сообщениях и интеграциях.

### Пример использования

Представим, что у вас турагентство. В бот зашло 10 разных пользователей, и каждый ответил на вопрос:

> «Какой у вас бюджет на путешествие?»

Бот:

- сохранит ответ каждого человека в его собственное пользовательское поле;
- при открытии диалога вы увидите индивидуальные данные каждого пользователя;
- сможете использовать эти данные дальше по воронке — например, подставлять бюджет в сообщения, пересылать эти данные себе или в google таблицу.

## Где находятся пользовательские поля

Все пользовательские поля доступны в разделе:

Настройки → Пользовательские поля

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/0d11b36e1e190b5ba79eec94d9ad265522c018587794cd56a4e81b503fb5b9d8.png)

## Доступные действия с пользовательскими полями

Для каждого пользовательского поля доступны следующие действия:

- ✅ Создание
- ✍🏻Редактирование
- 📋 Копирование
- 🗑 Удаление

Управление действиями осуществляется через меню (три точки) справа от поля.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/0397d41005f7f214858958b439665e2edf5a6df1cb9e6c95440bfcee7bb18bd6.png)

## Создание пользовательского поля

Чтобы создать новое пользовательское поле:

1. Перейдите в Настройки → Пользовательские поля
2. Нажмите Добавить поле
3. Заполните параметры поля

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/5d8fd94d9c4a253dba560ab426b02610c7b4ffecf036f80c27c312f98e0d0644.png)

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

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/95ae94e79295e7a66381f48f4143f11a8a1becbaae42b03b609e824afa19b6a3.png)

### Название поля

- Обязательное для заполнения
- Можно использовать:

  - буквы (кириллица и латиница),
  - цифры,
  - нижнее подчёркивание (\_)

### Тип поля

- Обязательный параметр
- Можно выбрать только один тип
- ⚠️ После создания тип поля изменить **невозможно**

### Необязательный параметр

### Описание

- Используется для внутренних комментариев
- Видно только вам
- Не влияет на работу бота

## Типы пользовательских полей

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/7b0ba1652333a5b1676406acaa146cee811ed17d0fc9f09b88dce0cdaa0c37a3.png)

В Botman доступны следующие типы пользовательских полей:

### **1. Текст**

Используется для хранения любой текстовой информации:

- имена,
- комментарии,
- ответы в свободной форме,
- любые символы и буквы,
- картинки и видео.

### **2. Число**

Хранит числовые значения:

- целые,
- дробные.

Подходит для:

- бюджета,
- количества,
- рейтингов,
- сумм.

### **3. Дата**

Используется для ввода только даты, без времени.

- Выбор значения:

  - через календарь
  - или ручной ввод
- Формат хранения:\
  DD-MM-YYYY

### **4. Дата и время**

Используется для ввода даты с указанием времени.

- Выбор значения:

  - через календарь,
  - или ручной ввод
- Формат хранения:\
  DD-MM-YYYY HH:MM

### **5. Вложение**

Используется для хранения файлов и медиа:

- изображения,
- видео,
- другие вложения.

Часто применяется при:

- сборе документов,
- получении фотографий.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/100bc8467698f5ec2b8415d220e55b42bc5942d1bd679896a7401f269eaeaf99.png)

### 6. Массив

Массив хранит список значений одного типа у конкретного подписчика. Он подходит для корзины, избранного, выбранных дат и других данных, где одного значения недостаточно.

При создании массива выберите тип его элементов: текст, число, дата, дата и время или объект. Тип элементов задаётся при создании поля.

Значение пользовательского массива заполняется в сценарии через шаг «Действия». В нём можно установить весь список, добавить элемент, удалить элемент по индексу или значению и очистить поле.

Подробнее: [«Массивы: создание, формат и использование»](https://docs.botman.pro/a/192-massivy-sozdanie-format-i-ispolzovanie), [«Действия с массивами»](https://docs.botman.pro/a/245-deystviya-s-massivami) и [«Проверка массива»](https://docs.botman.pro/a/182-proverka-massiva).

## Использование пользовательских полей в боте

После создания пользовательского поля вы можете:

- записывать в него ответы пользователя;
- выводить сохранённые значения в сообщениях;
- использовать поля в условиях, воронках и логике бота.

Все операции с пользовательскими полями доступны непосредственно в редакторе бота.

## Редактирование пользовательского поля

При редактировании пользовательского поля можно изменить:

- Название
- Описание

⚠️Тип поля изменить **нельзя** — если нужен другой тип, необходимо создать новое поле.

## Удаление пользовательского поля

При удалении пользовательского поля:

- оно исчезает из всех мест использования;
- все сохранённые данные удаляются без возможности восстановления.

❗ Рекомендуется удалять поля только в том случае, если они больше не используются в логике бота.

## Итог

**Пользовательские поля** — это ключевой инструмент для персонализации чат-ботов в Botman.\
Они позволяют:

- сохранять данные пользователей;
- строить гибкие сценарии;
- автоматизировать работу с клиентами;
- делать общение с ботом максимально персональным.

Используйте пользовательские поля, чтобы ваши боты стали умнее и эффективнее! 🚀