---
url: /templates/beginners/buttons.md
description: >-
  Как добавить под сообщение бота кнопку-ссылку, кнопку «Скопировать» и
  расположить кнопки в несколько рядов.
---

# Кнопки под сообщением

<p class="lead">Под сообщением бота можно поставить кнопки: открыть правила, перейти на сайт клуба, скопировать промокод. Кнопки добавляются одной строкой в шаблоне.</p>

## Кнопка-ссылка { #url }

```template
Добро пожаловать, {{ member }}! Перед общением прочитай правила.
{% do url_button('Правила чата', 'https://telegra.ph/pravila-chata') %}
```

<TgPreview :buttons="[['Правила чата|link']]">

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

</TgPreview>

Что здесь написано:

* `url_button` — «кнопка-ссылка»;
* в скобках через запятую: **что написано на кнопке** и **куда ведет**. Оба значения — в кавычках;
* `{% do … %}` — «выполнить». Кнопка не печатается в тексте, а появляется под сообщением, поэтому здесь процентные скобки, а не `{{ }}`.

Строку с кнопкой можно поставить в любое место шаблона — кнопка все равно окажется под сообщением. Удобнее держать кнопки в конце.

::: info Кнопки в приветствии — без кода
В разделе **«Приветствия»** под полем шаблона есть блок **«Кнопки»**: там можно добавить до 10 кнопок-ссылок, просто заполнив название и адрес.
:::

## Несколько кнопок и ряды { #rows }

Кнопки, добавленные подряд, встают в один ряд. Чтобы начать новый ряд, вставьте `{% do row() %}`:

```template
Полезные ссылки клуба:
{% do url_button('Сайт', 'https://example.com') %}
{% do url_button('Канал', 'https://t.me/example') %}
{% do row() %}
{% do url_button('Правила', 'https://telegra.ph/pravila-chata') %}
```

<TgPreview :buttons="[['Сайт|link', 'Канал|link'], ['Правила|link']]">

Полезные ссылки клуба:

</TgPreview>

## Кнопка «Скопировать» { #copy }

По нажатию текст копируется в буфер обмена участника. Удобно для промокодов, тегов игроков, адресов:

```template
Промокод на эту неделю: **ASTRAL2026**
{% do copy_button('Скопировать промокод', 'ASTRAL2026') %}
```

<TgPreview :buttons="[['Скопировать промокод|copy']]">

Промокод на эту неделю: **ASTRAL2026**

</TgPreview>

## Кнопки с эмодзи { #emoji }

Эмодзи можно просто написать в названии кнопки:

```template
{% do url_button('📜 Правила', 'https://telegra.ph/pravila-chata') %}
```

## Кнопки, которые что-то делают { #actions }

Кнопки выше только открывают ссылку или копируют текст. Кнопки, которые **запускают действие** — «Подтвердить», «Следующая страница», «Получить роль», — бывают только в [пользовательских командах](/commands/). Там же у кнопок есть цвета: синий, зеленый и красный.

<TgPreview :buttons="[['✅ Подтвердить|success', '❎ Отмена'], ['⬅️', '➡️|primary']]">

Вы действительно хотите забанить участника [Иван](#)?

</TgPreview>

Как их сделать — в статье [Кнопки и меню выбора](/commands/components).

## Кнопка-ссылка через button { #button-function }

Кнопку-ссылку можно добавить и через функцию `button` со стилем `LINK`:

```template
{% do button('LINK', 'https://telegra.ph/pravila-chata', 'Правила') %}
```

Это то же самое, что `url_button('Правила', 'https://telegra.ph/pravila-chata')`.

## Ограничения { #limits }

* Под одним сообщением — не больше 25 кнопок.
* В одном ряду удобно держать до 3–4 кнопок: на телефоне длинные названия обрежутся.
* Ссылки на кнопках начинаются с `https://`, `http://` или `tg://`.