Karty i przyciski botów

To, co publikuje webhook, komenda z ukośnikiem albo konto bota, nie musi być zwykłym tekstem. Może to być karta, uporządkowana wiadomość, którą ogarniasz jednym spojrzeniem, z przyciskami pod spodem.

Karty

Karta może mieć:

• kolorową krawędź: niebieską (domyślnie), zieloną, czerwoną, pomarańczową, żółtą lub fioletową
• tytuł (opcjonalnie jako link), podtytuł i opis w markdownie
• pola: wiersze z etykietą i wartością, które członkowie kopiują jednym dotknięciem
• obrazki: jeden obrazek albo galerię
• loader: kręcący się wskaźnik z twoim własnym tekstem, na przykład „Myślę…”, który podmieniasz na wynik, gdy będzie gotowy

Odpowiedź na komendę z ukośnikiem może pokazać więcej: pigułkę statusu, na przykład Open, Merged albo Passing, plakietkę w nagłówku, dodane i usunięte linie oraz rozumowanie schowane za przełącznikiem. Karta publikowana przez webhook ich nie pokazuje, a jej nagłówek zawsze wyświetla nazwę samego webhooka.

Pomyśl o pull requestach, wdrożeniach i zgłoszeniach do supportu: czytelne na pierwszy rzut oka zamiast ściany tekstu.

Przyciski

Przyciski są pod kartą. Ich type decyduje, co robi naciśnięcie:

• url:{url} otwiera link.
• webhook_action wykonuje kroki zapisane razem z przyciskiem: aktualizuje kartę, usuwa ją, dodaje reakcję albo publikuje odpowiedź. Działają na serwerze mssgs, a wynik widzi każdy na kanale, więc „Zatwierdź” czy „Otwórz bramę” nie wymagają twojego własnego serwera.
• trigger:{guid} uruchamia jeden z triggerów twojej społeczności z danymi przycisku, tak jakby ktoś wpisał komendę. Odpowiedź przychodzi jako nowa karta.

Informacje zwrotne

Post z webhooka z przyciskami dostaje w odpowiedzi stream_url, a każde żądanie komendy z ukośnikiem go zawiera: to strumień na żywo z naciśnięciami, reakcjami i odpowiedziami pod tą wiadomością. Pozostaje otwarty przez 10 minut (na życzenie przez godzinę, w przypadku postów z webhooka) i niczego nie przechowuje na później, więc połącz się od razu. Żeby później zmienić wiadomość, użyj jej callback_url, który działa przez 30 minut. Konto bota dowiaduje się o swoich kartach zamiast tego przez serwer MCP.

Każde pole karty, razem z kreatorem kart na żywo, opisuje strona karty wiadomości. Kroki przycisków, zdarzenia i błędy są na stronie przyciski, a strumień i adres callback na stronie aktualizacje na żywo.