Переменные и данные пользователя
Переменные позволяют работать с динамическими данными в сценариях: сохранять ввод пользователя, передавать данные между функциями и подставлять значения в сообщения.
Синтаксис
Переменные записываются в формате:
{=имя_переменной=}
Используйте их в тексте сообщений, условиях, HTTP-запросах и других функциях.
Системные переменные
Эти переменные доступны автоматически при получении сообщения:
| Переменная | Описание |
|---|---|
{=message=} |
Текст сообщения пользователя |
{=tgData.from.id=} |
ID пользователя в Telegram |
{=tgData.from.first_name=} |
Имя пользователя |
{=tgData.from.last_name=} |
Фамилия пользователя |
{=tgData.from.username=} |
Username в Telegram |
{=tgData.chat.id=} |
ID чата |
Создание переменных
Используйте функцию add_var для создания и изменения переменных:
- Задайте имя переменной
- Укажите значение (текст, число или выражение с другими переменными)
После создания переменная доступна во всех последующих функциях сценария.
Использование в сообщениях
Привет, {=tgData.from.first_name=}!
Вы написали: {=message=}
Ваш заказ #{=order_id=} принят.
Использование в условиях
"{=message=}" == "/start"
{=count=} > 5
"{=user_role=}" == "admin"
Переменные из HTTP-запросов
Результат HTTP-запроса можно сохранить в переменную. Если ответ — JSON, доступ к вложенным полям через точку:
{=api_response.data.name=}
{=api_response.status=}
Переменные из интеграций
Результаты запросов к MySQL, MongoDB и ИИ также сохраняются в переменные и доступны в последующих функциях.