Cartes et boutons de bot

Les messages de bot n'ont pas à se limiter au texte brut. Les bots mssgs publient des cartes d'embed - des messages structurés et soignés - et des boutons d'action qui les rendent interactifs.

Cartes d'embed

Une carte peut comporter :

• une barre latérale colorée (bleu, vert, rouge, jaune, violet, orange)
• un titre (éventuellement lié), un sous-titre et une description en markdown
• des champs - des paires clé/valeur pour les données structurées
• des images - une image principale ou une galerie
• une pastille de statut, un badge ou des statistiques de diff (+n / −n / fichiers) pour les notifications techniques
• un état de chargement - « l'IA réfléchit… » que vous remplacez sur place quand le résultat arrive

Pensez aux notifications de pull request GitHub, aux statuts de déploiement, aux tickets de support : lisibles d'un coup d'œil plutôt que des murs de texte.

Boutons d'action

Les boutons se placent sous la carte et font quelque chose quand on les presse :

• trigger: - lance un de vos déclencheurs de commande slash (enchaînez-les pour des flux en plusieurs étapes)
• url: - ouvre un lien
• webhook_action - appelle votre service et met à jour le message sur place (« Approuver », « Réessayer », « Résoudre »)

L'appui sur le bouton, les réactions et les réponses reviennent à votre service sous forme d'événements. Spécifications complètes avec aperçus de cartes rendus : la documentation des bots.