Cartes et boutons de bot

Ce que publie un webhook, une commande slash ou un compte de bot ne se limite pas forcément à du texte brut. Ce peut être une carte, un message structuré qui se lit d’un coup d’œil, avec des boutons en dessous.

Cartes

Une carte peut comporter :

• une bordure colorée : bleu (par défaut), vert, rouge, orange, jaune ou violet
• un titre (qui peut être un lien), un sous-titre et une description en markdown
• des champs : des lignes libellé et valeur que les membres copient d’un geste
• des images : une image seule ou une galerie
• un état de chargement : une roue avec ta propre ligne de texte, comme « Réflexion… », que tu remplaces par le résultat quand il est prêt

La réponse à une commande slash peut en montrer davantage : une pastille de statut comme Open, Merged ou Passing, un badge dans l’en-tête, les lignes ajoutées et supprimées, et un raisonnement replié derrière un interrupteur. Une carte publiée par un webhook n’affiche pas ces éléments, et son en-tête montre toujours le nom du webhook.

Pense aux pull requests, aux déploiements et aux tickets de support : lisibles d’un coup d’œil plutôt qu’un mur de texte.

Boutons

Les boutons se placent sous la carte. Leur type détermine ce que fait un appui :

• url:{url} ouvre un lien.
• webhook_action exécute les étapes enregistrées avec le bouton : mettre à jour la carte, la supprimer, ajouter une réaction ou publier une réponse. Elles s’exécutent sur le serveur mssgs et tout le salon voit le résultat : un bouton « Approuver » ou « Ouvrir le portail » ne demande donc aucun serveur de ton côté.
• trigger:{guid} lance l’un des déclencheurs de ta communauté avec les données du bouton, comme si quelqu’un avait tapé la commande. La réponse arrive sous forme de nouvelle carte.

Ce qui te revient

Une publication par webhook avec boutons renvoie une stream_url, et chaque requête de commande slash en contient une : un flux en direct des appuis, réactions et réponses sur ce message. Il reste ouvert 10 minutes (une heure sur demande, pour les publications par webhook) et ne garde rien pour plus tard : connecte-toi donc tout de suite. Pour modifier le message ensuite, utilise sa callback_url, valable 30 minutes. Un compte de bot est informé par le serveur MCP de ce qui arrive à ses cartes.

Tous les champs d’une carte, avec un constructeur de cartes en direct, se trouvent dans cartes de message. Les étapes, événements et erreurs des boutons sont dans boutons, le flux et l’URL de rappel dans mises à jour en direct.