Список переменных для Telegram

Ниже будет список переменных для события «Написал сообщение в Telegram» и для события «Telegram»

Событие «Написал сообщение в Telegram»

Полезные переменные доступные после события:

• %chat_id% — id бота или пользователя. Для бота идентификатор имеет значение с минусом, а для пользователя положительное число
• %content% — текст сообщения
• %object_id% — ID сообщения
• %orig_subs_id% — TG ID игрока, который запустил команду
• %mention% — TG ID игрока в ответном сообщении. Аналог переменной %mention% в ВК.
• %tg_file_id% — ID файла для отправки пользователю соответствующим методом. Для каждого метода он свой.

• %tg_screen_name% — screen namе пользователя в TG. Например, @andreygorgamer

• %tg_dice_emoji% — emoji в случае вложения dice

• %tg_dice_value% — выпавшее значение в игре кости или подобных в случае вложения dice

Переменные если в Telegram настроены темы.

• %is_forum% - переменная для проверки типа сообщения. Если 1то сообщения в топике (форум)

• %post_id% - переменная ID топика . Если нет тем, то может содержать ID поста

• %is_topic_message% - переменная ID сообщения топика . Если нет тем, то может содержать 0

• %message_thread_id% - переменная содержит ID в какой топик отвечать через действие бота. Если нет тем, то может содержать 0

• %forum_topic_title% - переменная содержит название топика в который написал пользователь. Если нет тем, то может содержать 0

Для того чтобы сделать ответное сообщение или комментарий в действии «Отправить сообщение в Telegram» добавьте параметр:

• reply_to_message_id со значением %object_id%

Для того чтобы сделать ответное сообщение в соответствующий топик в действии «Отправить сообщение в Telegram» добавьте параметр:

• message_thread_idсо значением %message_thread_id%
• reply_to_message_idсо значением %object_id%

Чтобы сделать кликабельное имя в действии «Отправить сообщение в Telegram» переключите параметр Markdown и добавьте текст:

 [%first_name% %last_name%](tg://user?id=%player.tg_id%)

Пример JSON-кнопок в Telegram

Пример JSON-кнопок в Telegram переменная %keyboard% вставляется в запрос в параметре reply_markup со значением %keyboard%.

{"keyboard":[[{ "text": "Кнопка #request"}]],"resize_keyboard": true}

Пример JSON-кнопок в формате inline в Telegram переменная %keyboard% вставляется в запрос в параметре reply_markup со значением %keyboard%. Здесь текст кнопки указывается в callback data.

{
  "inline_keyboard": [
    [
      { "text": "✅", "callback_data": "{\"text\":\"✅\",\"button\":\"1\"}" },
      { "text": "⛔", "callback_data": "{\"text\":\"⛔\",\"button\":\"1\"}" }
    ]
  ]
}

Проверка типов вложений

Здесь все стандартно: условие: переменная %attach_type%— тип вложения. Может принимать следующие значения:

• none — нет вложений;
• photo — картинка;
• sticker — стикер;
• video — видео;
• document — документ, архив, программа;
• animation — gif;
• voice — голосовое сообщение;
• audio — аудио;
• video_note — круглое видео.
• dice - розыгрыш

Событие «Telegram» с переключателем «Новый чат бота»

• %tg_is_dialog_allowed% — статус разрешения сообщений.

• member — участник переписки с ботом. kicked— участник заблокировал бота.

Событие «Telegram» с переключателем «Запрос доставки»

Полезные переменные доступные после события:

• %chat_id% — id бота или пользователя. Для бота идентификатор имеет значение с минусом, а для пользователя положительное число

• %shipping_id% — ID запроса на доставку (shipping_query.id), используется для ответа через answerShippingQuery
• %tg_id% — Telegram ID пользователя, отправившего запрос (аналог %chat_id%)
• %first_name% — Имя пользователя в Telegram
• %last_name% — Фамилия пользователя в Telegram
• %tg_screen_name% — Никнейм пользователя в Telegram ( может отсутствовать)
• %language_code% — Язык Telegram-клиента пользователя ( например ru, en)
• %invoice_payload% — ID заказа в Telegram
• %country_code% — Страна доставки (2-буквенный код, например RU, US)
• %state% — Область / регион доставки например «Московская область»).
• %city% — Город доставки
• %street_line1% — Первая строка адреса, например улица и номер дома
• %street_line2% — Вторая строка адреса (необязательно, например квартира)
• %post_code% — Почтовый индекс
• %orig_subs_id% — Telegram ID пользователя, изначально запустившего команду (если это не тот же, кто оформляет заказ)

Событие «Telegram» с переключателем «Заявка в чат»

• %join_date% — время вступления в чат в UNIX формате. Для преобразования можно воспользоваться функцией {date}.
• %invite_expire_date% — время истечения срока жизни ссылки в UNIX формате.
• %invite_link% — ссылка на чат.
• %creator_id% — TG ID админа, сделавшего ссылку.
• %creator_username% — Username TG ID админа, сделавшего ссылку.

Событие «Telegram» с переключателем «Новый пост в канале / Изменен пост в канале »

• %post_id% — ID поста, под которым написал комментарий. Событие «Написал сообщение в Telegram» реагирует и на комментарии.

Событие «Telegram» с переключателем «Ответ на опрос»

Важно! Для опроса Telegram не передает текст выбранного ответа, а только его идентификатор.

• %chat_id% — id бота или пользователя. Для бота идентификатор имеет значение с минусом, а для пользователя положительное число
• %content% —идентификаторы ответа пользователя
• %option_ids% — массив идентификаторов ответа пользователя. Пример: [&quot;0","1"]
• %poll_id% — ID опроса на который отвечает пользователь TG

Событие «Telegram» с переключателем «Новый участник чата»

Важно! Переменная работает только для данного типа.

• %tg_chat_member_status% — статус пользователя / бота при вступлении в группу / канал. Возможные значения:
• left — покинул группу /канал
• member— присоединился к группе /каналу
• kicked / banned — был забанен

Для удаления сообщений в боте рекомендуется воспользоваться действием «Удалить сообщение в Telegram» и передать переменные:

• %chat_id% — ID беседы
• %object_id% — ID сообщения пользователя, которое нужно удалить
• %last_mess_id% — ID сообщения от бота, которое нужно удалить
• %last_mess_ids% — ID сообщений через запятую от бота, которое нужно удалить (используется для SendMediaGroup)