Ajouter des boutons

Démarrage rapide

1. 1

   Ajoute une liste actions

   Les boutons vont dans actions, à côté de la carte, dans une publication par webhook, une réponse de commande ou une mise à jour.

   jsonCopier

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

   Déployer la v2.1 en production ?

   Demandé par maya.

   Voir les changements

   14:20
2. 2

   Choisis ce que fait un appui

   Un lien, une modification de la carte, ou un appel à ton service. Les trois types sont décrits plus bas.

Trois types de bouton

Le type décide de ce que fait un appui.

Modifier la carte d’un appui

Un bouton webhook_action porte une liste d’étapes dans triggers. À l’appui, elles s’exécutent sur le serveur mssgs, dans l’ordre, et tout le monde dans le salon voit le résultat.

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

Capter l’appui

Un message avec des boutons revient du webhook avec une stream_url. Garde-la ouverte et chaque appui arrive sous forme d’événement de type action, avec l’id du bouton, le bouton stocké et son payload, et la personne qui a appuyé :

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

Fais le vrai travail, comme ouvrir le portail, puis fixe l’état final de la carte via callback_url. Le fonctionnement du flux et du callback est expliqué sur mises à jour en direct.

Lancer une commande depuis un bouton

Un bouton trigger:{guid} lance l’un des déclencheurs de ta communauté, comme si quelqu’un avait tapé la commande, et lui transmet le payload du bouton. Le déclencheur reçoit :

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

Champs

Couleurs

green, blue et purple dessinent un bouton plein, principal. red, orange et yellow en dessinent un secondaire : utilise-les pour « Refuser », « Annuler » et les autres choix qui demandent de la prudence.

Erreurs

Quand tu publies un message avec des boutons, mssgs les vérifie d’abord :

Quand quelqu’un appuie

Tu viens de l’ancienne documentation ?