Перейти к основному содержимому

Системные переменные

Здесь перечислены системные переменные — те, что заполняются конструктором автоматически в процессе работы бота. Их можно использовать в текстах сообщений, выражениях и условиях.

Как вывести значение

Чтобы вывести значение системной переменной, оберните её имя в конструкцию:

#{имя_переменной}

Например: #{_botname}, #{_request}.

Технические идентификаторы

Все имена переменных начинаются с символа _ (подчёркивания) — это отличительный признак системных переменных.

Запросы и ответы​

ПеременнаяОписание
_requestЗапрос от мессенджера, отправленный в конструктор. Хранится как JSON-строка.
_request_headersВходящий заголовок запроса (только для приёма вебхука). Хранится как JSON-строка.
_responseОтвет сервера на запрос к вебхуку конструктора. В сценариях действий «Обмен данными» (Ожидание данных) и CRM (Принять из CRM) присвойте ответ в эту переменную.
_answerПоследний ответ подписчика на блок

Информация о боте​

ПеременнаяОписание
_botnameИмя бота.
_bottypeТип бота — обозначение канала или бот-лендинга: telegram, max, wa, wabusiness, vk, viber, instagram, fb, avito, cian, wb, ozon, yandexmarket, tiktok, lp, jivo.
_botuserЮзернейм бота.
_botidBotID бота.
_lphostХост сайта или бот-лендинга для ботов, запущенных через виджет для сайта или бот-лендинг.

Состояние сценария​

ПеременнаяОписание
_isstartПризнак запуска сценария: 0 — нет, 1 — да.
_sendtomessidОбъект, создаваемый через «Отправку в бот». Содержит метки, адресатов и ID сообщений для удаления.
_errorСодержит ошибку для действия «Работа с группами и каналами в Telegram».

Контакт и геопозиция​

ПеременнаяОписание
_iscontactОтслеживание получения контакта по кнопке. Значения: 0 или 1.
_contact_nameИмя контакта (только WhatsApp).
_islocationОтслеживание получения геопозиции по кнопке. Значения: 0 или 1.
_location_addressАдрес, отправленный через выбор геопозиции (только WhatsApp).

Медиа и файлы​

ПеременнаяОписание
_ismedia1, если подписчик отправил медиафайл (фото, видео, документ, голосовое, аудио), иначе 0.
_media_typeТип медиафайла: photo, video, document, voice, audio.
_media_typesМассив типов файлов. Доступна при получении вложений (только MAX).
_fileIdID загруженного файла (Telegram и MAX).
_resendonefileСколько файлов пересылается: 1 — один, 0 — несколько. Для действия «Приём и пересылка медиа».
_yadisklinkВременная ссылка на скачивание файла после загрузки на Яндекс Диск.

Ссылка на файл и список вложений​

Когда подписчик присылает медиа, ссылка на файл попадает в переменную media_url, а полный список ссылок на все вложения одного сообщения — в media_urls (каждая ссылка с новой строки). Обе переменные пишутся без подчёркивания (см. также действие Приём и пересылка медиа).

ПеременнаяОписание
media_urlСсылка на полученный файл (первое вложение).
media_urlsСписок ссылок на все вложения сообщения, по одной в строке. Заполняется для каналов-площадок: Avito, Wildberries, Ozon, Циан, TikTok.
Откуда берётся ссылка и сколько живёт
  • Мессенджеры (Telegram, MAX, WhatsApp и др.) — файл скачивается на сервер, ссылка временная: Telegram — 1 минута, каналы Meta (WhatsApp Business, Instagram, Facebook) — 10 минут. Нужен дольше — сразу сохраните на Яндекс Диск или Google Диск.
  • Площадки (Avito, Wildberries, Ozon, Циан, TikTok) — в media_url / media_urls приходят прямые ссылки самой площадки (без перехостинга). Для отзывов Wildberries сюда попадают фото и видео, приложенные покупателем к отзыву.

Платежи и онлайн-чеки 54-ФЗ​

Когда заполнять

Эти переменные нужно присвоить перед генерацией платёжной ссылки — иначе чек не уйдёт.

ПеременнаяОписание
_receipt_emailE-mail покупателя для онлайн-чеков по 54-ФЗ.
_receipt_phoneТелефон покупателя для онлайн-чеков по 54-ФЗ.

Нейросеть​

ПеременнаяОписание
_responseIdID беседы при обращении к нейросети через действие Нейросеть, тип запроса Response.

Группы и каналы — общее​

ПеременнаяОписание
_group_message_idID отправленного в группу/канал сообщения через действия для работы с группами Telegram и MAX.

Группы и каналы Telegram​

Входящее сообщение​

ПеременнаяОписание
_tggroup1 — обращение из группы, 0 — из бота.
_tggroup_idID группы/канала. (ID канала, если переслан пост из канала в бот)
_tggroup_titleНазвание группы/канала. (Название канала, если переслан пост из канала в бот)
_tggroup_message_idID сообщения.
_tggroup_dateДата сообщения (TimeStamp в секундах).
_tggroup_textСообщение подписчика.
_tggroup_message_typeТип сообщения: text, photo, video, audio, document, poll, voice.
_tggroup_message_fromОткуда сообщение: group или channel (комментарий к посту канала или пересылка поста из канала в бот).

Подписчик​

ПеременнаяОписание
_tggroup_user_idID подписчика (ClientID).
_tggroup_first_nameИмя подписчика.
_tggroup_last_nameФамилия подписчика.
_tggroup_usernameЮзернейм подписчика.

Вложения (JSON)​

