Использование переменных
Переменные подставляются по единому правилу — имя в двойных фигурных скобках. Это работает в тексте сообщений, условиях и параметрах действий. В формулах имя пишется без скобок. Здесь — синтаксис, места применения и шпаргалка.
Синтаксис
Оберните имя переменной в двойные фигурные скобки:
| Запись | Что подставит |
|---|---|
{{name}} | значение поля name (имя клиента) |
{{city}} | значение поля city (город) |
{{start_param}} | метка из ссылки на бота |
{{system.first_name}} | имя из карточки клиента |
{{global.promo}} | глобальное поле promo |
{{secret.имя}} | секрет (токен, ключ) — только в запросах |
Если значения может не быть, задайте запасное через вертикальную черту: {{name|друг}} подставит «друг», когда имя пустое.
Имя в скобках должно точно совпадать с названием поля. Конструктор подсвечивает незакрытые или несуществующие переменные — обращайте внимание на подсветку, чтобы бот не отправил клиенту пустое место вместо значения.
Где можно подставлять
| Где | Зачем |
|---|---|
| Текст сообщений | Персонализация — обращение по имени, упоминание выбора |
| Условия | Ветвление по значению переменной |
| Параметры действий | Передача данных в CRM, таблицы, HTTP-запросы |
| Формулы | Вычисления — там имя пишется без скобок: price * qty |
Секреты
Чувствительные значения — токены и ключи интеграций — подставляются особым видом записи {{secret.имя}}. Секреты доступны только в действиях при обращении к внешним системам и никогда не раскрываются в тексте сообщений клиенту.
Используйте {{secret.*}} для авторизации в HTTP-запросах и интеграциях, а не
вписывайте ключи прямо в параметры. Так токен не попадёт в текст и логи.
Шпаргалка «Переменные»
Чтобы не запоминать имена, нажмите кнопку «Переменные» в редактируемом поле. Откроется список доступных пользовательских, глобальных и системных значений — выберите нужное, и оно вставится в правильном формате.
В полях «Сохранить … в переменную» у шагов и действий список предлагает только пользовательские поля: туда записывается переменная сценария. Глобальное поле меняют действие «Установить пользовательское поле» и AI-шаг.
Как настроить
Поставьте курсор в поле
Откройте текст сообщения, условие или параметр действия, куда нужно вставить значение.
Откройте шпаргалку
Нажмите кнопку «Переменные» и выберите нужное поле — оно подставится как
{{поле}}.Или впишите вручную
Наберите имя в двойных скобках. Следите за подсветкой — она предупредит об ошибке в имени.
Проверьте подстановку
Пройдите сценарий как клиент и убедитесь, что вместо
{{поле}}подставляется реальное значение.
Когда применять / Пример
- Личное обращение. В тексте: «
{{name}}, ваша запись на{{service}}подтверждена». Бот подставит имя и услугу конкретного клиента. - Авторизация в API. В заголовке HTTP-действия укажите
Authorization: Bearer <code>{'{{secret.api_token}}'}</code>— токен подставится, но не попадёт в переписку.