# Добавление записи в список

Добавляет в список новую запись из переменных, данных контакта и текста. Может обновить существующую запись вместо добавления.

![Панель настроек блока «Добавление записи в список»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/07-lists/_images/list-write-item.webp?v=1791781230)

## Настройки

- **«Список»** — куда писать.
- **«Соотношение переменных и полей»** — что в какое поле записать. Слева значение, справа поле списка. Значение добавляется одной из кнопок:
  - «Переменная» — переменная контакта, укажите её имя;
  - «Глобальная переменная» — глобальная переменная бота;
  - «Константа» — данные контакта: «ID», «ID мессенджера», «Bot ID», «Username», «Имя», «Телефон», «Email», «Адрес», «Текущая дата», «Referrer ID»;
  - «Текст» — произвольный текст, в нём работают [автоподстановки](https://support.watbot.ru/chatbots/templates).
- **«Обновить, если запись существует»** — не добавлять вторую запись, а обновить найденную.
- **«Поля для проверки существования записи»** — появляется при включённом обновлении. Задаёт, по каким полям искать «ту же» запись: бот ищет запись, у которой все перечисленные поля равны указанным значениям. Нашёл — обновляет в ней поля из «Соотношения переменных и полей», остальные поля не трогает. Не нашёл — добавляет новую.

В поле с фото или файлом записывайте переменную, в которую человек прислал картинку или файл. Для поля-галочки подойдут значения «да», «true», «1» или любая непустая переменная.

## Выходы

- «Продолжить» — запись добавлена или обновлена.

## Особенности

Значения проверяются по типам полей списка. Если значение не подходит — например, текст в числовое поле, — бот отправит человеку текст ошибки и дальше не пойдёт. То же произойдёт, если список не выбран или соотношение полей пустое.