Karty a tlačidlá botov
Karty s farbou, poľami, obrázkami a stavom a k tomu tlačidlá, ktoré menia kartu pre všetkých.
To, čo pošle webhook, príkaz s lomkou alebo účet bota, nemusí byť obyčajný text. Môže to byť karta, štruktúrovaná správa, ktorú pochopíš na prvý pohľad, s tlačidlami pod ňou.
Karty
Karta môže mať:
- farebný okraj: modrý (predvolený), zelený, červený, oranžový, žltý alebo fialový
- nadpis (voliteľne ako odkaz), podnadpis a popis v markdowne
- polia: riadky s označením a hodnotou, ktoré členovia skopírujú jedným klepnutím
- obrázky: jeden obrázok alebo galériu
- loader: točiaci sa indikátor s vlastným textom, napríklad „Premýšľam…“, ktorý vymeníš za výsledok, keď bude hotový
Odpoveď na príkaz s lomkou môže ukázať viac: štítok stavu, napríklad Open, Merged alebo Passing, odznak v hlavičke, pridané a odobraté riadky a uvažovanie skryté za prepínačom. Karta poslaná cez webhook ich vynecháva a jej hlavička vždy zobrazuje vlastný názov webhooku.
Predstav si pull requesty, deploye a tikety podpory: prehľadné na prvý pohľad namiesto steny textu.
Tlačidlá
Tlačidlá sú pod kartou. Ich type určuje, čo stlačenie urobí:
url:{url}otvorí odkaz.webhook_actionvykoná kroky uložené spolu s tlačidlom: aktualizuje kartu, odstráni ju, pridá reakciu alebo pošle odpoveď. Bežia na serveri mssgs a výsledok vidí každý v kanáli, takže „Schváliť“ alebo „Otvoriť bránu“ nepotrebuje tvoj vlastný server.trigger:{guid}spustí niektorý z triggerov tvojej komunity s údajmi tlačidla, ako keby niekto príkaz napísal. Odpoveď príde ako nová karta.
Spätná väzba
Príspevok z webhooku s tlačidlami dostane späť stream_url a každá požiadavka príkazu s lomkou ho obsahuje: živý stream stlačení, reakcií a odpovedí na túto správu. Zostáva otvorený 10 minút (pri príspevkoch z webhooku na požiadanie hodinu) a nič neuchováva na neskôr, takže sa pripoj hneď. Ak chceš správu neskôr zmeniť, použi jej callback_url, ktorá funguje 30 minút. Účet bota sa o svojich kartách dozvedá namiesto toho cez MCP server.
button s krokmi ws:send, local:update_message, local:remove_message, podmienky ako previous:success a expire_in_seconds už pre externých odosielateľov nefungujú. Použi webhook_action s krokmi uvedenými vyššie: dostanú sa ku všetkým, nielen k tomu, kto tlačidlo stlačil.Každé pole karty spolu so živým nástrojom na skladanie kariet nájdeš na stránke karty správ. Kroky tlačidiel, udalosti a chyby sú na stránke tlačidlá, stream a callback URL na stránke aktualizácie naživo.