Botkártyák és gombok

Amit egy webhook, egy perjeles parancs vagy egy botfiók posztol, annak nem kell sima szövegnek lennie. Lehet kártya is: egy pillantással átlátható, strukturált üzenet, alatta gombokkal.

Kártyák

Egy kártyán lehet:

• színes szegély: kék (alapértelmezett), zöld, piros, narancs, sárga vagy lila
• cím (akár linkként), alcím és markdown formátumú leírás
• mezők: címkét és értéket tartalmazó sorok, amelyeket a tagok egy koppintással másolhatnak
• képek: egyetlen kép vagy egy galéria
• betöltésjelző: forgó ikon saját szöveggel, például „Gondolkodom…”, amelyet lecserélsz az eredményre, amikor elkészül

Egy perjeles parancsra adott válasz többet is mutathat: állapotjelzőt, például Open, Merged vagy Passing, jelvényt a fejlécben, hozzáadott és törölt sorokat, valamint egy kapcsoló mögé rejtett gondolatmenetet. A webhookon keresztül posztolt kártya ezeket kihagyja, és a fejlécében mindig a webhook saját neve látszik.

Gondolj pull requestekre, deployokra és ügyfélszolgálati jegyekre: egy pillantással átláthatók, szövegfal helyett.

Gombok

A gombok a kártya alatt vannak. A type értékük határozza meg, mi történik megnyomáskor:

• Az url:{url} megnyit egy linket.
• A webhook_action lefuttatja a gombbal együtt eltárolt lépéseket: frissíti a kártyát, eltávolítja, reakciót ad hozzá vagy választ posztol. Ezek az mssgs szerverén futnak, és az eredményt mindenki látja a csatornában, így egy „Jóváhagyás” vagy „Kapunyitás” gombhoz nincs szükség saját szerverre.
• A trigger:{guid} elindítja a közösséged egyik triggerét a gomb adataival, mintha valaki beírta volna a parancsot. A válasz új kártyaként érkezik.

Visszajelzések

Egy gombokat tartalmazó webhookposzt válaszként kap egy stream_url értéket, és minden perjeles parancs kérése is tartalmaz egyet: ez az adott üzeneten történt gombnyomások, reakciók és válaszok élő adatfolyama. 10 percig marad nyitva (webhookposztoknál kérésre egy óráig), és semmit sem őriz meg későbbre, ezért csatlakozz azonnal. Ha utólag módosítanád az üzenetet, használd a callback_url címét, amely 30 percig működik. Egy botfiók ehelyett az MCP-szerveren keresztül értesül a kártyáiról.

Minden kártyamező, élő kártyaszerkesztővel együtt, az üzenetkártyák oldalon található. A gombok lépései, eseményei és hibái a gombok oldalon, az adatfolyam és a callback URL pedig az élő frissítések oldalon.