---
url: /templates.md
description: >-
  Что такое шаблоны сообщений Astral Moderation, где они используются и с чего
  начать их изучение.
---

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

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

## Как это работает { #how }

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

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

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

<TgPreview>

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

</TgPreview>

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

## Из чего состоит шаблон { #structure }

У каждого шаблона есть три части, которые вы видите в [редакторе](./editor):

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

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

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

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

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

## С чего начать { #start }

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

<div class="cards">
  <a class="card" href="/templates/beginners/">
    <span class="card-title">Новичкам</span>
    <span class="card-text">Вы далеки от программирования и хотите просто подставить имя участника, оформить текст и добавить кнопку.</span>
  </a>
  <a class="card" href="/commands/">
    <span class="card-title">Пользовательские команды</span>
    <span class="card-text">Вы хотите сделать свою команду: кубик, анкету, магазин, топ участников.</span>
  </a>
  <a class="card" href="/templates/advanced/">
    <span class="card-title">Расширенное руководство</span>
    <span class="card-text">Вы готовы изучить язык целиком: выражения, теги, функции, макросы и хранилища.</span>
  </a>
</div>

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