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

Те, що публікує вебхук, слеш-команда чи обліковий запис бота, не зобов'язане бути простим текстом. Це може бути картка, структуроване повідомлення, зрозуміле з одного погляду, з кнопками під нею.

Картки

Картка може мати:

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

Відповідь на слеш-команду може показати більше: плашку статусу на кшталт Open, Merged чи Passing, значок у шапці, додані й видалені рядки та міркування, згорнуте за перемикачем. Картка, опублікована через вебхук, їх не показує, а в її шапці завжди стоїть власне ім'я вебхука.

Уявіть пул-реквести, розгортання й заявки підтримки: усе зрозуміло з одного погляду, а не стіною тексту.

Кнопки

Кнопки розташовані під карткою. Їхній type визначає, що робить натискання:

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

Що надходить назад

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

Усі поля картки й живий конструктор карток є на сторінці картки повідомлень. Кроки, події та помилки кнопок описано на сторінці кнопки, потік і URL зворотного виклику на сторінці оновлення наживо.