Créer un bot

Publie dans un salon avec un webhook, donne à ta communauté ses propres commandes slash et ajoute des boutons sous les cartes.

Trois briques permettent à ton propre service de prendre la parole dans ta communauté. Elles fonctionnent ensemble : une même intégration peut publier une carte, répondre à une /commande, réagir à un bouton et mettre à jour son propre message.

Les briques de base

Webhooks : une URL qui publie dans un salon. Ton service lui envoie du JSON et le message apparaît sous le nom que tu as donné au webhook. Idéal pour les alertes : résultats de CI, supervision, tickets.
Déclencheurs : les commandes slash propres à ta communauté. Un membre tape /weather, mssgs envoie le message à ton service web, et sa réponse apparaît dans le salon sous forme de carte.
Boutons : placés sous une carte, ils ouvrent un lien, modifient la carte pour tout le monde ou lancent l’un de tes déclencheurs (voir Cartes et boutons de bot).

Publier ton premier message

Dans l’application de bureau, ouvre Gérer le serveur → Webhooks dans ta communauté et clique sur Ajouter un webhook.

Donne-lui un nom, choisis les Salons où il peut publier, copie le Secret du webhook et clique sur Créer le webhook.

Clique sur l’icône de lien à côté du webhook (Voir l’URL du webhook), choisis un Salon et copie l’URL.

Envoie du JSON en POST à cette URL, signé avec le secret. Le message apparaît aussitôt dans le salon.

BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"

Garde l’URL et le secret pour toi. Ensemble, ils permettent à n’importe qui de publier dans ce salon : ne les mets ni dans un dépôt public ni dans du code exécuté dans le navigateur. Une requête sans signature valide est refusée.

Tu publies depuis GitHub ? Aucun code n’est nécessaire : fais pointer un webhook GitHub vers l’URL et colle le secret dans son champ Secret. Voir intégrations.

Ajouter une commande slash

Ouvre Gérer le serveur → Déclencheurs et clique sur Créer un déclencheur.

Renseigne le Mot à reconnaître, par exemple /weather, et le Point d’accès URL de ton service web. Sous Groupes d’utilisateurs autorisés, tu peux réserver la commande à certains rôles.

Quand un membre envoie un message qui commence par /weather, mssgs l’envoie en POST à ton URL. Réponds en moins de 5 secondes avec du JSON, et ta réponse apparaît dans le salon sous forme de carte.

Besoin de plus de temps ? Réponds tout de suite avec une carte de chargement, puis complète-la via la callback_url reçue dans la requête, valable 30 minutes. La carte affiche le nom de ta communauté, et son pied indique qui a utilisé quelle commande.

Un bot à part entière

Tu veux que le bot soit un vrai membre, avec un nom, un avatar et l’étiquette BOT ? Crée un compte de bot lié à ton propre compte, et gère-le depuis le tableau de bord des bots. Quand l’application de bureau est connectée en tant que bot, un assistant IA peut publier des cartes avec boutons via son serveur MCP.

Chaque champ, chaque réponse et chaque code d’erreur figure dans la documentation développeurs : webhooks, commandes slash, cartes de message, boutons et mises à jour en direct. Et si tu veux un comportement piloté par l’IA sans rien développer, la voie MCP te suffira peut-être.

Cet article t’a-t-il été utile ?

Tu n’as pas trouvé ce que tu cherchais ? On est là pour t’aider.

Pose ta question

Encore besoin d’aide ?

Notre équipe d’assistance répond généralement sous 24 heures.

Contacter le support