Connecter Microsoft Teams : guide pas à pas
Publie le résumé de l’exécution dans un canal Teams et, avec NEXUS_TEAMS_NOTIFY=true, un message par test en échec. Ce guide vous accompagne de zéro jusqu’à une connexion vérifiée et répertorie les erreurs possibles avec leur cause et leur solution.
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 canal Teams dans lequel vous pouvez ajouter un flux de travail.
- Une URL de webhook Workflows pour ce canal.
Obtenir les identifiants
- Dans Teams, ouvrez le menu ··· du canal → Flux de travail et ajoutez "Publier dans un canal à la réception d’une demande de webhook".
- Copiez l’URL du webhook fournie. Elle se termine par logic.azure.com (anciens connecteurs : webhook.office.com). 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 → Microsoft Teams.
- Collez l’URL du webhook et appuyez sur Enregistrer & envoyer un test. Un message de test est envoyé au canal.
- Activez
TEAMS_ENABLED. Pour recevoir un message par test en échec, activez aussiNEXUS_TEAMS_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" | TEAMS_WEBHOOK_URL est vide. | Collez l’URL du webhook dans Paramètres → Intégrations et enregistrez. |
"TEAMS_WEBHOOK_URL n’est pas un webhook Teams" | La valeur n’est pas une URL https sur logic.azure.com ou webhook.office.com. | Copiez à nouveau l’URL depuis le déclencheur "Publier dans un canal à la réception d’une demande de webhook" du flux de travail. |
| Une réponse HTTP 4xx ou 5xx de Teams | Le flux de travail a été désactivé ou supprimé, ou son propriétaire a quitté l’organisation ou perdu sa licence, si bien qu’il ne s’exécute plus. | Ouvrez le flux de travail dans Teams (Flux de travail → gérer), activez-le ou créez-en un nouveau, puis enregistrez la nouvelle URL. |
| "impossible de joindre Teams (ENOTFOUND)" ou "aucune réponse sous 20 s" | Ce PC ne peut pas joindre Microsoft : un VPN ou un proxy bloque l’accès, ou aucune connexion réseau n’est disponible. | Vérifiez le réseau depuis le même PC et réessayez. |
| Le test fonctionne mais les échecs ne sont pas publiés | TEAMS_ENABLED vaut false, ou seul le récapitulatif d’exécution est activé : les messages par test nécessitent NEXUS_TEAMS_NOTIFY=true. | Activez les deux options. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
TEAMS_ENABLED | Envoyer des alertes à Microsoft Teams | true ou false | Activez cette option après réception du message de test. |
TEAMS_WEBHOOK_URL | Canal Teams pour les alertes (secret, enregistré uniquement sur cet ordinateur) | Une URL https://…logic.azure.com ou …webhook.office.com | Envoyer un message de test publie dans le canal. |
NEXUS_TEAMS_NOTIFY | Alerte Teams à 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, Slack, Telegram, GitHub Issues.
Toujours bloqué ? Écrivez à [email protected] en indiquant la ligne d’erreur exacte affichée par le Studio. N’incluez aucun jeton.