Construire webhooks et connecteurs

  • Article

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. 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.
• 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 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 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. Pour plus d’informations, consultez Créer et envoyer des messages.

Voir aussi

Fonctionnalités d’application mappées aux fonctionnalités