Karty a tlačítka botů
Karty s barvou, poli, obrázky a stavem a k tomu tlačítka, která změní kartu pro všechny.
To, co zveřejní webhook, příkaz s lomítkem nebo účet bota, nemusí být obyčejný text. Může to být karta, strukturovaná zpráva, kterou pochopíš na první pohled, s tlačítky pod ní.
Karty
Karta může mít:
- barevný okraj: modrý (výchozí), zelený, červený, oranžový, žlutý nebo fialový
- nadpis (volitelně jako odkaz), podnadpis a popis v markdownu
- pole: řádky s popiskem a hodnotou, které členové zkopírují jedním klepnutím
- obrázky: jeden obrázek nebo galerii
- loader: točící se indikátor s vlastním textem, třeba „Přemýšlím…“, který vyměníš za výsledek, až bude hotový
Odpověď na příkaz s lomítkem může ukázat víc: stavový štítek, třeba Open, Merged nebo Passing, odznak v záhlaví, přidané a odebrané řádky a uvažování schované za přepínačem. Karta zveřejněná přes webhook tohle vynechává a v jejím záhlaví je vždy vlastní jméno webhooku.
Představ si pull requesty, nasazení a tikety podpory: přehledné na první pohled místo záplavy textu.
Tlačítka
Tlačítka jsou pod kartou. Co stisk udělá, určuje jejich type:
url:{url}otevře odkaz.webhook_actionprovede kroky uložené u tlačítka: aktualizuje kartu, odstraní ji, přidá reakci nebo zveřejní odpověď. Běží na serveru mssgs a výsledek vidí všichni v kanálu, takže „Schválit“ nebo „Otevřít bránu“ nepotřebuje žádný vlastní server.trigger:{guid}spustí jeden z triggerů tvé komunity s daty tlačítka, jako by někdo napsal příkaz. Odpověď dorazí jako nová karta.
Zpětná vazba
Příspěvek z webhooku s tlačítky dostane zpět stream_url a každý požadavek příkazu s lomítkem ji obsahuje: je to živý stream stisků, reakcí a odpovědí u dané zprávy. Zůstává otevřený 10 minut (u příspěvků z webhooku na požádání hodinu) a nic neuchovává na později, takže se připoj hned. Pokud chceš zprávu později změnit, použij její callback_url, která funguje 30 minut. Účet bota se o svých kartách dozvídá místo toho přes MCP server.
button s kroky ws:send, local:update_message, local:remove_message, podmínky jako previous:success a expire_in_seconds už pro externí odesílatele nefungují. Použij webhook_action s kroky popsanými výše: dostanou se ke všem, nejen k tomu, kdo tlačítko stiskl.Každé pole karty i živý editor karet najdeš na stránce karty zpráv. Kroky tlačítek, události a chyby jsou na stránce tlačítka, stream a callback URL na stránce živé aktualizace.