Карточки и кнопки ботов

То, что публикует вебхук, слэш-команда или аккаунт бота, не обязано быть простым текстом. Это может быть карточка, структурированное сообщение, понятное с одного взгляда, с кнопками под ней.

Карточки

У карточки может быть:

• цветная кромка: синяя (по умолчанию), зелёная, красная, оранжевая, жёлтая или фиолетовая
• заголовок (при желании ссылка), подзаголовок и описание в markdown
• поля: строки «название - значение», которые участники копируют одним касанием
• изображения: одно изображение или галерея
• состояние загрузки: индикатор с вашей собственной строкой, например «Думаю…», который вы заменяете результатом, когда он готов

Ответ на слэш-команду может показать больше: плашку статуса вроде Open, Merged или Passing, значок в шапке, добавленные и удалённые строки и рассуждение, свёрнутое за переключателем. Карточка, опубликованная через вебхук, их не показывает, а в её шапке всегда стоит собственное имя вебхука.

Представьте пул-реквесты, деплои и заявки поддержки: всё понятно с одного взгляда, а не стеной текста.

Кнопки

Кнопки находятся под карточкой. Их type определяет, что делает нажатие:

• url:{url} открывает ссылку.
• webhook_action выполняет шаги, сохранённые вместе с кнопкой: обновить карточку, удалить её, добавить реакцию или опубликовать ответ. Они выполняются на сервере mssgs, и весь канал видит результат, так что для «Одобрить» или «Открыть ворота» не нужен свой сервер.
• trigger:{guid} запускает один из триггеров вашего сообщества с данными кнопки, как будто кто-то ввёл команду. Ответ приходит новой карточкой.

Что приходит обратно

Публикация через вебхук с кнопками получает в ответ stream_url, и каждый запрос слэш-команды содержит такой же: поток в реальном времени с нажатиями, реакциями и ответами на это сообщение. Он открыт 10 минут (по запросу час, для публикаций через вебхук) и ничего не сохраняет на потом, поэтому подключайтесь сразу. Чтобы изменить сообщение позже, используйте его callback_url, который действует 30 минут. Аккаунт бота узнаёт о том, что происходит с его карточками, через MCP-сервер.

Все поля карточки и живой конструктор карточек есть на странице карточки сообщений. Шаги, события и ошибки кнопок описаны на странице кнопки, поток и URL обратного вызова на странице обновления вживую.