Lisää painikkeita
Lisää painikkeita minkä tahansa kortin alle. Painike avaa linkin, muuttaa korttia kaikille heti, kun joku napauttaa sitä, tai kertoo palvelullesi, että sitä painettiin.
Mitä voit tehdä
- Avaa linkkiOhjaa ihmiset sivulle, hallintapaneeliin tai pull requestiin.
- Muuta korttia napautuksellaMuokkaa sitä, poista se, reagoi tai vastaa suoraan painalluksesta ilman omaa palvelinta.
- Kuule jokainen painallusPalvelusi saa livenä tietää, kuka painoi mitäkin.
- Aja komentoPainike voi laukaista jonkin yhteisön kauttaviivakomennoista, datan kera.
Sovelluksessa
Joku soittaa ovikelloa: kortti ilmestyy
Napautus Avaa portti -painikkeeseen: kortti muuttuu kaikille
Itse muutokseen ei tarvita palvelinta: vaiheet on tallennettu viestin mukana. Porttiohjaimesi kuulee painalluksen ja avaa portin.
Pika-aloitus
Lisää actions-lista
Painikkeet kuuluvat kenttään
actionskortin rinnalle, webhook-julkaisussa, komennon vastauksessa tai päivityksessä.json{ "message_container": { "color": "yellow", "title": "Deploy v2.1 to production?", "description": "Requested by maya." }, "actions": [ { "type": "url:https://ci.example.com/deploys/218", "text": "View changes", "color": "blue" } ] }deploysValitse, mitä painallus tekee
Linkki, muutos korttiin tai kutsu palveluusi. Kolme tyyppiä on kuvattu alla.
Kolme painiketyyppiä
type ratkaisee, mitä painallus tekee.
| Tyyppi | Mitä painallus tekee | Tavoittaa sinut |
|---|---|---|
url:{url} | Avaa linkin. | Ei |
webhook_action | Suorittaa sen mukana tallentamasi vaiheet kaikille kanavalla. | Kyllä, viestin stream_url-virrassa |
trigger:{guid} | Laukaisee jonkin yhteisön liipaisimista painikkeen payload-datan kanssa. | Kyllä, uutena pyyntönä kyseisen liipaisimen URL:iin |
Muuta korttia napautuksella
webhook_action-painikkeessa on vaihelista kentässä triggers. Painettaessa vaiheet suoritetaan mssgs:n palvelimella järjestyksessä, ja kaikki kanavalla näkevät tuloksen.
| Vaihe | Mitä se tekee kaikille | Kentät |
|---|---|---|
update_message | Korvaa kortin ja sen painikkeet. Lähetä "actions": [], niin painikkeet poistuvat. | message_container, actions, content |
remove_message | Poistaa viestin. | Ei kenttiä |
add_reaction | Lisää reaktion painajan nimissä. | emoji |
add_reply | Julkaisee vastauksen painajan nimissä. | content |
{
"message_container": { "color": "yellow", "title": "Front door", "description": "Someone rang the bell." },
"actions": [
{
"type": "webhook_action",
"id": "open_gate",
"text": "Open gate",
"color": "green",
"payload": { "door": "front" },
"triggers": [
{
"action": "update_message",
"message_container": { "color": "blue", "title": "Front door", "description": "Opening…" },
"actions": []
},
{ "action": "add_reaction", "emoji": ":white_check_mark:" }
]
}
]
}Kuule painallus
Painikkeellinen viesti palaa webhookista stream_url-osoitteen kanssa. Pidä virta auki, niin jokainen painallus saapuu action-tyyppisenä tapahtumana, jossa ovat painikkeen id, tallennettu painike ja sen payload sekä painaja:
data: {"type": "action", "message_id": "...", "action_id": "open_gate", "action": {"id": "open_gate", "payload": {"door": "front"}, ...}, "member_guid": "member-guid", "member": {...}, "ts": 1790000000000}Tee varsinainen työ, kuten portin avaaminen, ja aseta sitten kortin lopullinen tila callback_url-osoitteen kautta. Virran ja callbackin toiminta on kuvattu sivulla live-päivitykset.
Aja komento painikkeesta
trigger:{guid}-painike laukaisee jonkin yhteisösi liipaisimista ikään kuin joku olisi kirjoittanut komennon, ja välittää painikkeen payload-datan. Liipaisin saa:
{
"actions": [
{
"type": "trigger:5f2c9a1e-trigger-guid",
"text": "Check status",
"color": "blue",
"payload": { "order_id": "12345" }
}
]
}{
"trigger_match": "/status",
"message": {
"content": "[Action Triggered]",
"member_guid": "member-guid",
"is_action_button": true,
"action_payload": { "order_id": "12345" }
},
"callback_url": "https://mss.gs/api/v1/trigger-callback/...",
"stream_url": "https://mss.gs/api/v1/instant/...?token=..."
}payload.Kentät
| Kenttä | Tyyppi | Mitä se tekee |
|---|---|---|
type | string | url:{url}, webhook_action tai trigger:{guid}. Pakollinen. |
text | string | Painikkeen teksti. Pakollinen; myös label käy. |
color | string | Painikkeen väri, katso alta. |
id | string | webhook_action-painikkeelle: mitä painiketta painettiin. Yksilöllinen viestin sisällä. |
payload | object | Omaa dataasi, joka palautetaan painettaessa. |
triggers | array | webhook_action-painikkeelle: suoritettavat vaiheet. |
disabled | boolean | Näyttää painikkeen harmaana, ja painallukset hylätään. |
Värit
green, blue ja purple piirtävät täytetyn ensisijaisen painikkeen. red, orange ja yellow piirtävät toissijaisen: käytä niitä valinnoissa kuten "Hylkää" ja "Peruuta" sekä muissa harkintaa vaativissa.
Virheet
Kun julkaiset painikkeellisen viestin, mssgs tarkistaa painikkeet ensin:
| Koodi | Merkitys |
|---|---|
INVALID_ACTIONS_FORMAT | actions ei ole lista olioita. |
INVALID_ACTION_MISSING_FIELDS | Painikkeelta puuttuu type tai text. |
DUPLICATE_ACTION_ID | Kahdella painikkeella on sama id. |
INVALID_TRIGGERS_FORMAT | triggers ei ole vaihelista. |
INVALID_TRIGGER_MISSING_ACTION | Vaiheelta puuttuu action. |
INVALID_TRIGGER_ACTION_NOT_ALLOWED | Jokin muu vaihe kuin yllä olevat neljä. |
Kun joku painaa
| Koodi | Merkitys |
|---|---|
MESSAGE_NOT_FOUND | Viesti poistettiin sillä välin. |
ACTION_NOT_FOUND | Viestissä ei ole painiketta tällä id:llä. |
ACTION_DISABLED | Painike on poistettu käytöstä. |
TRIGGER_NOT_FOUND, TRIGGER_NOT_ACTIVE | Liipaisin, johon painike osoittaa, on poistettu tai kytketty pois päältä. |
TRIGGER_NOT_ALLOWED | Jäsenellä ei ole roolia, joka saa käyttää kyseistä liipaisinta. |
Tuletko vanhoista ohjeista?
button-tyyppiset painikkeet ws:send-vaiheineen, local:update_message ja local:remove_message, previous:success-ehdot ja expire_in_seconds eivät enää toimi ulkopuolisille lähettäjille. Käytä webhook_action-painiketta yllä kuvatuilla vaiheilla: ne tavoittavat kaikki, eivät vain painajaa.