Простые переменные
Здесь собраны самые нужные переменные. Найдите в таблице то, что хотите подставить, скопируйте из первого столбца и вставьте в шаблон.
В разных местах — разные данные
Некоторые переменные есть не везде. Например, arguments (что написали после команды) бывает только в командах, а level — только в сообщении о новом уровне. Какие переменные есть в каком месте, смотрите в статье Где используются шаблоны.
Участник
member — участник, о котором идет речь: кто зашел в чат, вызвал команду, нажал кнопку или получил уровень.
| Переменная | Что подставится | Пример |
|---|---|---|
{{ member }} | Упоминание: имя-ссылка на профиль | Анна Смирнова |
{{ member.name }} | Имя и фамилия | Анна Смирнова |
{{ member.firstName }} | Только имя | Анна |
{{ member.lastName }} | Только фамилия (если указана) | Смирнова |
{{ member.username }} | Username без @ | anna_sm |
{{ member.tag }} | @username, а если его нет — имя | @anna_sm |
{{ member.displayName }} | Должность админа в чате, а если ее нет — имя | Модератор |
{{ member.id }} | Числовой ID в Telegram | 123456789 |
{{ member.joinedAt }} | Когда вступил в чат | сб, 11 апр. 2026 15:27:38 MSK |
{{ member.warnCount }} | Сколько активных предупреждений | 1 |
{{ member.language }} | Язык Telegram участника | ru |
{{ member.status }} | Статус в чате: creator, administrator, member, restricted | member |
Еще есть переменные «да/нет» — их удобно использовать в условиях:
| Переменная | Когда «да» |
|---|---|
member.isAdmin | Участник — администратор чата |
member.isOwner | Участник — создатель чата |
member.moderator | Участник может модерировать: админ с правом ограничивать или роль бота «модератор» |
member.isPremium | У участника Telegram Premium |
member.bot | Это бот, а не человек |
Уровень и опыт
Если в чате включен модуль «Уровни», у каждого участника есть уровень и опыт. Они лежат в member.rank.
| Переменная | Что подставится | Пример |
|---|---|---|
{{ member.rank.level }} | Уровень | 12 |
{{ member.rank.totalExp }} | Весь опыт участника | 18 430 |
{{ member.rank.levelCurrentExp }} | Опыт, набранный на текущем уровне | 540 |
{{ member.rank.levelExp }} | Сколько опыта нужно на текущем уровне целиком | 1 420 |
{{ member.rank.remainingExp }} | Сколько осталось до следующего уровня | 880 |
{{ member.rank.rank }} | Место в рейтинге чата | 7 |
{{ member.rank.cookies }} | Сколько печенек участнику подарили (если печеньки включены) | 15 |
Чат
chat — чат, в котором работает бот.
| Переменная | Что подставится | Пример |
|---|---|---|
{{ chat.title }} | Название чата | Клуб Astral |
{{ chat.memberCount }} | Сколько участников | 1248 |
{{ chat.username }} | Публичный username чата, если есть | astral_club |
{{ chat.inviteLink }} | Ссылка-приглашение (если у бота есть право приглашать) | https://t.me/+AbCd… |
{{ chat.owner }} | Создатель чата (упоминанием) | Иван |
{{ chat.id }} | Числовой ID чата | -1001234567890 |
Красивые числа
Чтобы 1248 выглядело как «1 248», добавьте | number_format:
Нас уже {{ chat.memberCount | number_format }}!Вертикальная черта | значит «передать значение в функцию». Подробнее о функциях — в расширенном руководстве.
Бот
bot — сам бот. У него те же переменные, что у участника.
| Переменная | Что подставится |
|---|---|
{{ bot }} | Упоминание бота |
{{ bot.name }} | Имя бота |
{{ bot.username }} | Username бота |
Топик
Если чат — форум с топиками, topic — топик, куда бот отправляет сообщение.
| Переменная | Что подставится |
|---|---|
{{ topic }} или {{ topic.name }} | Название топика |
{{ topic.mention }} | Ссылка на топик |
{{ topic.isGeneral }} | true, если это основной топик General |
Сообщение
message — сообщение, из-за которого бот отвечает: вызов команды или сообщение, нарушившее правила.
| Переменная | Что подставится |
|---|---|
{{ message.text }} | Текст сообщения |
{{ message.author }} | Автор (упоминанием) |
{{ message.jumpUrl }} | Ссылка на сообщение |
{{ message.createdAt }} | Когда отправлено |
Аргументы команды
Только в пользовательских командах. Аргументы — это то, что участник написал после команды. Если он написал !кубик 20, то 20 — первый аргумент.
| Переменная | Что подставится |
|---|---|
{{ arguments.get(1) }} | Первое слово после команды |
{{ arguments.get(2) }} | Второе слово |
{{ arguments.after(2) }} | Все, начиная со второго слова |
{{ arguments.targetMember }} | Участник, к которому обращена команда: на чье сообщение ответили или кого упомянули |
Подробно — в статье Аргументы команды.
Дата и время
| Переменная | Что подставится | Пример |
|---|---|---|
{{ now() }} | Сейчас. По нажатию Telegram покажет время в часовом поясе того, кто смотрит | сб, 11 апр. 2026 15:27:38 MSK |
{{ date(now(), 'dd.MM.yyyy') }} | Сегодняшняя дата в формате, который вы задали | 11.04.2026 |
{{ date(now(), 'HH:mm') }} | Время по часовому поясу чата | 15:27 |
{{ date(member.joinedAt, 'd MMMM yyyy') }} | Дата вступления участника | 11 апреля 2026 |
Буквы в формате даты: dd — день, MM — номер месяца, MMMM — месяц словом, yyyy — год, HH — часы, mm — минуты. Полный список — в описании функции date.
Когда переменной нет
Если данных нет — например, у участника нет username, — на месте пропуска будет пусто. Чтобы подставить что-то свое, используйте ?::
Ваш username: {{ member.username ?: 'не указан' }}Знак ?: читается как «а если пусто, то». Если username есть, выведется он, иначе — «не указан».
Где найти остальные переменные
Здесь только самое нужное. Полные списки — в справочнике типов: Member, Chat, Rank, Topic, Message. Их же можно найти прямо в редакторе через кнопку «Справочник».