Construire webhooks et connecteurs
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).
Seul le type de connecteur Webhook entrant est disponible dans GCC-High environnement et les administrateurs de locataire 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.
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.
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.
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. Les bots de notification peuvent permettre une expérience plus personnalisable pour répondre à différents scénarios métier.
En savoir plus sur les différences entre un bot de notification et un webhook entrant afin de pouvoir choisir les solutions appropriées pour vos scénarios :
| Bot de notification | Webhook entrant | |
|---|---|---|
| De quoi s’agit-il ? | Une application Teams | Une fonctionnalité Teams |
| Installation requise | Oui | Non |
| Scénarios appropriés | • 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 | • Canal Teams • Conversation de groupe • Conversation personnelle |
Canal Teams |
| Processus de message | 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 | Le bot de notification peut récupérer le contexte Teams tel que les informations du canal ou de l’utilisateur, les messages, etc. | Non |
| Envoyer une carte adaptative | Oui | Oui |
| Envoyer un message de bienvenue | Oui | Non |
| Déclencheur 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. • Restifier le déclencheur HTTP 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 | • 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 | Azure Bot Framework | Aucune ressource n’est requise. |
| Didacticiel | 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.
Remarque
Vous pouvez distribuer 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.
Étape suivante
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour