Düğme ekle

Hızlı başlangıç

1. 1

   Bir actions listesi ekle

   Düğmeler, kartın yanında actions alanına girer: bir webhook gönderisinde, bir komut yanıtında ya da bir güncellemede.

   jsonKopyala

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

   v2.1 canlı ortama alınsın mı?

   İsteyen: maya.

   Değişiklikleri gör

   14:20
2. 2

   Basınca ne olacağını seç

   Bir bağlantı, kartta bir değişiklik ya da servisine bir çağrı. Üç türü aşağıda bulabilirsin.

Üç düğme türü

Basınca ne olacağına type karar verir.

Dokununca kartı değiştir

Bir webhook_action düğmesi triggers içinde bir adım listesi taşır. Basıldığında bu adımlar mssgs sunucusunda sırayla çalışır ve kanaldaki herkes sonucu görür.

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

Basışları dinle

Düğmeli bir mesaj webhook’tan bir stream_url ile döner. Onu açık tut; her basış action türünde bir olay olarak gelir: düğmenin id’si, saklanan düğme ve onun payload verisi, bir de basan kişi:

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

Asıl işi yap, örneğin kapıyı aç, sonra kartın son halini callback_url üzerinden ayarla. Akışın ve callback’in nasıl çalıştığı canlı güncellemeler sayfasında.

Düğmeyle komut çalıştır

Bir trigger:{guid} düğmesi, sanki biri komutu yazmış gibi topluluğunun tetikleyicilerinden birini çalıştırır ve düğmenin payload verisini iletir. Tetikleyiciye şu gelir:

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

Alanlar

Renkler

green, blue ve purple dolu, birincil bir düğme çizer. red, orange ve yellow ikincil bir düğme çizer: bunları “Reddet”, “İptal” ve dikkat isteyen diğer seçenekler için kullan.

Hatalar

Düğmeli bir mesaj gönderdiğinde mssgs önce düğmeleri kontrol eder:

Biri bastığında

Eski belgelerden mi geliyorsun?