Adj hozzá gombokat

Gyors kezdés

1. 1

   Adj hozzá egy actions listát

   A gombok az actions mezőbe kerülnek, a kártya mellé: egy webhookos üzenetben, egy parancsra adott válaszban vagy egy frissítésben.

   jsonMásolás

   {
     "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" }
     ]
   }

   #deploys

   

   Message from Deploybot

   Mehet a v2.1 élesbe?

   Kérte: maya.

   Változások megtekintése

   14:20
2. 2

   Válaszd ki, mit tegyen egy gombnyomás

   Megnyithat egy linket, módosíthatja a kártyát, vagy meghívhatja a szolgáltatásodat. A három típust lent találod.

Háromféle gomb

A type dönti el, mit tesz egy gombnyomás.

A kártya módosítása egy koppintással

Egy webhook_action gomb lépések listáját hordozza a triggers mezőben. Gombnyomáskor ezek sorban lefutnak az mssgs szerverén, és az eredményt a csatornában mindenki látja.

{
  "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:" }
      ]
    }
  ]
}

Gombnyomások fogadása

A gombos üzenetre a webhook egy stream_url címmel válaszol. Tartsd nyitva, és minden gombnyomás action típusú eseményként érkezik, a gomb azonosítójával, a tárolt gombbal és annak payload értékével, valamint azzal, hogy ki nyomta meg:

data: {"type": "action", "message_id": "...", "action_id": "open_gate", "action": {"id": "open_gate", "payload": {"door": "front"}, ...}, "member_guid": "member-guid", "member": {...}, "ts": 1790000000000}

Végezd el a tényleges munkát, például nyisd ki a kaput, majd állítsd be a kártya végső állapotát a callback_url címen keresztül. A stream és a callback működését az élő frissítések oldal írja le.

Parancs futtatása gombbal

Egy trigger:{guid} gomb elindítja a közösséged valamelyik triggerét, mintha valaki begépelte volna a parancsot, és átadja a gomb payload értékét. A trigger ezt kapja:

{
  "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=..."
}

Mezők

Színek

A green, a blue és a purple teli, elsődleges gombot rajzol. A red, az orange és a yellow másodlagosat: ezeket használd az „Elutasítás”, a „Mégse” és más óvatos választások gombjaihoz.

Hibák

Amikor gombos üzenetet küldesz, az mssgs először ellenőrzi a gombokat:

Amikor valaki megnyomja

A régi dokumentációból jössz?