---
url: /templates/beginners.md
description: >-
  Шаблоны сообщений для тех, кто никогда не программировал. Первое приветствие
  за пять минут.
---

# Первые шаги

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

## Шаблон — это текст с пропусками { #idea }

Вы пишете сообщение один раз, а в местах, где должно стоять что-то меняющееся — имя, число, дата, — ставите **пропуск**. Каждый раз, когда бот отправляет сообщение, он заполняет пропуски свежими данными.

Пропуск выглядит так: две фигурные скобки, внутри — название того, что нужно подставить.

```template
{{ member.name }}
```

* `{{` и `}}` — начало и конец пропуска. Бот видит их и понимает: «здесь нужно что-то подставить».
* `member` — участник, о котором идет речь (тот, кто зашел в чат или вызвал команду).
* `.name` — его имя. Точка означает «у участника взять имя».

::: tip Как набрать фигурные скобки
На русской раскладке фигурных скобок нет — переключитесь на английскую. Затем зажмите <kbd>Shift</kbd> и нажмите клавишу, на которой нарисована буква <kbd>Х</kbd>, — получится `{`. Клавиша с буквой <kbd>Ъ</kbd> даст `}`.
:::

## Собираем первое приветствие { #first }

<div class="steps">

### Откройте настройки приветствия

В панели выберите свой чат, затем в меню слева — **«Приветствия»**. Включите **«Приветствие при входе»**.

### Напишите текст

В поле шаблона напишите обычное приветствие, как написали бы его сами:

```template
Привет! Добро пожаловать в наш чат.
```

Это уже рабочий шаблон — просто без пропусков. Бот отправит его каждому новичку слово в слово.

### Добавьте имя участника

Поставьте пропуск туда, где должно быть имя:

```template
Привет, {{ member.name }}! Добро пожаловать в наш чат.
```

Посмотрите на превью справа — там уже появилось имя тестового участника.

### Добавьте название чата

Название чата хранится в `chat.title`:

```template
Привет, {{ member.name }}! Добро пожаловать в «{{ chat.title }}».
```

### Сохраните и проверьте

Нажмите **«Сохранить»** (или <kbd>Ctrl</kbd> + <kbd>S</kbd>). Чтобы увидеть настоящий результат, нажмите **«Отправить тест в ЛС»** — бот пришлет приветствие вам в личные сообщения.

</div>

Вот что увидит новичок:

<TgPreview>

Привет, Анна! Добро пожаловать в «Клуб Astral».

</TgPreview>

## Упоминание вместо имени { #mention }

Если написать просто `{{ member }}` без точки и названия, бот вставит не имя, а **упоминание** — имя-ссылку. Участник получит уведомление, а по нажатию на имя откроется его профиль.

```template
Привет, {{ member }}! Добро пожаловать.
```

<TgPreview>

Привет, [Анна](#)! Добро пожаловать.

</TgPreview>

## Сделайте текст красивее { #pretty }

Звездочки делают текст жирным, решетка в начале строки — заголовком:

```template
# Добро пожаловать!

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

<TgPreview>

# Добро пожаловать!

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

</TgPreview>

Все про оформление — в статье [Оформление текста](./formatting).

## Три вида скобок { #brackets }

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

| Скобки | Что делают | Пример |
|---|---|---|
| `{{ … }}` | **Выводят** значение: бот подставит его в текст | `{{ member.name }}` |
| `{% … %}` | **Выполняют** команду: проверить условие, повторить, добавить кнопку. Сами ничего не печатают | `{% if member.isPremium %}…{% endif %}` |
| `{# … #}` | **Комментарий** — заметка для себя. Бот ее пропускает | `{# поменять ссылку в мае #}` |

Все, что написано вне скобок, бот отправляет как есть.

## Что дальше { #next }

<div class="cards">
  <a class="card" href="/templates/beginners/variables">
    <span class="card-title">Простые переменные</span>
    <span class="card-text">Какие данные можно подставить: имя, username, уровень, число участников, дата.</span>
  </a>
  <a class="card" href="/templates/beginners/formatting">
    <span class="card-title">Оформление текста</span>
    <span class="card-text">Жирный, заголовки, списки, таблицы, спойлеры и ссылки.</span>
  </a>
  <a class="card" href="/templates/beginners/conditions">
    <span class="card-title">Условия «если… то…»</span>
    <span class="card-text">Разный текст для разных участников: новичков, админов, владельцев Premium.</span>
  </a>
  <a class="card" href="/templates/beginners/buttons">
    <span class="card-title">Кнопки под сообщением</span>
    <span class="card-text">Кнопка «Правила» со ссылкой и другие кнопки.</span>
  </a>
</div>