Документация › Для разработчиков › Язык выражений

Язык выражений (expressions)

Подставляй в тексты бота живые данные: Привет, {{client_name}}!. Выражения работают в промпте, приветствиях, дожимах и шаблонах: на основе Handlebars, безопасно.

⏱ 8 мин · 👤 для владельца и разработчика · 🟢 live

За 30 секунд:

• Синтаксис это двойные фигурные скобки: {{client_name}}, {{phone}}, {{stage}}.
• Работает в системном промпте, приветствиях, дожимах, шаблонах уведомлений, тест-чате.
• Есть помощники: даты/время, текст ({{upper …}}), условия ({{#if …}}), математика.
• Это безопасный шаблонизатор (Handlebars): произвольный код не выполняется.

Что это и где работает

Выражения это «вставки» в тексты бота, которые на лету заменяются на реальные данные диалога. Например, Здравствуйте, {{client_name}}! превратится в Здравствуйте, Алмас!.

Работают в: системном промпте, приветствиях, сообщениях дожимов, шаблонах уведомлений, тест-чате.

Переменные и помощники: живой справочник

Полный список переменных ({{client_name}}, {{phone}}, {{stage}}, {{data.поле}}…) и помощников (даты, текст, условия {{#if}}, математика, {{digits}}): в живом справочнике выражений. Он строится прямо из кода движка, поэтому всегда совпадает с тем, что реально умеет бот: здесь копию не держим, чтобы она не устаревала.

💡 {{client_name}} и {{name}}: одно и то же, оба работают. Аналогично {{client_phone}} и {{phone}}.

Пример:

{{#if client_name}}Здравствуйте, {{client_name}}!{{else}}Здравствуйте!{{/if}}
Сегодня {{day_of_week}}, {{date}}. Ваш статус: {{default lead_status "новый"}}.

Безопасность

Это безопасный шаблонизатор, а не выполнение кода. Нельзя запустить произвольный JS, обратиться к файлам или сети. Встроены защиты от перегрузки: ограничения на длину шаблона, число и глубину условных блоков, размер данных и времени выполнения. Если шаблон «слишком тяжёлый», он вернётся как есть, не подвесив бота.

📌 Невалидное выражение (опечатка в скобках) не ломает сообщение: подсветится/останется текстом, бот продолжит работать.

Простыми словами

Выражения это способ вставлять в тексты бота «живые» кусочки. Пишешь в приветствии Привет, {{client_name}}!, и каждому клиенту бот подставит его имя. Можно вставлять телефон, текущую дату, стадию разговора и собранные данные. Есть и помощники посложнее: написать дату в нужном формате, сделать текст заглавными буквами, показать разный текст в зависимости от условия («если имя известно, поздоровайся по имени, иначе просто привет»).

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

Дальше: → Формат данных и интеграция фронта
Связано: Системный промпт · Дожимы · Кастомные вебхуки
Не получилось? → напиши в саппорт