Construire webhooks et connecteurs
Importante
Les connecteurs Microsoft 365 (précédemment appelés connecteurs Office 365) sont presque obsolètes, et la création de nouveaux connecteurs Microsoft 365 sera bientôt bloquée. Pour plus d’informations sur la planification et la façon dont l’application Flux de travail offre une expérience plus flexible et sécurisée, consultez Retrait des connecteurs Microsoft 365 dans Microsoft Teams.
Comment pouvez-vous créer un webhook dans Teams ?
Pour publier automatiquement dans une conversation ou un canal lors de la réception d’une demande de webhook, utilisez les modèles de flux de travail prédéfinis ou créez un flux de travail à partir de zéro à l’aide du déclencheur Lors de la réception d’une demande de webhook Teams . Pour plus d’informations, consultez Publier un flux de travail lorsqu’une demande de webhook est reçue dans Microsoft Teams.
Pour plus d’informations sur le déclencheur Lors de la réception d’une demande de webhook Teams , consultez Microsoft Teams - Webhook.
Si vous avez déjà créé des connecteurs Office 365 :
Créer un connecteur Power Automate : Power Automate améliore les applications workflows largement utilisées dans Teams. Il s’agit de l’approche évolutive et sécurisée pour transmettre des données par programmation dans et hors de Teams. Si vous adoptez cette méthode, vous pouvez créer des modèles de flux de travail pour la publication d’alertes de votre produit sur les canaux Teams. Cette approche simplifie l’adoption par les utilisateurs de la nouvelle méthode. Pour plus d’informations, consultez Power Automate pour les développeurs d’entreprise, les éditeurs de logiciels indépendants et les partenaires.
Mettre à jour votre application Teams : vous pouvez améliorer votre application Teams actuelle. Par exemple, vous pouvez autoriser les utilisateurs à configurer des messages proactifs en fonction des événements déclencheurs au sein de votre système. Pour plus d’informations, consultez comment les bots peuvent publier sur des canaux via des messages proactifs.
Problèmes connus
- L’application workflows ne peut pas publier dans des canaux privés en tant que bot de flux. Toutefois, il peut publier au nom d’un utilisateur.
- Les workflows prennent uniquement en charge les cartes adaptatives. Il ne prend pas en charge l’ancien format de carte de message utilisé par Office 365 Connectors. Les flux de travail ne prennent pas en charge l’utilisation du format carte message. Pour plus d’informations, consultez Comment convertir le format de message carte connecteur en carte adaptative.
- Les workflows n’offrent pas de connecteurs tiers tels que DataDog et Jenkins.
- Les workflows peuvent uniquement être créés dans votre environnement par défaut.
Limites
Les flux de travail sont liés uniquement à des utilisateurs spécifiques (appelés propriétaires du flux de travail) et non à une équipe ou un canal Teams. Les flux de travail peuvent devenir orphelins en l’absence d’un propriétaire si aucun copropriétaire n’est affecté. Pour maintenir la continuité du processus métier automatisé par le flux, les administrateurs peuvent ajouter un ou plusieurs copropriétaires et leur accorder un contrôle total sur le flux de travail. Ils peuvent également ajouter l’authentification pour les connexions, le cas échéant, et activer le flux s’il a été désactivé. Pour plus d’informations, consultez Gérer les flux orphelins.
Les webhooks et les connecteurs permettent de connecter les services web aux canaux et aux équipes Microsoft Teams. Les webhooks sont un rappel HTTP défini par l’utilisateur qui avertit les utilisateurs de toute action qui a eu lieu dans le canal Teams. Il s’agit d’un moyen pour une application d’obtenir des données en temps réel. Les connecteurs permettent aux utilisateurs de s’abonner pour recevoir les notifications et les messages de vos services web. Ils exposent un point de terminaison HTTPS pour que votre service publie des messages sous forme de cartes.
Importante
Les webhooks et les connecteurs sont disponibles uniquement dans l’environnement Cloud de la communauté du secteur public (GCC), mais ne le sont pas dans les environnements GCC-High et doD (Department of Defense).
Seuls les types de connecteurs webhook entrants sont disponibles dans GCC-High environnement et les administrateurs doivent charger manuellement pour afficher l’application dans la page des connecteurs.
Vous pouvez choisir de créer une application Teams de bot de notification autre que les webhooks entrants. Ils fonctionnent de la même façon, mais le bot de notification a plus de fonctionnalités. Pour plus d’informations, consultez Générer un bot de notification avec JavaScript ou Exemple de notification de webhook entrant. Pour commencer, téléchargez et explorez teams Toolkit. Pour plus d’informations, consultez Documents du Kit de ressources Teams.
Webhooks sortants
Les webhooks permettent à Teams de s’intégrer à des applications externes. Avec les webhooks sortants, vous pouvez envoyer des sms d’un canal à un service web. Après avoir configuré les webhooks sortants, les utilisateurs peuvent @mention envoyer un message à un service web. Le service répond dans les 10 secondes au message par un texte ou un carte. Pour plus d’informations, consultez Créer des webhooks sortants.
Remarque
Les webhooks sortants sont configurés par équipe et ne peuvent pas être inclus dans le cadre d’une application Teams normale.
Connecteurs
Les connecteurs permettent aux utilisateurs de s’abonner pour recevoir des notifications et des messages de la part des services web. Ils exposent le point de terminaison HTTPS pour que le service publie des messages sur les canaux Teams, généralement sous forme de cartes.
Remarque
Les connecteurs ne peuvent pas mettre à jour les messages ou envoyer des messages en tant que réponses à des messages existants.
Webhooks entrants
Les webhooks entrants vous permettent de publier des messages à partir d’applications Teams. Si les webhooks entrants sont activés pour une équipe dans n’importe quel canal, ils exposent le point de terminaison HTTPS, qui accepte le format JSON correctement mis en forme et insère les messages dans ce canal. Par exemple, vous pouvez créer un webhook entrant dans votre canal DevOps, configurer votre build et déployer et surveiller simultanément les services pour envoyer des alertes. Pour plus d’informations, consultez Créer des webhooks entrants.
Bot de notification ou webhook entrant
Avant de commencer à apprendre à créer des webhooks entrants, vous pouvez également savoir que vous pouvez créer un bot de notification à l’aide de Teams Toolkit ou envoyer des notifications de flux d’activité à l’aide de Microsoft API Graph. Les bots de notification et les notifications de flux d’activité peuvent permettre une expérience plus personnalisable pour répondre à différents scénarios métier. Pour plus d’informations, consultez Planifier l’envoi de notifications d’application.
| Notification API | Bot de notification | Webhook entrant | |
|---|---|---|---|
| De quoi s’agit-il ? | UNE API web RESTful | Une application Teams | Une fonctionnalité Teams |
| Installation requise | Oui | Oui | Non |
| Scénarios appropriés | • Informer les utilisateurs des informations urgentes ou critiques. • Afficher du contenu enrichi qui nécessite une action de l’utilisateur dans le volet main de Teams. • Recevoir une notification du système d’exploitation avec un son. • Texte d’aperçu localisé dans Activité. |
• Recevoir régulièrement des notifications et des messages, par exemple recevoir une notification quotidienne des tâches de l’équipe. • Recevoir des notifications et des messages basés sur des événements réels. Par exemple, une fois que vos collègues ont téléchargé des fichiers, vous recevez des notifications. |
Communiquez avec des applications externes et recevez des notifications et des messages d’autres applications. |
| Configuration de l’étendue | • Un seul utilisateur • Une liste d’utilisateurs • Utilisateurs dans une conversation • Utilisateurs d’une équipe |
• Canal Teams • Conversation de groupe • Conversation personnelle |
Canal Teams |
| Processus de message | Une application Teams effectue un appel d’API REST pour déclencher une notification dans Activité dans Teams. L’appel d’API passe le lien profond pour charger le contenu dans le volet main. | Un bot de notification fonctionne comme une application Teams. Vous pouvez définir votre logique métier pour traiter les données et afficher les données dans un format personnalisé. | Le webhook étant une fonctionnalité Teams plutôt qu’une application Teams, il reçoit et affiche uniquement les données sans traitement. |
| Récupérer le contexte Teams | L’application peut utiliser les API Graph pour utiliser des données Microsoft 365. | Le bot de notification peut récupérer le contexte Teams, tel que les informations et les messages du canal ou de l’utilisateur. | Non |
| Envoyer une carte adaptative | Non | Oui | Oui |
| Envoyer un message de bienvenue | Oui | Oui | Non |
| Déclencheur pris en charge | Tous les déclencheurs sont pris en charge. | Tous les déclencheurs sont pris en charge. Si vous utilisez teams Toolkit, vous pouvez rapidement obtenir un projet de modèle avec les déclencheurs suivants : • Déclencheur de temps hébergé sur Azure Functions. • Déclencheur HTTP Express hébergé sur Azure App Service. • Déclencheur HTTP hébergé sur Azure Functions. |
Tous les déclencheurs sont pris en charge. |
| Outils de génération | Démarrage rapide - Microsoft Graph | • Vue d’ensemble du kit de ressources Teams pour Visual Studio Code • Vue d’ensemble du kit de ressources Teams pour Visual Studio • Interface CLI du Kit de ressources Teams • Kit de développement logiciel (SDK) TeamsFx |
Aucun outil n’est requis. |
| Ressource cloud requise | application Microsoft Entra | Azure Bot Framework | Aucune ressource n’est requise. |
| Didacticiel | • Envoyer des notifications de flux d’activité aux utilisateurs dans Microsoft Teams • Envoyer une notification de flux d’activité |
Générer un bot de notification avec JavaScript | Exemple de notification de webhook entrant |
Connecteurs pour Groupes Microsoft 365
Les connecteurs pour Groupes Microsoft 365 vous permettent de créer une page de configuration personnalisée pour votre webhook entrant et de les empaqueter dans le cadre d’une application Teams. Vous envoyez des messages principalement à l’aide de cartes de connecteur pour Groupes Microsoft 365 et vous pouvez y ajouter un ensemble limité d’actions carte. Par exemple, un connecteur météo qui permet aux utilisateurs de sélectionner un emplacement et à n’importe quelle heure de la journée, de recevoir des mises à jour sur la météo de demain. Ils sont configurés au niveau du canal, mais sont installés au niveau de l’équipe. Pour plus d’informations, consultez Créer des connecteurs pour Groupes Microsoft 365.
Remarque
Vous pouvez publier le connecteur pour Groupes Microsoft 365'application Teams sur notre AppStore.
Créer et envoyer des messages
Les messages actionnables permettent aux utilisateurs d’agir sans quitter leur client de messagerie, ce qui augmente leur engagement. Avec Microsoft 365 et les webhooks entrants, vous pouvez envoyer des messages en publiant une charge utile JSON dans l’URL du webhook. Pour plus d’informations, consultez Créer et envoyer des messages.