Для AI-агентов: markdown этой страницы — /docs-content/chats/messages/keyboard.md индекс документации — /llms.txt

Клавиатура

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

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