Carduri și butoane pentru boți

Ce publică un webhook, o comandă slash sau un cont de bot nu trebuie să fie text simplu. Poate fi un card, un mesaj structurat pe care îl înțelegi dintr-o privire, cu butoane dedesubt.

Carduri

Un card poate avea:

• o margine colorată: albastră (implicit), verde, roșie, portocalie, galbenă sau mov
• un titlu (opțional ca link), un subtitlu și o descriere în markdown
• câmpuri: rânduri cu etichetă și valoare, pe care membrii le copiază cu o atingere
• imagini: o imagine sau o galerie
• un loader: un indicator care se rotește, cu propriul tău text, de exemplu „Mă gândesc…”, pe care îl înlocuiești cu rezultatul când e gata

Răspunsul la o comandă slash poate arăta mai mult: o etichetă de status precum Open, Merged sau Passing, o insignă în antet, liniile adăugate și eliminate, plus raționamentul ascuns în spatele unui comutator. Un card publicat printr-un webhook le omite, iar antetul lui arată mereu numele webhook-ului.

Gândește-te la pull requesturi, lansări și tichete de suport: clare dintr-o privire, în loc de un zid de text.

Butoane

Butoanele stau sub card. Câmpul lor type decide ce se întâmplă la apăsare:

• url:{url} deschide un link.
• webhook_action rulează pașii pe care i-ai salvat împreună cu butonul: actualizează cardul, îl elimină, adaugă o reacție sau publică un răspuns. Pașii rulează pe serverul mssgs și toată lumea din canal vede rezultatul, așa că „Aprobă” sau „Deschide poarta” nu au nevoie de un server al tău.
• trigger:{guid} declanșează unul dintre triggerele comunității tale cu datele butonului, ca și cum cineva ar fi scris comanda. Răspunsul vine ca un card nou.

Cum afli ce se întâmplă

O postare prin webhook cu butoane primește înapoi un stream_url, iar fiecare cerere de comandă slash conține unul: un flux live cu apăsările, reacțiile și răspunsurile la acel mesaj. Rămâne deschis 10 minute (o oră la cerere, pentru postările prin webhook) și nu păstrează nimic pentru mai târziu, așa că conectează-te imediat. Ca să schimbi mesajul după aceea, folosește callback_url-ul lui, care funcționează 30 de minute. Un cont de bot află în schimb despre cardurile lui prin serverul MCP.

Fiecare câmp al cardului, cu un constructor de carduri live, este pe pagina carduri de mesaj. Pașii butoanelor, evenimentele și erorile sunt pe pagina butoane, iar fluxul și URL-ul de callback pe pagina actualizări live.