Системные переменные
Здесь перечислены системные переменные — те, что заполняются конструктором автоматически в процессе работы бота. Их можно использовать в текстах сообщений, выражениях и условиях.
Как вывести значение
Чтобы вывести значение системной переменной, оберните её имя в конструкцию:
#{имя_переменной}
Например: #{_botname}, #{_request}.
Технические идентификаторы
Все имена переменных начинаются с символа _ (подчёркивания) — это отличительный признак системных переменных.
Запросы и ответы
| Переменная | Описание |
|---|---|
_request | Запрос от мессенджера, отправленный в конструктор. Хранится как JSON-строка. |
_request_headers | Входящий заголовок запроса (только для приёма вебхука). Хранится как JSON-строка. |
_response | Ответ сервера на запрос к вебхуку конструктора. В сценариях действий «Обмен данными» (Ожидание данных) и CRM (Принять из CRM) присвойте ответ в эту переменную. |
_answer | Последний ответ подписчика на блок |
Кто прислал вебхук
Когда вебхук сценария вызывает другой бот Квесчи или мини-приложение, конструктор узнаёт подписчика и раскладывает его данные отдельными переменными — чтобы сценарию не приходилось разбирать JSON запроса ради отбора по ClientID.
| Переменная | Описание |
|---|---|
_clientid | ClientID подписчика, от имени которого пришёл запрос |
_messenger | Мессенджер этого подписчика |
_channelid | Идентификатор канала (бота), в котором он состоит |
Только на вебхуке
Эти три переменные существуют исключительно в сценарии, запущенном вебхуком или мини-приложением, и только если запрос удалось связать с подписчиком.
В обычном сценарии — том, который вызвал блок, — их нет. Данные подписчика там берутся шаблонами [ClientID], [Messenger], [BotID]. Неизвестная переменная подставляется пустой строкой молча: отбор по #{_clientid} в обычном сценарии вернёт не того подписчика или никого, и бот об ошибке не скажет.
Вывод списка в бот и листание
Заполняются операцией «Вывести список в бот» (действие «Операции с данными» → операция со списком). Она отправляет отобранные строки отдельными сообщениями по N штук на страницу и доступна в шаблоне сообщения и в кнопках этой операции.
| Переменная | Описание |
|---|---|
_listItemNum | Порядковый номер строки в отобранном списке, начиная с 1 |
_listItem | Метка строки вида item_3. Подставляется и в кнопки — так кнопка знает, к какой именно строке она относится |
_currentPage | Номер показанной страницы |
_nextPage | Номер следующей страницы — для кнопки «Вперёд» |
_prevPage | Номер предыдущей страницы — для кнопки «Назад» |
_pageItems | Сколько строк на странице (из настройки операции, по умолчанию 5) |
_pageTotal | Всего страниц при таком размере страницы |
_listItemIds | Служебная. ID отправленных сообщений страницы — по ним предыдущая страница удаляется из чата перед выводом следующей (только Telegram) |
Какая страница показывается
Номер страницы берётся из последнего ответа подписчика: кнопка «Вперёд» с nextData равным #{_nextPage} возвращает номер, и следующий вызов операции выводит именно его. Номер больше числа страниц не ломает вывод — покажется последняя.
Готовая связка собирается рецептом «Листание списка».
Информация о боте
| Переменная | Описание |
|---|---|
_botname | Имя бота. |
_bottype | Тип бота — обозначение канала или бот-лендинга: telegram, max, wa, wabusiness, vk, viber, instagram, fb, avito, cian, wb, ozon, yandexmarket, tiktok, 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, sticker. |
_media_types | Массив типов файлов. Заполняется, когда подписчик прислал сразу несколько файлов (во всех мессенджерах). |
_fileId | ID загруженного файла (Telegram и MAX). |
_resendonefile | Сколько файлов пересылается: 1 — один, 0 — несколько. Для действия «Приём и пересылка медиа». |
_yadisklink | Временная ссылка на скачивание файла после загрузки на Яндекс Диск. |
Ссылка на файл и список вложений
Когда подписчик присылает медиа, ссылка на файл попадает в переменную media_url, а полный список ссылок на все вложения одного сообщения — в media_urls (каждая ссылка с новой строки). Обе переменные пишутся без подчёркивания (см. также действие Приём и пересылка медиа).
| Переменная | Описание |
|---|---|
media_url | Ссылка на полученный файл (первое вложение). |
sticker_id | Идентификатор присланного стикера. В Telegram — file_id, в MAX — код стикера. |
sticker_emoji | Эмодзи стикера (Telegram). |
sticker_set | Название набора, из которого стикер (Telegram). |
sticker_url | Ссылка на картинку стикера (MAX). |
media_urls | Список ссылок на все вложения сообщения, по одной в строке. Заполняется для каналов-площадок (Avito, Wildberries, Ozon, Циан, TikTok), а после действия Приём и пересылка медиа — ссылками на все пересланные файлы. |
media_count | Сколько файлов переслало действие Приём и пересылка медиа. Один файл — 1. |
media_sent | Дошла ли пересылка до адресатов: 1 — до всех, 0 — кому-то не досталось, пусто — адресатов не было. Заполняет действие «Приём и пересылка медиа». Считается по всему входящему сообщению: если действий приёма два, итог второго не затирает неудачу первого. |
media_notsent | Сколько отправок не удалось за это сообщение. |
media_error | Короткая причина последней неудачной отправки. |
Откуда берётся ссылка и сколько живёт
- Мессенджеры (Telegram, MAX, WhatsApp и др.) — файл скачивается на сервер, ссылка временная: Telegram — 1 минута, каналы Meta (WhatsApp Business, Instagram, Facebook) — 10 минут. Нужен дольше — сразу сохраните на Яндекс Диск или Google Диск.
- Площадки (Avito, Wildberries, Ozon, Циан, TikTok) — в
media_url/media_urlsприходят прямые ссылки самой площадки (без перехостинга). Для отзывов Wildberries сюда попадают фото и видео, приложенные покупателем к отзыву.
Платежи и онлайн-чеки 54-ФЗ
Когда заполнять
Эти переменные нужно присвоить перед генерацией платёжной ссылки — иначе чек не уйдёт.
| Переменная | Описание |
|---|---|
_receipt_email | E-mail покупателя для онлайн-чеков по 54-ФЗ. |
_receipt_phone | Телефон покупателя для онлайн-чеков по 54-ФЗ. |
Нейросеть
| Переменная | Описание |
|---|---|
_responseId | ID беседы при обращении к нейросети через действие Нейросеть, тип запроса Response. |
_aiContext | История беседы, когда её ведёт само действие: шлюзы, Claude, Gemini, YandexGPT, DeepSeek. Заполняется, если включён Контекст, а своя переменная для беседы не указана. |
_aiContextReset | 1, если беседа начата заново: переписка переросла окно модели, нейросеть ответила ошибкой о контексте или отказалась хранить слишком большой ответ. 0 — беседа продолжается. Заполняется при включённом Контексте. |
Группы и каналы — общее
| Переменная | Описание |
|---|---|
_group_message_id | ID отправленного в группу/канал сообщения через действия для работы с группами Telegram и MAX. По нему пост потом правят, закрепляют и удаляют. Следующая отправка перезапишет — сохраняйте в свою переменную, если вернётесь к посту позже. |
_chat_title | Название канала или группы. Заполняет операция «Данные канала/группы». |
_chat_username | @имя канала (только Telegram). |
_chat_description | Описание канала или группы. |
_chat_link | Ссылка на канал или группу. |
_chat_membercount | Число участников. |
_chat_pinned | ID закреплённого сообщения. |
_poll_id | ID опубликованного опроса. С этим же ID приходят ответы на него. |
События канала и группы Telegram
Приходят боту сами — сценарий ловит их условием по переменной. Реакции, вход и выход участников и бусты Telegram присылает только по подписке: она ставится при подключении канала, поэтому боты, подключённые раньше, начнут их получать после переподключения.
| Переменная | Что содержит |
|---|---|
_pollanswer | 1 — пришёл ответ на опрос. |
_pollanswer_poll_id | ID опроса — тот же, что _poll_id при публикации. |
_pollanswer_options | Номера выбранных вариантов через запятую, нумерация с единицы. |
_pollanswer_retracted | 1 — человек отозвал свой голос. |
_joinrequest | 1 — пришла заявка на вступление в закрытый канал или группу. |
_joinrequest_chat_id | ID канала или группы, куда просятся. |
_joinrequest_chat_title | Название канала или группы, куда просятся. |
_joinrequest_invite_link | По какой ссылке пришли — видно, какой источник сработал. |
_joinrequest_bio | Описание профиля, если оно открыто. |
_chatmember | 1 — изменился состав участников группы. |
_chatmember_joined | 1 — участник вступил. |
_chatmember_left | 1 — участник вышел или его удалили. |
_chatmember_status | Новый статус: member, administrator, creator, restricted, left, kicked. |
_chatmember_oldstatus | Прежний статус участника. |
_chatmember_chat_id | ID группы, где изменился состав. |
_chatmember_chat_title | Название группы, где изменился состав. |
_reaction | 1 — кто-то поставил или снял реакцию. |
_reaction_emoji | Реакции, которые стоят сейчас, через запятую. Пусто — все сняты. |
_reaction_removed | Реакции, которые сняли этим действием. |
_reaction_chat_id | ID канала или группы, где поставили реакцию. |
_reaction_message_id | ID сообщения, на которое поставили реакцию. |
_channelpost | 1 — в канале вышел новый пост. |
_channelpost_id | Номер вышедшего поста. У поста нет автора, поэтому подписчиком выступает сам канал. |
_channelpost_chat_id | ID канала, где вышел пост. |
_channelpost_chat_title | Название канала, где вышел пост. |
_channelpost_text | Текст поста или подпись к медиа. |
_boost | 1 — канал забустили. |
_boost_chat_id | ID канала, который забустили. |
_boost_count | Сколько бустов принесло это событие. |
_boost_expires | До какого времени действует буст (unix-время). |
_business_chat | 1 — сообщение пришло в личный аккаунт владельца, а не в бот. |
_business | 1 — владелец подключил или отключил бота у своего аккаунта. |
_business_id | Номер подключения бизнес-аккаунта. |
_business_user_id | ID владельца аккаунта. |
_business_enabled | 1 — подключение включено, 0 — отключено. |
_business_canreply | 1 — боту разрешено отвечать от имени владельца. |
_topic_id | Номер созданной темы форума. |
_gifts_count | Сколько подарков доступно боту. |
_gift_id | ID самого дешёвого доступного подарка. |
_gift_price | Его цена в звёздах. |
_comments_count | Сколько комментариев под постом канала MAX. |
_comment_id | ID последнего комментария под постом — по нему комментарий удаляют. |
_comment_text | Текст последнего комментария. |
_comment_user_id | ID автора последнего комментария. |
_comment_user_name | Имя автора последнего комментария. |
_starpay | 1 — подписчик оплатил счёт звёздами Telegram. |
_starpay_amount | Сколько звёзд списано. |
_starpay_payload | Метка платежа из счёта — по ней видно, за что заплатили. |
_starpay_charge_id | Номер платежа. Нужен для возврата — сохраняйте его вместе с заказом. |
_starpay_subscription | 1 — списание по подписке, а не разовая оплата. |
_starpay_invoice_id | Номер сообщения со счётом сразу после выставления. |
Группы и каналы 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, sticker. |
_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_sticker | 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 — нет. |
Доски объявлений и маркетплейсы
Эти переменные конструктор заполняет для входящих событий из досок объявлений (Avito, Циан),
маркетплейсов (Wildberries, Ozon, Яндекс Маркет) и соцсетей (Instagram, TikTok). Заполняются
только в соответствующем канале. Текст сообщения/вопроса/отзыва приходит как обычное входящее сообщение,
а вложения — в переменных media_url / media_urls (см. раздел «Медиа и файлы»).
Avito
| Переменная | Описание |
|---|---|
_avito_chat_id | ID чата (диалога по объявлению). |
_avito_author_id | ID автора сообщения (покупателя). |
_avito_item_id | ID объявления. |
_avito_chat_type | Тип чата (например, u2i). |
_avito_message_type | Тип сообщения: text, image, link. |
Циан
| Переменная | Описание |
|---|---|
_cian_chat_id | ID чата/диалога по объявлению. |
_cian_user_id | ID пользователя (клиента). |
Wildberries
| Переменная | Описание |
|---|---|
_wb_kind | Тип события: question (вопрос), feedback (отзыв), chat (чат с покупателем). |
_wb_id | ID вопроса или отзыва (для question/feedback). |
_wb_product | Название товара. |
_wb_nmid | Артикул WB (nmId). |
_wb_rating | Оценка отзыва (1–5). |
_wb_user | Имя/идентификатор покупателя. |
_wb_chatid | ID чата (для kind=chat). |
_wb_event_id | ID события чата (для kind=chat). |
Ozon
| Переменная | Описание |
|---|---|
_ozon_chat_id | ID чата. |
_ozon_message_id | ID сообщения. |
_ozon_user_id | ID покупателя. |
Яндекс Маркет
| Переменная | Описание |
|---|---|
_ym_kind | Тип события: chat (чат), review (отзыв). |
_ym_chatid | ID чата (для kind=chat). |
_ym_from | Отправитель сообщения чата. |
_ym_msg_id | ID сообщения чата. |
_ym_id | ID отзыва (для kind=review). |
_ym_rating | Оценка отзыва. |
_ym_author | Автор отзыва. |
_ym_nmid | Идентификатор товара. |
Instagram
| Переменная | Описание |
|---|---|
_ig_event | Тип события: message, postback, reaction, referral, optin, story_reply, story_mention, deleted, comment, live_comment, mention. |
_ig_reaction | Тип реакции (love, like …) — для события reaction. |
_ig_reaction_action | Действие реакции: react / unreact. |
_ig_referral | Метка перехода (ссылка ig.me / реклама). |
_ig_referral_source | Источник перехода. |
_ig_story_id | ID истории (ответ на историю). |
_ig_reply_to_mid | ID сообщения, на которое ответ/реакция. |
_ig_comment_id | ID комментария (для comment/mention). |
_ig_media_id | ID поста/Reels. |
_ig_parent_id | ID родительского комментария (ответ на комментарий). |
_ig_username | Юзернейм автора комментария. |
TikTok
| Переменная | Описание |
|---|---|
_tiktok_conversation_id | ID диалога. |
_tiktok_user_id | ID пользователя. |
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 приложения, из которого была удалена запись. |