Шаблоны сообщений

Шаблон сообщения — это текст, который бот отправит в чат, с пометками, куда подставить живые данные: имя участника, название чата, уровень, ответ на команду. Шаблоны есть везде, где бот что-то пишет: в приветствиях, в ответах команд, в уведомлениях автомодерации и в пользовательских командах.

Как это работает

Представьте открытку с пропусками: «Привет, ____! Ты ____-й участник». Вы пишете открытку один раз, а бот каждый раз заполняет пропуски сам. В шаблоне такие пропуски обозначаются двойными фигурными скобками:

Привет, {{ member }}! Ты {{ chat.memberCount }}-й участник чата.

Когда в чат зайдет Анна, бот подставит ее имя и число участников:

Как это выглядит в Telegram

Astral Moderation

Привет, Анна! Ты 1248-й участник чата.

14:02

За подстановку отвечает шаблонный движок — встроенная часть бота, которая читает шаблон, выполняет пометки и собирает готовое сообщение. Движок умеет не только подставлять данные, но и проверять условия («если у участника 10-й уровень…»), повторять строки для каждого элемента списка, считать, запоминать данные и добавлять кнопки.

Из чего состоит шаблон

У каждого шаблона есть три части, которые вы видите в редакторе:

Часть	Что это	Пример
Текст	Обычный текст сообщения с разметкой: жирный, заголовки, списки, таблицы	**Добро пожаловать!**
Вывод	Место, куда бот подставит значение	{{ member.name }}
Код	Команды для бота, которые сами ничего не печатают: условия, циклы, кнопки	{% if member.rank.level >= 10 %}

Есть еще комментарии {# … #} — заметки для себя, которые в сообщение не попадают.

Где используются шаблоны

• приветствие новичка и прощание;
• сообщение о повышении уровня;
• ответы встроенных команд (/warn, /mute, /rank и других) — их тексты можно переписать;
• уведомления автомодерации о нарушении;
• уведомление наказанному в личные сообщения;
• сообщения в лог-чат;
• пользовательские команды — самое мощное место, где доступны кнопки, формы и хранение данных.

В каждом месте свой набор данных. Например, в приветствии есть member (кто зашел), а в ответе команды — еще и arguments (что написали после команды). Полная таблица — в статье Где используются шаблоны.

С чего начать

Шаблонный движок — мощный инструмент, но чтобы пользоваться им, не нужно быть программистом. Выберите свой путь:

НовичкамВы далеки от программирования и хотите просто подставить имя участника, оформить текст и добавить кнопку.Пользовательские командыВы хотите сделать свою команду: кубик, анкету, магазин, топ участников.Расширенное руководствоВы готовы изучить язык целиком: выражения, теги, функции, макросы и хранилища.

Не нашли ответ?

В конце каждой страницы есть кнопка «Скопировать страницу» со стрелкой. Через нее можно открыть страницу в ChatGPT, Claude или Gemini и спросить ИИ своими словами — он прочитает страницу и поможет с шаблоном.