Connecter Slack : guide pas à pas
Publie le résumé de l’exécution dans un canal et, avec NEXUS_SLACK_NOTIFY=true, un message par test en échec, instable, de chaos ou de régression visuelle. Un message signalant un échec contient un lien vers le ticket Jira associé, s’il existe. Ce guide vous accompagne de zéro jusqu’à une connexion vérifiée et répertorie les erreurs possibles, leurs causes et leurs solutions.
Dernière mise à jour :
Gardez vos identifiants confidentiels. Ne collez jamais de jeton, de clé, de mot de passe ou d’URL de webhook dans une conversation. Saisissez-les uniquement dans Studio → Paramètres → Intégrations, où ils sont enregistrés dans le fichier .env de votre espace de travail et affichés sous forme de points. Cela vaut aussi pour un assistant IA : il peut vous accompagner dans ce guide, mais il n’a jamais besoin de votre jeton.
Prérequis
- Un espace de travail Slack dans lequel vous pouvez ajouter une application.
- Une URL de webhook entrant pour le canal qui doit recevoir les messages.
Obtenir les identifiants
- Dans Slack, créez une application avec un webhook entrant (https://api.slack.com/messaging/webhooks) et choisissez le canal.
- Copiez l’URL du webhook. Elle commence par https://hooks.slack.com/services/. L’URL constitue elle-même le secret.
- Gardez-le dans votre presse-papiers. Ne le collez nulle part ailleurs que dans le Studio (étape suivante).
Configurer la connexion dans le Studio
- Dans le Studio, ouvrez Paramètres → Intégrations → Slack.
- Collez l’URL du webhook et appuyez sur Enregistrer & envoyer un test. Un message de test est envoyé au canal.
- Activez
SLACK_ENABLED. Pour recevoir un message par test en échec, activez aussiNEXUS_SLACK_NOTIFY.
Vérifier le fonctionnement
- Envoyer un message de test répond "Envoyé." et le message apparaît dans le canal.
- Exécutez n’importe quel test. Le résumé de l’exécution arrive dans le canal.
Erreurs courantes
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| "Aucun webhook" | SLACK_WEBHOOK_URL est vide. | Collez l’URL du webhook dans Paramètres → Intégrations et enregistrez. |
"SLACK_WEBHOOK_URL n’est pas un webhook entrant Slack" | La valeur ne commence pas par https://hooks.slack.com/services/. | Copiez à nouveau l’URL du webhook depuis la page des webhooks entrants de votre application Slack. |
| HTTP 404 "no_service" ou HTTP 403 "invalid_token" | Le webhook a été révoqué ou supprimé, ou l’application a été retirée de l’espace de travail. | Créez un nouveau webhook entrant et enregistrez la nouvelle URL. |
| HTTP 404 "channel_not_found" ou HTTP 410 "channel_is_archived" | Le canal dans lequel le webhook publie a été supprimé ou archivé. | Créez un nouveau webhook pour un canal actif. |
| "impossible de joindre Slack (ENOTFOUND)" ou "aucune réponse dans les 20 s" | Ce PC ne peut pas joindre Slack : un VPN ou un serveur mandataire bloque l’accès, ou le réseau est indisponible. | Vérifiez le réseau depuis le même PC et réessayez. |
| Le test fonctionne mais les échecs ne sont pas publiés | SLACK_ENABLED vaut false, ou seul le résumé de l’exécution est activé : les messages par test nécessitent NEXUS_SLACK_NOTIFY=true. | Activez les deux options. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
SLACK_ENABLED | Envoyer les alertes à Slack | true ou false | Activez cette option après réception du message de test. |
SLACK_WEBHOOK_URL | Canal Slack pour les alertes (secret, enregistré uniquement sur cet ordinateur) | https://hooks.slack.com/services/… (rien d’autre n’est accepté) | Envoyer un message de test publie dans le canal. |
NEXUS_SLACK_NOTIFY | Alerte Slack à chaque échec | true ou false | Vous recevez un message par test en échec, et pas seulement le résumé de l’exécution. |
En savoir plus : toutes les intégrations, le guide des paramètres, le dépannage. Autres guides : Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
Toujours bloqué ? Écrivez à [email protected] en indiquant la ligne d’erreur exacte affichée par le Studio. N’incluez aucun jeton.