ПеременнаяОписание
_tggroup_photoJSON-объект фото.
_tggroup_videoJSON-объект видео.
_tggroup_audioJSON-объект аудио.
_tggroup_documentJSON-объект файла или документа.
_tggroup_pollJSON-объект голосования.
_tggroup_voiceJSON-объект голосового сообщения.

Топики (форумы)​

ПеременнаяОписание
_tggroup_is_topic_messageСообщение из топика: 1 — да, 0 — нет.
_tggroup_forum_topic_createdНазвание топика.
_tggroup_message_thread_idID топика группы.

Ответы на сообщения​

ПеременнаяОписание
_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_idID подписчика, на сообщение которого ответили.
_tggroup_reply_to_message_from_first_nameИмя подписчика, на сообщение которого ответили.
_tggroup_reply_to_message_from_last_nameФамилия подписчика, на сообщение которого ответили.
_tggroup_sender_chatОткуда пришёл ответ: supergroup или channel.
_tggroup_sender_chat_idID группы или канала отправителя ответа.
_tggroup_sender_chat_titleНазвание группы или канала отправителя.
_tggroup_sender_chat_usernameUsername группы или канала отправителя. (Название канала, если переслан пост из канала в бот)

Изменения состава участников​

ПеременнаяОписание
_tggroup_new_chat_memberПодписчик вступил в группу: 1 — да, 0 — нет.
_tggroup_left_chat_memberПодписчик вышел из группы: 1 — да, 0 — нет.

Группы и каналы MAX​

Входящее сообщение​

ПеременнаяОписание
_maxgroup1 — обращение из группы/канала, 0 — из бота.
_maxchannel1 — обращение из канала, 0 — не из канала.
_maxgroup_idID группы или канала.
_maxgroup_message_idID сообщения.
_maxgroup_dateДата сообщения (TimeStamp в секундах).
_maxgroup_textСообщение подписчика.
_maxgroup_message_typeТип сообщения.
_maxgroup_attachmentsJSON вложений.
_maxgroup_update_typeСобытие.

Подписчик​

ПеременнаяОписание
_maxgroup_user_idID подписчика (ClientID).
_maxgroup_first_nameИмя подписчика.
_maxgroup_last_nameФамилия подписчика.
_maxgroup_nameПолное имя подписчика.

Ответы на сообщения​

ПеременнаяОписание
_maxgroup_reply_to_messageЯвляется ли сообщение ответом: 1 — да, 0 — нет.
_maxgroup_reply_message_idID сообщения, на которое отвечают.
_maxgroup_reply_to_message_from_idID подписчика, на сообщение которого ответили.
_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_idID группы, из которой отвечают.

Изменения состава участников​

ПеременнаяОписание
_maxgroup_new_chat_memberПодписчик добавлен в группу/канал: 1 — да, 0 — нет.
_maxgroup_left_chat_memberПодписчик удалён из группы/канала: 1 — да, 0 — нет.

Доски объявлений и маркетплейсы​

Эти переменные конструктор заполняет для входящих событий из досок объявлений (Avito, Циан), маркетплейсов (Wildberries, Ozon, Яндекс Маркет) и соцсетей (Instagram, TikTok). Заполняются только в соответствующем канале. Текст сообщения/вопроса/отзыва приходит как обычное входящее сообщение, а вложения — в переменных media_url / media_urls (см. раздел «Медиа и файлы»).

Avito​

ПеременнаяОписание
_avito_chat_idID чата (диалога по объявлению).
_avito_author_idID автора сообщения (покупателя).
_avito_item_idID объявления.
_avito_chat_typeТип чата (например, u2i).
_avito_message_typeТип сообщения: text, image, link.

Циан​

ПеременнаяОписание
_cian_chat_idID чата/диалога по объявлению.
_cian_user_idID пользователя (клиента).

Wildberries​

ПеременнаяОписание
_wb_kindТип события: question (вопрос), feedback (отзыв), chat (чат с покупателем).
_wb_idID вопроса или отзыва (для question/feedback).
_wb_productНазвание товара.
_wb_nmidАртикул WB (nmId).
_wb_ratingОценка отзыва (1–5).
_wb_userИмя/идентификатор покупателя.
_wb_chatidID чата (для kind=chat).
_wb_event_idID события чата (для kind=chat).

Ozon​

ПеременнаяОписание
_ozon_chat_idID чата.
_ozon_message_idID сообщения.
_ozon_user_idID покупателя.

Яндекс Маркет​

ПеременнаяОписание
_ym_kindТип события: chat (чат), review (отзыв).
_ym_chatidID чата (для kind=chat).
_ym_fromОтправитель сообщения чата.
_ym_msg_idID сообщения чата.
_ym_idID отзыва (для 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_idID истории (ответ на историю).
_ig_reply_to_midID сообщения, на которое ответ/реакция.
_ig_comment_idID комментария (для comment/mention).
_ig_media_idID поста/Reels.
_ig_parent_idID родительского комментария (ответ на комментарий).
_ig_usernameЮзернейм автора комментария.

TikTok​

ПеременнаяОписание
_tiktok_conversation_idID диалога.
_tiktok_user_idID пользователя.

Web App: каталог и календарь​

ПеременнаяОписание
_webapp_idID приложения.
_webapp_titleНазвание приложения.
_webapp_urlURL приложения.
_webapp_typeТип Web App: cat — каталог, cal — календарь.
_webapp_order_rubricsРубрики (через запятую), в которых находятся заказанные товары.
_delrecidID удалённой записи Web App календаря.
_delrecwebappidID Web App приложения, из которого была удалена запись.