Botide kaardid ja nupud
Kaardid värvi, väljade, piltide ja olekuga ning nupud, mis muudavad kaarti kõigi jaoks.
See, mida webhook, kaldkriipsukäsk või botikonto postitab, ei pea olema lihtne tekst. See võib olla kaart, struktureeritud sõnum, mille haarad ühe pilguga, ja selle all võivad olla nupud.
Kaardid
Kaardil võib olla:
- värviline serv: sinine (vaikimisi), roheline, punane, oranž, kollane või lilla
- pealkiri (soovi korral lingina), alapealkiri ja markdownis kirjeldus
- väljad: sildi ja väärtusega read, mida liikmed ühe puudutusega kopeerivad
- pildid: üks pilt või galerii
- laadija: keerlev ikoon sinu enda tekstiga, näiteks „Mõtlen…“, mille vahetad tulemuse vastu, kui see valmis on
Kaldkriipsukäsu vastus võib näidata rohkemat: olekumärgist, näiteks Open, Merged või Passing, märki päises, lisatud ja eemaldatud ridu ning arutluskäiku, mis on lüliti taha peidetud. Webhooki kaudu postitatud kaardil neid pole ja selle päises on alati webhooki enda nimi.
Mõtle pull requestidele, juurutustele ja tugipöördumistele: ühe pilguga haaratav, mitte tekstisein.
Nupud
Nupud on kaardi all. Nende type määrab, mida vajutus teeb:
url:{url}avab lingi.webhook_actionkäivitab sammud, mille nupuga koos salvestasid: uuendab kaarti, eemaldab selle, lisab reaktsiooni või postitab vastuse. Need käivituvad mssgs’i serveris ja tulemust näevad kõik kanalis, nii et „Kiida heaks“ või „Ava värav“ ei vaja sinu enda serverit.trigger:{guid}käivitab nupu andmetega mõne sinu kogukonna triggeri, nagu oleks keegi käsu sisestanud. Vastus saabub uue kaardina.
Tagasiside
Nuppudega webhooki postitus saab vastuseks stream_url-i ja iga kaldkriipsukäsu päring sisaldab seda: see on reaalajas voog selle sõnumi nupuvajutustest, reaktsioonidest ja vastustest. See jääb avatuks 10 minutiks (webhooki postituste puhul soovi korral tunniks) ega säilita midagi hilisemaks, nii et ühendu kohe. Sõnumi hilisemaks muutmiseks kasuta selle callback_url-i, mis töötab 30 minutit. Botikonto saab oma kaartide kohta teada hoopis MCP-serveri kaudu.
button nupud koos ws:send sammudega, local:update_message, local:remove_message, tingimused nagu previous:success ja expire_in_seconds ei tööta välistele saatjatele enam. Kasuta webhook_action-it ülal kirjeldatud sammudega: need jõuavad kõigini, mitte ainult nupu vajutajani.Iga kaardi väli koos reaalajas kaardikoostajaga on lehel sõnumikaardid. Nupusammud, sündmused ja vead on lehel nupud, voog ja callback URL lehel reaalajas uuendused.