Botkaarten & -knoppen

Wat een webhook, een slash-commando of een botaccount post, hoeft geen platte tekst te zijn. Het kan een kaart zijn, een gestructureerd bericht dat je in één oogopslag leest, met knoppen eronder.

Kaarten

Een kaart kan hebben:

• een gekleurde rand: blauw (standaard), groen, rood, oranje, geel of paars
• een titel (eventueel een link), een subtitel en een beschrijving in markdown
• velden: rijen met label en waarde die leden met één tik kopiëren
• afbeeldingen: één afbeelding of een galerij
• een laadtoestand: een spinner met je eigen regel, zoals "Aan het nadenken…", die je vervangt door het resultaat zodra het er is

Het antwoord op een slash-commando kan meer tonen: een statuslabel zoals Open, Merged of Passing, een badge in de kop, toegevoegde en verwijderde regels, en een redenering die achter een knop is weggevouwen. Een kaart via een webhook laat die weg, en de kop toont altijd de eigen naam van de webhook.

Denk aan pullrequests, deploys en supporttickets: in één oogopslag in plaats van een muur van tekst.

Knoppen

Knoppen staan onder de kaart. Hun type bepaalt wat een druk doet:

• url:{url} opent een link.
• webhook_action voert de stappen uit die je bij de knop hebt opgeslagen: de kaart bijwerken, verwijderen, een reactie toevoegen of een antwoord posten. Ze draaien op de mssgs-server en iedereen in het kanaal ziet het resultaat, dus "Goedkeuren" of "Hek openen" vraagt geen eigen server.
• trigger:{guid} start een van de triggers van je community met de gegevens van de knop, alsof iemand het commando had getypt. Het antwoord komt als nieuwe kaart.

Wat er terugkomt

Een webhookbericht met knoppen krijgt een stream_url terug, en elk verzoek van een slash-commando bevat er een: een live stream van de knopdrukken, reacties en antwoorden op dat bericht. Hij blijft 10 minuten open (op verzoek een uur, bij webhookberichten) en bewaart niets voor later, dus maak meteen verbinding. Wil je het bericht daarna nog veranderen, gebruik dan de callback_url, die 30 minuten werkt. Een botaccount hoort via de MCP-server wat er met zijn kaarten gebeurt.

Elk kaartveld, met een live kaartbouwer, staat bij berichtkaarten. Knopstappen, events en fouten staan bij knoppen, de stream en de callback-URL bij live-updates.