Bot-kort og knapper

Det, en webhook, en slash-kommando eller en bot-konto poster, behøver ikke være ren tekst. Det kan være et kort, en struktureret besked, du fanger på et øjeblik, med knapper nedenunder.

Kort

Et kort kan have:

• en farvet kant: blå (standard), grøn, rød, orange, gul eller lilla
• en titel (eventuelt et link), en undertitel og en beskrivelse i markdown
• felter: rækker med etiket og værdi, som medlemmer kopierer med ét tryk
• billeder: ét billede eller et galleri
• en indlæsningstilstand: en spinner med din egen linje, som "Tænker…", som du erstatter med resultatet, når det er klar

Svaret på en slash-kommando kan vise mere: en statuspille som Open, Merged eller Passing, et mærke i toppen, tilføjede og fjernede linjer og en begrundelse, der er foldet væk bag en knap. Et kort sendt via en webhook udelader dem, og toppen viser altid webhookens eget navn.

Tænk på pull requests, deploys og supportsager: til at fange på et øjeblik i stedet for en mur af tekst.

Knapper

Knapperne sidder under kortet. Deres type afgør, hvad et tryk gør:

• url:{url} åbner et link.
• webhook_action kører de trin, du har gemt med knappen: opdatere kortet, fjerne det, tilføje en reaktion eller poste et svar. De kører på mssgs-serveren, og alle i kanalen ser resultatet, så "Godkend" eller "Åbn porten" kræver ingen server af din egen.
• trigger:{guid} starter en af dit fællesskabs triggere med knappens data, som om nogen havde skrevet kommandoen. Svaret kommer som et nyt kort.

Det, der kommer tilbage

Et webhook-opslag med knapper får en stream_url tilbage, og hver forespørgsel fra en slash-kommando har en med: en livestream af tryk, reaktioner og svar på den besked. Den er åben i 10 minutter (en time efter ønske, for webhook-opslag) og gemmer intet til senere, så forbind med det samme. Vil du ændre beskeden bagefter, så brug dens callback_url, som virker i 30 minutter. En bot-konto hører via MCP-serveren, hvad der sker med dens kort.

Alle kortfelter, med en live-kortbygger, står under beskedkort. Knappernes trin, hændelser og fejl står under knapper, streamen og callback-URL'en under liveopdateringer.