Системные переменные
Здесь перечислены системные переменные — те, что заполняются конструктором автоматически в процессе работы бота. Их можно использовать в текстах сообщений, выражениях и условиях.
Как вывести значение
Чтобы вывести значение системной переменной, оберните её имя в конструкцию:
#{имя_переменной}
Например: #{_botname}, #{_request}.
Технические идентификаторы
Все имена переменных начинаются с символа _ (подчёркивания) — это отличительный признак системных переменных.
Запросы и ответы
| Переменная | Описание |
|---|---|
_request | Запрос от мессенджера, отправленный в конструктор. Хранится как JSON-строка. |
_request_headers | Входящий заголовок запроса (только для приёма вебхука). Хранится как JSON-строка. |
_response | Ответ сервера на запрос к вебхуку конструктора. В сценариях действий «Обмен данными» (Ожидание данных) и CRM (Принять из CRM) присвойте ответ в эту переменную. |
Информация о боте
| Переменная | Описание |
|---|---|
_botname | Имя бота. |
_bottype | Тип бота — обозначение мессенджера или бот-лендинга: telegram, max, wa, vk, viber, lp, jivo. |
_botuser | Юзернейм бота. |
_botid | BotID бота. |
_lphost | Хост сайта или бот-лендинга для ботов, запущенных через виджет для сайта или бот-лендинг. |
Состояние сценария
| Переменная | Описание |
|---|---|
_isstart | Признак запуска сценария: 0 — нет, 1 — да. |
_sendtomessid | Объект, создаваемый через «Отправку в бот». Содержит метки, адресатов и ID сообщений для удаления. |
_error | Содержит ошибку для действия «Работа с группами и каналами в Telegram». |
Контакт и геопозиция
| Переменная | Описание |
|---|---|
_iscontact | Отслеживание получения контакта по кнопке. Значения: 0 или 1. |
_contact_name | Имя контакта (только WhatsApp). |
_islocation | Отслеживание получения геопозиции по кнопке. Значения: 0 или 1. |
_location_address | Адрес, отправленный через выбор геопозиции (только WhatsApp). |
Медиа и файлы
| Переменная | Описание |
|---|---|
_ismedia | 1, если подписчик отправил медиафайл (фото, видео, документ, голосовое, аудио), иначе 0. |
_media_type | Тип медиафайла: photo, video, document, voice, audio. |
_media_types | Массив типов файлов. Доступна при получении вложений (только MAX). |
_fileId | ID загруженного файла (Telegram и MAX). |
_resendonefile | Сколько файлов пересылается: 1 — один, 0 — несколько. Для действия «Приём и пересылка медиа». |
_yadisklink | Временная ссылка на скачивание файла после загрузки на Яндекс Диск. |
Платежи и онлайн-чеки 54-ФЗ
Когда заполнять
Эти переменные нужно присвоить перед генерацией платёжной ссылки — иначе чек не уйдёт.
| Переменная | Описание |
|---|---|
_receipt_email | E-mail покупателя для онлайн-чеков по 54-ФЗ. |
_receipt_phone | Телефон покупателя для онлайн-чеков по 54-ФЗ. |
Нейросеть
| Переменная | Описание |
|---|---|
_responseId | ID беседы при обращении к нейросети через действие Нейросеть, тип запроса Response. |
Группы и каналы — общее
| Переменная | Описание |
|---|---|
_group_message_id | ID отправленного в группу/канал сообщения через действия для работы с группами Telegram и MAX. |
Группы и каналы Telegram
Входящее сообщение
| Переменная | Описание |
|---|---|
_tggroup | 1 — обращение из группы, 0 — из бота. |
_tggroup_id | ID группы/канала. (ID канала, если переслан пост из канала в бот) |
_tggroup_title | Название группы/канала. (Название канала, если переслан пост из канала в бот) |
_tggroup_message_id | ID сообщения. |
_tggroup_date | Дата сообщения (TimeStamp в секундах). |
_tggroup_text | Сообщение подписчика. |
_tggroup_message_type | Тип сообщения: text, photo, video, audio, document, poll, voice. |
_tggroup_message_from | Откуда сообщение: group или channel (комментарий к посту канала или пересылка поста из канала в бот). |
Подписчик
| Переменная | Описание |
|---|---|
_tggroup_user_id | ID подписчика (ClientID). |
_tggroup_first_name | Имя подписчика. |
_tggroup_last_name | Фамилия подписчика. |
_tggroup_username | Юзернейм подписчика. |
Вложения (JSON)
| Переменная | Описание |
|---|---|
_tggroup_photo | JSON-объект фото. |
_tggroup_video | JSON-объект видео. |
_tggroup_audio | JSON-объект аудио. |
_tggroup_document | JSON-объект файла или документа. |
_tggroup_poll | JSON-объект голосования. |
_tggroup_voice | JSON-объект голосового сообщения. |
Топики (форумы)
| Переменная | Описание |
|---|---|
_tggroup_is_topic_message | Сообщение из топика: 1 — да, 0 — нет. |
_tggroup_forum_topic_created | Название топика. |
_tggroup_message_thread_id | ID топика группы. |
Ответы на сообщения
| Переменная | Описание |
|---|---|
_tggroup_reply_to_message | Является ли сообщение ответом: 1 — да, 0 — нет. |
_tggroup_reply_to_message_text | Текст сообщения, на которое ответили. |
_tggroup_reply_to_message_text_type | Тип исходного сообщения: text, photo, video, audio, document, poll, voice. |
_tggroup_reply_to_message_from_id | ID подписчика, на сообщение которого ответили. |
_tggroup_reply_to_message_from_first_name | Имя подписчика, на сообщение которого ответили. |
_tggroup_reply_to_message_from_last_name | Фамилия подписчика, на сообщение которого ответили. |
_tggroup_sender_chat | Откуда пришёл ответ: supergroup или channel. |
_tggroup_sender_chat_id | ID группы или канала отправителя ответа. |
_tggroup_sender_chat_title | Название группы или канала отправителя. |
_tggroup_sender_chat_username | Username группы или канала отправителя. (Название канала, если переслан пост из канала в бот) |
Изменения состава участников
| Переменная | Описание |
|---|---|
_tggroup_new_chat_member | Подписчик вступил в группу: 1 — да, 0 — нет. |
_tggroup_left_chat_member | Подписчик вышел из группы: 1 — да, 0 — нет. |
Группы и каналы MAX
Входящее сообщение
| Переменная | Описание |
|---|---|
_maxgroup | 1 — обращение из группы/канала, 0 — из бота. |
_maxchannel | 1 — обращение из канала, 0 — не из канала. |
_maxgroup_id | ID группы или канала. |
_maxgroup_message_id | ID сообщения. |
_maxgroup_date | Дата сообщения (TimeStamp в секундах). |
_maxgroup_text | Сообщение подписчика. |
_maxgroup_message_type | Тип сообщения. |
_maxgroup_attachments | JSON вложений. |
_maxgroup_update_type | Событие. |
Подписчик
| Переменная | Описание |
|---|---|
_maxgroup_user_id | ID подписчика (ClientID). |
_maxgroup_first_name | Имя подписчика. |
_maxgroup_last_name | Фамилия подписчика. |
_maxgroup_name | Полное имя подписчика. |
Ответы на сообщения
| Переменная | Описание |
|---|---|
_maxgroup_reply_to_message | Является ли сообщение ответом: 1 — да, 0 — нет. |
_maxgroup_reply_message_id | ID сообщения, на которое отвечают. |
_maxgroup_reply_to_message_from_id | ID подписчика, на сообщение которого ответили. |
_maxgroup_reply_to_message_from_first_name | Имя подписчика, на сообщение которого ответили. |
_maxgroup_reply_to_message_from_last_name | Фамилия подписчика, на сообщение которого ответили. |
_maxgroup_reply_to_message_from_name | Полное имя подписчика, на сообщение которого ответили. |
_maxgroup_reply_to_message_chat_id | ID группы, из которой отвечают. |
Изменения состава участников
| Переменная | Описание |
|---|---|
_maxgroup_new_chat_member | Подписчик добавлен в группу/канал: 1 — да, 0 — нет. |
_maxgroup_left_chat_member | Подписчик удалён из группы/канала: 1 — да, 0 — нет. |
Web App: каталог и календарь
| Переменная | Описание |
|---|---|
_webapp_id | ID приложения. |
_webapp_title | Название приложения. |
_webapp_url | URL приложения. |
_webapp_type | Тип Web App: cat — каталог, cal — календарь. |
_webapp_order_rubrics | Рубрики (через запятую), в которых находятся заказанные товары. |
_delrecid | ID удалённой записи Web App календаря. |
_delrecwebappid | ID Web App приложения, из которого была удалена запись. |