#Клавиатура
Интерактивные кнопки под сообщением. Передаются в поле 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" }
]
}
#Смотрите также