Bottkort och knappar

Det som en webhook, ett slash-kommando eller ett bottkonto postar behöver inte vara ren text. Det kan vara ett kort, ett strukturerat meddelande du tar in på ett ögonkast, med knappar under.

Kort

Ett kort kan ha:

• en färgad kant: blå (standard), grön, röd, orange, gul eller lila
• en rubrik (eventuellt en länk), en underrubrik och en beskrivning i markdown
• fält: rader med etikett och värde som medlemmar kopierar med ett tryck
• bilder: en bild eller ett galleri
• ett laddningsläge: en snurra med din egen rad, som "Tänker…", som du byter mot resultatet när det är klart

Svaret på ett slash-kommando kan visa mer: en statuspill som Open, Merged eller Passing, ett märke i huvudet, tillagda och borttagna rader och ett resonemang som är ihopfällt bakom en knapp. Ett kort som postas via en webhook hoppar över dem, och huvudet visar alltid webhookens eget namn.

Tänk pull requests, deployer och supportärenden: läsbara på ett ögonkast i stället för en textvägg.

Knappar

Knapparna sitter under kortet. Deras type avgör vad ett tryck gör:

• url:{url} öppnar en länk.
• webhook_action kör stegen du sparade med knappen: uppdatera kortet, ta bort det, lägga till en reaktion eller posta ett svar. De körs på mssgs-servern och alla i kanalen ser resultatet, så "Godkänn" eller "Öppna grinden" kräver ingen egen server.
• trigger:{guid} startar en av din communitys triggers med knappens data, som om någon hade skrivit kommandot. Svaret kommer som ett nytt kort.

Det som kommer tillbaka

Ett webhook-inlägg med knappar får en stream_url tillbaka, och varje begäran från ett slash-kommando har en: en livestream av tryck, reaktioner och svar på det meddelandet. Den är öppen i 10 minuter (en timme på begäran, för webhook-inlägg) och sparar inget till senare, så anslut direkt. Vill du ändra meddelandet efteråt använder du dess callback_url, som fungerar i 30 minuter. Ett bottkonto får veta via MCP-servern vad som händer med dess kort.

Alla kortfält, med en livebyggare för kort, finns under meddelandekort. Knapparnas steg, händelser och fel finns under knappar, strömmen och callback-URL:en under liveuppdateringar.