Bots et intégrations de notification

À quoi sert un bot dans une conversation ? #

Un bot est un correspondant automatique attaché à une conversation. Au lieu qu'une personne recopie une information à la main, l'application externe envoie elle-même le message dans la conversation, via le bot. C'est idéal pour les notifications automatiques : builds, alertes, rappels, événements d'un autre logiciel.

Comment créer un bot ? #

1. Ouvrez la conversation qui doit recevoir les notifications.
2. Ouvrez la section Bots & intégrations.
3. Cliquez sur Ajouter un bot.
4. Donnez-lui un nom (par exemple « Bot CI »), et éventuellement un nom affiché, une image et une description.
5. Validez : le bot est créé.

À la création, un jeton d'intégration vous est fourni : c'est la clé que votre application externe utilisera pour poster dans la conversation.

Qu'est-ce que le jeton d'intégration ? #

Le jeton d'intégration est un code secret qui autorise votre application externe à envoyer des messages via le bot. Copiez-le et collez-le dans la configuration de votre application. Un exemple prêt à l'emploi est affiché pour vous aider à brancher l'application.

💡 Traitez le jeton comme un mot de passe : ne le partagez pas publiquement. Toute personne qui l'a peut poster dans la conversation au nom du bot.

Comment renouveler le jeton d'un bot ? #

Dans la section Bots & intégrations, choisissez Renouveler le jeton sur le bot concerné. Un nouveau jeton est généré et l'ancien cesse immédiatement de fonctionner. Pensez à mettre à jour la configuration de votre application externe avec le nouveau jeton, sinon elle ne pourra plus poster.

Comment revoir ou copier le jeton plus tard ? #

Sur le bot, choisissez Voir pour réafficher le jeton d'intégration, puis Copier le jeton. Si le jeton n'est plus disponible à l'affichage, utilisez Renouveler le jeton pour en obtenir un nouveau.

Comment supprimer un bot (révoquer) ? #

Sur le bot, choisissez Révoquer. Le bot est supprimé et son jeton d'intégration devient invalide : l'application externe ne peut plus poster. Cette action est irréversible — pour rebrancher l'intégration ensuite, il faudra recréer un bot et reconfigurer l'application avec le nouveau jeton.

Un bot peut-il poster dans une conversation chiffrée de bout en bout ? #

Le chiffrement de bout en bout d'une conversation peut empêcher certains bots et intégrations de fonctionner, car seuls les participants disposant des clés peuvent lire et écrire. Si vous avez besoin d'un bot dans une conversation, vérifiez qu'elle est compatible avant d'activer le chiffrement.