Card e pulsanti dei bot

Quello che pubblica un webhook, un comando slash o un account bot non deve essere testo semplice. Può essere una card, un messaggio strutturato che si legge a colpo d'occhio, con dei pulsanti sotto.

Card

Una card può avere:

• un bordo colorato: blu (predefinito), verde, rosso, arancione, giallo o viola
• un titolo (eventualmente un link), un sottotitolo e una descrizione in markdown
• campi: righe etichetta e valore che i membri copiano con un tocco
• immagini: un'immagine o una galleria
• uno stato di caricamento: una rotellina con una tua riga, come "Sto pensando…", che sostituisci con il risultato quando è pronto

La risposta a un comando slash può mostrare di più: una pillola di stato come Open, Merged o Passing, un badge nell'intestazione, le righe aggiunte e rimosse e un ragionamento ripiegato dietro un interruttore. Una card pubblicata tramite webhook li tralascia, e la sua intestazione mostra sempre il nome del webhook.

Pensa a pull request, deploy e ticket di supporto: leggibili a colpo d'occhio invece di un muro di testo.

Pulsanti

I pulsanti stanno sotto la card. Il loro type decide cosa fa una pressione:

• url:{url} apre un link.
• webhook_action esegue i passi che hai salvato con il pulsante: aggiornare la card, rimuoverla, aggiungere una reazione o pubblicare una risposta. Girano sul server di mssgs e tutto il canale vede il risultato, quindi "Approva" o "Apri il cancello" non richiedono un server tuo.
• trigger:{guid} avvia uno dei trigger della tua community con i dati del pulsante, come se qualcuno avesse scritto il comando. La risposta arriva come nuova card.

Cosa ti torna indietro

Un messaggio via webhook con pulsanti riceve in risposta una stream_url, e ogni richiesta di un comando slash ne contiene una: un flusso live delle pressioni, reazioni e risposte su quel messaggio. Resta aperto 10 minuti (un'ora su richiesta, per i messaggi via webhook) e non conserva nulla per dopo, quindi collegati subito. Per cambiare il messaggio in seguito usa la sua callback_url, valida per 30 minuti. Un account bot viene informato di ciò che succede alle sue card tramite il server MCP.

Ogni campo delle card, con un costruttore di card dal vivo, è in card dei messaggi. Passi, eventi ed errori dei pulsanti sono in pulsanti, il flusso e l'URL di callback in aggiornamenti live.