## Клавиатура

Интерактивные кнопки под сообщением. Передаются в поле `keyboard` при отправке — массив, где каждая кнопка отдельный объект.

## Поля кнопки

| Поле | Тип | По умолч. | Описание |
|------|-----|-----------|---------|
| `TEXT` | string | — | Текст кнопки. Обязателен для всех кнопок, кроме `TYPE: "NEWLINE"` |
| `TYPE` | string | — | Специальный тип: `NEWLINE` — перенос на новую строку |
| `LINK` | string | — | URL — кнопка становится ссылкой |
| `ACTION` | string | — | Действие при нажатии: `PUT` (вставить в поле ввода), `SEND` (отправить текст), `COPY` (скопировать), `CALL` (позвонить), `DIALOG` (открыть чат) |
| `ACTION_VALUE` | string | — | Значение для `ACTION`: текст, номер телефона или ID чата |
| `BG_COLOR_TOKEN` | string | `base` | Готовый цвет фона (см. [токены ниже](#токены-цветов)) |
| `BG_COLOR` | string | — | Цвет фона в шестнадцатеричном формате (`#ff6600`) |
| `TEXT_COLOR` | string | — | Цвет текста в шестнадцатеричном формате |
| `DISPLAY` | string | `BLOCK` | Размещение: `LINE` (в строке с другими) или `BLOCK` (на всю ширину) |
| `DISABLED` | string | `N` | Неактивная кнопка: `Y` или `N` |
| `BLOCK` | string | `N` | `Y` — кнопка деактивируется после нажатия |
| `WIDTH` | integer | — | Ширина кнопки в пикселях |
| `CONTEXT` | string | `ALL` | Где показывать: `MOBILE`, `DESKTOP`, `ALL` |

## Токены цветов

| Токен | Цвет | Назначение |
|-------|------|-----------|
| `primary` | Синий | Основное действие |
| `secondary` | Серый | Дополнительное действие |
| `alert` | Красный | Опасное действие |
| `base` | Белый | Нейтральная кнопка (по умолчанию) |

## Пример

```json
{
  "message": "Подтвердите действие:",
  "keyboard": [
    { "TEXT": "Одобрить", "BG_COLOR_TOKEN": "primary", "ACTION": "SEND", "ACTION_VALUE": "/approve", "BLOCK": "Y" },
    { "TEXT": "Отклонить", "BG_COLOR_TOKEN": "alert", "ACTION": "SEND", "ACTION_VALUE": "/reject", "BLOCK": "Y" },
    { "TYPE": "NEWLINE" },
    { "TEXT": "Подробнее", "LINK": "https://example.com/tasks/42", "BG_COLOR_TOKEN": "secondary", "DISPLAY": "LINE" }
  ]
}
```

## Смотрите также

- [Отправить сообщение](/docs/chats/messages/send)
- [Форматирование текста](/docs/chats/messages/formatting)
- [Вложения](/docs/chats/messages/attach)