Connecteurs Teams et webhooks : état de la mise hors service et remplacement par des workflows
Par Mirko Peters ·
Les connecteurs Office 365 et les webhooks entrants basés sur des connecteurs dans Teams ont été mis hors service en mai 2026. Ce guide décrit ce qui a cessé de fonctionner, ce qui les remplace, comment effectuer la migration et les points sur lesquels les workflows diffèrent encore.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Les connecteurs Teams, y compris le connecteur Incoming Webhook, n'existent plus. Microsoft Learn indique que les connecteurs Office 365 dans Teams ont été mis hors service en mai 2026 et que la façon de recevoir des requêtes webhook et de publier dans Teams est désormais l'application Workflows. Un workflow construit sur le déclencheur When a Teams webhook request is received remplace l'ancienne URL de connecteur.
Points clés
- Selon Microsoft Learn, les connecteurs Office 365 dans Teams, y compris les webhooks entrants basés sur des connecteurs, ont été mis hors service en mai 2026. La fenêtre finale de déploiement indiquée dans le blog des développeurs allait du 18 au 22 mai 2026.
- Le remplacement est l’application Workflows dans Teams, qui repose sur Power Automate. Utilisez le déclencheur « When a Teams webhook request is received » ou un modèle prêt à l’emploi.
- Un workflow possède sa propre URL de webhook : chaque système émetteur doit donc être basculé vers cette nouvelle URL, car l'ancienne URL de connecteur ne fonctionne plus.
- Les charges utiles MessageCard s'affichent, mais leurs boutons HttpPost ne fonctionnent pas. Utilisez les Adaptive Cards pour les contenus interactifs.
- Les workflows appartiennent à un propriétaire, et non à un canal. Ajoutez des copropriétaires afin que le workflow ne soit pas orphelin lorsque son propriétaire quitte l'organisation.
Cet article explique ce qui a été mis hors service, ce qui le remplace, comment effectuer la transition et quels écarts peuvent encore poser problème.
Ce qui a été mis hors service et quand
La mise hors service s'est étalée sur près de deux ans, et la date a été repoussée à plusieurs reprises. Le blog des développeurs Microsoft 365 retrace la chronologie :
- Juillet 2024 : premier plan prévoyant de bloquer les nouveaux connecteurs à partir du 15 août 2024 et d'arrêter tous les connecteurs le 1er octobre 2024.
- Juillet 2024 : mise hors service repoussée à décembre 2025.
- Octobre 2025 : échéance de migration reportée au 31 mars 2026.
- Février 2026 : ajout de la prise en charge de Message Card dans Workflows, et possibilité pour le bot Workflows de publier dans les canaux partagés. L'échéance est repoussée au 30 avril 2026.
- 14 avril 2026 (mise à jour finale) : le déploiement commence le 18 mai 2026 et se termine le 22 mai 2026. Après cette date, les connecteurs ne fonctionnent plus.
Les éléments concernés sont les connecteurs Office 365 dans Teams, y compris les connecteurs basés sur des webhooks comme Incoming Webhook, ainsi que les connecteurs tiers qui publient vers une URL. Le blog précise que le changement d'URL de webhook concerne les connecteurs basés sur des webhooks, et non les connecteurs à interrogation périodique comme RSS.
Si un élément publie encore via un ancien connecteur, considérez-le comme défaillant ou sur le point de l'être, et planifiez dès maintenant sa migration.
Ce qui remplace les connecteurs
Microsoft propose trois voies sur Learn :
- Application Workflows (Power Automate) pour les webhooks entrants. Utilisez un modèle prédéfini ou le déclencheur When a Teams webhook request is received.
- Le connecteur Power Automate destiné aux ISV et aux équipes produit. Learn le présente comme la méthode évolutive et sécurisée pour transférer des données vers Teams et depuis Teams de manière programmatique.
- Une application Teams avec messages proactifs, qui permet aux utilisateurs de configurer des messages déclenchés par des événements de votre système.
Pour la plupart des administrateurs et des scripteurs, le chemin 1 est le remplacement direct.
Comment migrer un webhook vers Workflows
La page d’assistance Microsoft consacrée aux webhooks entrants n’a pas pu être consultée au moment de la rédaction de cet article. Les étapes ci-dessous s’appuient donc sur le blog développeurs et sur la référence du connecteur dans Learn.
- Dressez la liste de tous les connecteurs utilisés. Vérifiez les canaux qui ont utilisé Gérer le canal > Connecteurs, ainsi que les systèmes qui envoient des alertes, comme les outils de supervision, de build ou de gestion des tickets.
- Dans Teams, ouvrez l’application Workflows. Selon le blog développeurs, vous pouvez aussi l’ouvrir depuis une conversation ou un canal via Autres options (...).
- Choisissez un modèle de webhook prédéfini, ou partez de zéro avec le déclencheur Lorsqu’une requête webhook Teams est reçue.
- Sélectionnez l’équipe et le canal, puis enregistrez et copiez l’URL du déclencheur depuis le workflow dans Power Automate.
- Remplacez l’ancienne URL du connecteur dans le système émetteur par la nouvelle.
- Nommez, décrivez et testez le workflow, puis ajoutez des copropriétaires.
- Envoyez une requête POST de test et vérifiez que le message apparaît.
Le déclencheur n’accepte que les requêtes POST. La référence du connecteur dans Learn indique que les requêtes GET ne sont pas prises en charge.
Format de charge utile et cartes
Le corps du déclencheur peut contenir un tableau de cartes adaptatives. La référence montre un message avec un tableau attachments dont contentType vaut application/vnd.microsoft.card.adaptive. Un corps unique de Message Card est également accepté.
Gardez ces points à l’esprit :
- Les cartes adaptatives constituent la méthode prise en charge pour créer du contenu interactif.
- Les charges utiles MessageCard s’affichent, mais les boutons qui utilisent HttpPost ne fonctionnent pas. Le blog développeurs recommande de passer aux cartes adaptatives si vous utilisez des éléments de carte interactifs.
Contrôle d’accès
Une amélioration réelle : le déclencheur dispose d’un paramètre d’authentification. Learn en répertorie trois options.
| Paramètre | Ce que l’expéditeur doit faire | |---|---| | Tout le monde | Ne pas envoyer d’en-tête de jeton d’authentification, sinon la requête échoue | | Tout utilisateur de mon locataire | Envoyer un jeton d’authentification | | Utilisateurs spécifiques de mon locataire | Envoyer un jeton d’authentification, et l’utilisateur doit figurer dans la liste autorisée |
Pour les options liées au locataire, Learn renvoie à son guide sur l’authentification OAuth pour les déclencheurs de requête HTTP. Si un outil ne peut envoyer qu’un simple POST vers une URL, il lui faut le paramètre Tout le monde. Dans ce cas, traitez l’URL comme un secret.
Différences avec l’ancien connecteur
Prévoyez ces points avant de basculer.
- Identité de l’émetteur. La mise à jour d’avril 2026 du blog développeurs indique que la personnalisation de l’icône et du nom du bot n’est pas disponible pour les publications par webhook. Les messages affichent l’identité par défaut du bot Workflows.
- Propriété. Learn précise que les workflows sont rattachés à leurs propriétaires, et non à une équipe ou à un canal. Si le propriétaire quitte l’organisation sans copropriétaire, le flux peut devenir orphelin. Ajoutez des copropriétaires disposant du contrôle total.
- Limites. La référence Learn indique environ 1 000 appels entrants simultanés pour le déclencheur, ainsi qu’une limite de 28 Ko pour l’action Publier une carte adaptative dans un chat ou un canal. Les charges utiles plus volumineuses renvoient l’erreur « Request Entity too large ».
- Canaux privés. Les sources ne concordent pas. Le blog développeurs indique que la sélection de canaux privés dans l’application Workflows devait être entièrement déployée d’ici le 20 avril 2026. Une page Learn indique que les webhooks Workflows prennent en charge les canaux privés, tandis qu’une autre page Learn qualifie cette prise en charge de « en cours de développement ». La référence du connecteur Microsoft Teams précise encore que la publication d’un message ou d’une carte dans un canal privé n’est actuellement pas prise en charge. Testez votre canal cible avant de vous y fier.
Erreurs courantes
- Migrer uniquement le canal en oubliant de modifier l’URL dans le système émetteur.
- Laisser une seule personne comme unique propriétaire du workflow.
- Envoyer un jeton à un déclencheur réglé sur Tout le monde.
- Conserver les boutons MessageCard en espérant que les rappels fonctionnent.
- Supposer que l’ancien nom et l’ancienne icône du bot sont conservés.
Articles connexes
Sources
- Retrait des connecteurs Office 365 dans Microsoft Teams (blog développeurs Microsoft 365)
- Créer des connecteurs Office 365 pour Teams (Microsoft Learn)
- Retrait des connecteurs Microsoft 365 et des connecteurs personnalisés dans Teams (Microsoft Learn)
- Référence du connecteur Microsoft Teams pour Power Automate (Microsoft Learn)
FAQ
Les connecteurs Teams fonctionnent-ils encore ?
Non. Microsoft Learn indique que les connecteurs Office 365 dans Teams, y compris les webhooks entrants basés sur des connecteurs, ont été mis hors service en mai 2026. Le blog des développeurs Microsoft 365 a fixé la fenêtre finale de déploiement du 18 au 22 mai 2026 et précise que les webhooks devaient être migrés avant son début.
Qu'est-ce qui remplace le connecteur Incoming Webhook dans Teams ?
L’application Workflows, qui s’appuie sur Power Automate. Selon Microsoft Learn, vous pouvez soit utiliser un modèle prédéfini qui publie dans un chat ou un canal lorsqu’une requête webhook est reçue, soit créer un flow à partir de zéro avec le déclencheur « When a Teams webhook request is received ».
Ai-je besoin d'une nouvelle URL pour mon outil de supervision ou mon script ?
Oui. Un workflow possède sa propre URL de déclenchement, et la documentation de référence des connecteurs décrit ce déclencheur comme démarré par une requête POST vers ce point de terminaison. Les pages que j'ai consultées n'indiquent pas où l'URL est affichée. Ouvrez donc le déclencheur du workflow dans Power Automate pour la copier, puis collez-la dans le système qui envoie la requête POST.
Le webhook de Workflows peut-il afficher des boutons qui rappellent mon système ?
Pas avec MessageCard. Le blog des développeurs indique que MessageCard affiche du contenu mais ne prend pas en charge les boutons d'action HttpPost. Pour les éléments interactifs, Microsoft recommande les Adaptive Cards, et Learn précise qu'il faut configurer le workflow pour traiter les réponses.
Qui peut envoyer des requêtes à un webhook de workflow ?
C'est vous qui décidez. La documentation de référence du connecteur Microsoft Teams sur Learn propose trois options : n'importe qui, tout utilisateur de votre locataire, ou des utilisateurs précis de votre locataire. Pour les options liées au locataire, les requêtes doivent comporter un jeton d'authentification. Pour l'option Anyone, vous ne devez pas en envoyer.