Kartice i gumbi botova
Kartice s bojom, poljima, slikama i statusom te gumbi koji mijenjaju karticu za sve u kanalu.
Ono što objavi webhook, slash naredba ili račun bota ne mora biti običan tekst. Može biti kartica, strukturirana poruka koju shvatiš na prvi pogled, s gumbima ispod.
Kartice
Kartica može imati:
- obojeni rub: plavi (zadano), zeleni, crveni, narančasti, žuti ili ljubičasti
- naslov (po želji kao poveznicu), podnaslov i opis u markdownu
- polja: retke s oznakom i vrijednošću koje članovi kopiraju jednim dodirom
- slike: jednu sliku ili galeriju
- loader: indikator učitavanja s tvojim vlastitim tekstom, na primjer „Razmišljam…“, koji zamijeniš rezultatom kad bude gotov
Odgovor na slash naredbu može prikazati i više: oznaku statusa kao što su Open, Merged ili Passing, značku u zaglavlju, dodane i uklonjene retke te razmišljanje skriveno iza prekidača. Kartica objavljena putem webhooka to izostavlja, a njezino zaglavlje uvijek prikazuje ime samog webhooka.
Zamisli pull requestove, deployeve i tikete podrške: pregledno na prvi pogled umjesto zida teksta.
Gumbi
Gumbi se nalaze ispod kartice. Njihov type određuje što se događa na pritisak:
url:{url}otvara poveznicu.webhook_actionizvodi korake spremljene uz gumb: ažurira karticu, uklanja je, dodaje reakciju ili objavljuje odgovor. Izvode se na mssgs serveru i rezultat vide svi u kanalu, pa za „Odobri“ ili „Otvori vrata“ ne trebaš vlastiti server.trigger:{guid}pokreće jedan od triggera tvoje zajednice s podacima gumba, kao da je netko upisao naredbu. Odgovor stiže kao nova kartica.
Povratne informacije
Objava putem webhooka s gumbima dobiva natrag stream_url, a svaki zahtjev slash naredbe ga sadrži: to je tok uživo s pritiscima, reakcijama i odgovorima na tu poruku. Ostaje otvoren 10 minuta (na zahtjev sat vremena, za objave putem webhooka) i ništa ne čuva za kasnije, pa se poveži odmah. Ako poruku kasnije želiš promijeniti, upotrijebi njezin callback_url, koji vrijedi 30 minuta. Račun bota za svoje kartice umjesto toga saznaje putem MCP servera.
button s koracima ws:send, local:update_message, local:remove_message, uvjeti poput previous:success te expire_in_seconds više ne rade za vanjske pošiljatelje. Upotrijebi webhook_action s gore navedenim koracima: oni dopiru do svih, a ne samo do osobe koja je pritisnula gumb.Svako polje kartice, uz alat za izradu kartica uživo, nalazi se na stranici kartice poruka. Koraci gumba, događaji i pogreške nalaze se na stranici gumbi, a tok i callback URL na stranici ažuriranja uživo.