Переменные: поля и таблицы
Переменные — это способ хранить и переиспользовать данные внутри бота: имя клиента, его ответы, статус заказа, любые значения из шагов сценария. Подставляя переменные в текст, условия и действия, вы делаете диалог персональным и «умным» — бот обращается по имени, помнит ответы и принимает решения на их основе.
Что делает / Возможности
В конструкторе есть несколько видов хранилищ — выбирайте по области видимости и типу данных.
| Хранилище | Что хранит | Область видимости |
|---|---|---|
| Пользовательские поля | Данные конкретного подписчика (имя, телефон, ответы) | Привязаны к одному подписчику |
| Глобальные поля | Общие значения для всего бота (счётчики, настройки) | Одни на весь бот |
| Системные переменные | Имя, телефон, канал, start_param и т. п. | Заполняются автоматически |
| Таблицы | Строки данных (заявки, записи, каталоги) | Общие, со множеством строк |
| Секреты | Токены и ключи интеграций — {{secret.*}} | Скрыты, подставляются только в действиях |
Пользовательские поля
Хранят информацию по каждому подписчику отдельно. Например, поле «имя» у одного клиента — «Анна», у другого — «Игорь». Такие поля заполняются нодами «Вопрос», «Форма» или AI-шагом и сопровождают подписчика во всех будущих диалогах.
Глобальные поля
Одни на весь бот, не зависят от подписчика. Подходят для общих значений: текущая акция, общий счётчик заявок, текстовая константа, которую вы меняете в одном месте.
Системные переменные
Заполняются платформой автоматически: имя подписчика, телефон, канал, параметр запуска start_param (например, метка из ссылки). Их удобно использовать в приветствии и для аналитики источников.
Таблицы
Хранят строки данных — как маленькая база. В таблицу можно складывать заявки, записи, позиции каталога. Ноды сценария умеют добавлять строки и читать из таблиц данные, чтобы показать их клиенту или принять решение.
Секреты
Чувствительные значения (токены, API-ключи) хранятся отдельно и подставляются как {{secret.*}}. Их видно только в действиях при обращении к внешним системам — в тексте сообщений секреты не раскрываются.
Когда применять
- Персонализация. Обращаться к клиенту по имени и упоминать его ответы в каждом сообщении.
- Ветвление логики. Принимать решения по сохранённому значению в «Условии» (например, по городу или сумме заказа).
- Сбор заявок. Накапливать строки заявок и записей в таблицах, чтобы менеджер выгрузил их целиком.
- Передача во внешние системы. Отправлять собранные данные в CRM или по API через «Действия».
Как использовать переменные в тексте
Чтобы подставить значение переменной в сообщение, оберните её имя в двойные фигурные скобки:
Запись вида {{name}} в тексте сообщения подставит значение переменной. Например,
«Здравствуйте, {{name}}!» превратится в «Здравствуйте, Анна!». Конструктор
подсвечивает незакрытые или несуществующие переменные, чтобы вы не ошиблись.
Переменные можно использовать не только в тексте, но и:
- в условиях — для ветвления по значению;
- в формулах — для вычислений;
- в действиях — для передачи данных во внешние системы.
Как настроить
Откройте раздел переменных
В конструкторе перейдите к управлению переменными (пользовательскими, глобальными полями и таблицами).
Создайте поле или таблицу
Задайте имя и тип. Для таблицы опишите колонки.Заполняйте в сценарии
Сохраняйте в переменную ответы клиента (ноды «Вопрос», «Форма», AI) или вычисленные значения.
Используйте в тексте и логике
Подставляйте переменную в сообщения через двойные скобки и проверяйте в условиях.
С чем сочетать
Переменные — связующее звено всего сценария: одни ноды их пишут, другие читают.
- Нода «Вопрос» и «Форма» — записывают ответы клиента в пользовательские поля.
- AI-шаг — кладёт результат умного диалога в переменную.
- Нода «Сообщение» — читает переменные и подставляет их в текст через
{{variable}}. - Нода «Условие» — ветвит сценарий по значению переменной.
- Нода «Формула» — вычисляет новые значения и сохраняет их обратно.
- Нода «Действия» — передаёт переменные во внешние системы, использует секреты
{{secret.*}}.
Пример
Бот спрашивает имя и город клиента (нода «Вопрос») и сохраняет их в пользовательские поля. Дальше в каждом сообщении он обращается по имени, «Условие» выбирает ближайший филиал по городу, а строку с заявкой (имя, город, товар) «Действие» добавляет в таблицу «Заявки» — менеджер потом выгрузит её целиком.