Bottikortit ja painikkeet
Kortteja väreineen, kenttineen, kuvineen ja tiloineen, sekä painikkeita, jotka muuttavat korttia kaikille.
Sen, mitä webhook, kauttaviivakomento tai bottitili julkaisee, ei tarvitse olla pelkkää tekstiä. Se voi olla kortti, jäsennelty viesti, jonka hahmottaa yhdellä silmäyksellä, ja sen alla painikkeita.
Kortit
Kortissa voi olla:
- värillinen reuna: sininen (oletus), vihreä, punainen, oranssi, keltainen tai violetti
- otsikko (halutessa linkki), alaotsikko ja kuvaus markdownina
- kentät: nimi- ja arvorivejä, jotka jäsenet kopioivat yhdellä napautuksella
- kuvat: yksi kuva tai galleria
- lataustila: pyörivä kuvake omalla rivilläsi, esimerkiksi "Mietin…", jonka vaihdat tulokseen, kun se on valmis
Vastaus kauttaviivakomentoon voi näyttää enemmän: tilapillerin, kuten Open, Merged tai Passing, merkin otsakkeessa, lisätyt ja poistetut rivit sekä päättelyn, joka on taitettu piiloon kytkimen taakse. Webhookin kautta julkaistusta kortista ne jäävät pois, ja sen otsakkeessa näkyy aina webhookin oma nimi.
Ajattele pull requesteja, julkaisuja ja tukipyyntöjä: silmäiltävissä tekstimuurin sijaan.
Painikkeet
Painikkeet ovat kortin alla. Niiden type ratkaisee, mitä painallus tekee:
url:{url}avaa linkin.webhook_actionsuorittaa vaiheet, jotka tallensit painikkeen mukana: kortin päivitys, sen poisto, reaktion lisäys tai vastauksen julkaisu. Ne ajetaan mssgs-palvelimella, ja koko kanava näkee tuloksen, joten "Hyväksy" tai "Avaa portti" ei vaadi omaa palvelinta.trigger:{guid}käynnistää jonkin yhteisösi liipaisimista painikkeen tiedoilla, ikään kuin joku olisi kirjoittanut komennon. Vastaus tulee uutena korttina.
Mitä takaisin tulee
Painikkeellinen webhook-julkaisu saa vastauksena stream_url-osoitteen, ja jokaisessa kauttaviivakomennon pyynnössä on sellainen: suora virta viestin painalluksista, reaktioista ja vastauksista. Se on auki 10 minuuttia (pyynnöstä tunnin, webhook-julkaisuissa) eikä säilytä mitään myöhempää varten, joten yhdistä heti. Jos haluat muuttaa viestiä myöhemmin, käytä sen callback_url-osoitetta, joka toimii 30 minuuttia. Bottitili saa tietää MCP-palvelimen kautta, mitä sen korteille tapahtuu.
button painikkeet ws:send-vaiheineen, local:update_message, local:remove_message, ehdot kuten previous:success sekä expire_in_seconds eivät enää toimi ulkopuolisille lähettäjille. Käytä webhook_action-painiketta yllä olevin vaihein: ne näkyvät kaikille, eivät vain painajalle.Jokainen korttikenttä ja korttien live-rakennustyökalu on sivulla viestikortit. Painikkeiden vaiheet, tapahtumat ja virheet ovat sivulla painikkeet, virta ja takaisinkutsuosoite sivulla live-päivitykset.