Générer des webhooks sortants
Les webhooks aident Microsoft Teams à s’intégrer à des applications externes. Dans Teams, les webhooks sortants agissent en tant que bot et recherchent des messages dans les canaux à l’aide de @mention. Les webhooks sortants permettent aux utilisateurs d’envoyer des messages aux services web sans effectuer l’ensemble du processus de création de bots via Microsoft Bot Framework. Les webhooks sortants publient des données de Teams sur n’importe quel service capable d’accepter la charge utile JSON.
Principales fonctionnalités des webhooks sortants
- Envoyer des notifications à n’importe quel service web externe.
- Répondez avec des messages texte enrichis, y compris des cartes et des images.
- Recevoir des messages dans des canaux publics et non dans l’étendue personnelle ou privée.
- Envoyer HTTP POST au service web et obtenir une réponse.
Remarque
Les webhooks sortants ne peuvent pas accéder à d’autres API, telles que la récupération de la liste ou de la liste des canaux d’une équipe.
Ce guide pas à pas vous aide à créer des webhooks sortants dans Teams. Vous verrez la sortie suivante :
Configuration requise
Veillez à installer les outils suivants et à configurer votre environnement de développement :
| Installer | Pour l’utilisation... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams vous permet de collaborer avec toutes les personnes avec lesquelles vous travaillez via des applications pour la conversation, les réunions et les appels au même endroit. | |
| Visual Studio 2022 | Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail de développement ASP.NET et web. Utilisez la dernière version. | |
| Tunnel de développement | Les fonctionnalités de l’application Teams (bots conversationnels, extensions de message et webhooks entrants) ont besoin de connexions entrantes. Un tunnel connecte votre système de développement à Teams. Le tunnel de développement est un outil puissant pour ouvrir en toute sécurité votre localhost sur Internet et contrôler qui a accès. Le tunnel de développement est disponible dans Visual Studio 2022 version 17.7.0 ou ultérieure. ou Vous pouvez également utiliser ngrok comme tunnel pour connecter votre système de développement à Teams. Elle n’est pas obligatoire pour les applications qui incluent uniquement des onglets. Ce package est installé dans le répertoire du projet (à l’aide de npm devDependencies). |
Remarque
Après avoir téléchargé ngrok, inscrivez-vous et installez authtoken.
Configurer l’environnement local
Ouvrez Microsoft-Teams-Samples.
Sélectionnez Code.
Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.
Sélectionnez Cloner.
Créer des webhooks sortants
Create un tunnel
Ouvrez Visual Studio.
Sélectionnez Create un nouveau projet.
Dans la zone de recherche, entrez ASP.NET. Dans les résultats de la recherche, sélectionnez ASP.NET Core’application web.
Sélectionnez Suivant.
Entrez Nom du projet , puis sélectionnez Suivant.
Sélectionnez Créer.
Une fenêtre de vue d’ensemble s’affiche.
Dans la liste déroulante débogage, sélectionnez Dev Tunnels (aucun tunnel actif)>Create un tunnel....
Une fenêtre contextuelle apparaît.
Mettez à jour les détails suivants dans la fenêtre contextuelle :
- Compte : entrez un compte Microsoft ou GitHub.
- Nom : entrez un nom pour votre tunnel.
- Type de tunnel : dans la liste déroulante, sélectionnez Temporaire.
- Accès : dans la liste déroulante, sélectionnez Public.
Sélectionnez OK.
Une fenêtre contextuelle s’affiche pour indiquer que le tunnel de développement a été créé avec succès.
Sélectionnez OK.
Vous trouverez le tunnel que vous avez créé dans la liste déroulante de débogage comme suit :
Sélectionnez F5 pour exécuter l’application en mode débogage.
Si une boîte de dialogue Avertissement de sécurité s’affiche, sélectionnez Oui.
Une fenêtre contextuelle apparaît.
Cliquez sur Continuer.
La page d’accueil du tunnel de développement s’ouvre dans une nouvelle fenêtre de navigateur et le tunnel de développement est maintenant actif.
Accédez à Visual Studio, puis sélectionnez Afficher la > sortie.
Dans le menu déroulant Console de sortie, sélectionnez Tunnels de développement.
La console de sortie affiche l’URL du tunnel de développement.
Accédez à Teams et sélectionnez Teams dans le volet gauche.
Accédez à l’équipe de votre choix, sélectionnez Plus d’options (•••), puis sélectionnez Gérer l’équipe.
Sélectionnez l’onglet Applications dans la barre de navigation.
Sélectionnez Create un webhook sortant dans le coin inférieur droit de la fenêtre.
Entrez les détails suivants :
Nom : titre du webhook dans l’onglet @mention .
URL de rappel : URL générée à partir de ngrok qui accepte les charges utiles JSON et reçoit les requêtes POST de Teams. Pour utiliser ou
api/Sampleapi/authenticatedSample, procédez comme suit :Pour l’exemple d’API, copiez et collez l’URL
dev tunnelou etngrokajoutez-la avec/api/sample.Pour api authenticatedSample, copiez et collez l’URL ou et
ngrokajoutez-ladev tunnelavec/authenticatedSample?id=contoso.
Description : chaîne détaillée qui apparaît dans le profil carte et le tableau de bord de l’application au niveau de l’équipe.
Image de profil (facultatif) : icône d’application pour votre webhook.
Sélectionnez Créer. Le webhook sortant est ajouté au canal de l’équipe actuelle.
Une
Hash-based Message Authentication Code (HMAC)boîte de dialogue s’affiche. Vous pouvez utiliser le jeton de sécurité dans AuthProvider.cs fichier pour authentifier les appels entre Teams et tous les services externes désignés.Remarque
Le webhook sortant est disponible pour les utilisateurs de l’équipe uniquement si l’URL est valide et si les jetons d’authentification du serveur et du client sont égaux. Par exemple, une poignée de main HMAC.
Générer et exécuter le service
Ouvrez Visual Studio.
Accédez à Fichier>Ouvrir>le projet/la solution....
Dans le dossier csharp , sélectionnez WebhookSampleBot.sln fichier.
Accédez au fichier AuthProvider.cs . Mettez à jour
contosoetM365x70471008ajoutez HMAC.
Appuyez sur F5 pour exécuter le projet.
Sélectionnez Oui si la boîte de dialogue suivante s’affiche :
Une page web affiche des informations sur l’hôte local.
Interagir avec l’application dans Teams
Accédez à Teams et sélectionnez Teams dans le volet gauche.
Accédez à Général>Nouvelle conversation.
Pour appeler un webhook sortant dans le canal, @mention le nom du webhook sortant et sélectionnez l’icône Envoyer.
Remarque
Vous pouvez envoyer une carte adaptative, une carte de bannière et des SMS en tant que pièce jointe avec le webhook sortant.
La conversation de réunion affiche un nouveau message.
Relever le défi
Tu as trouvé quelque chose comme ça ?
Félicitations !
Vous avez terminé le tutoriel pour bien démarrer avec une application webhook sortante !
Vous avez un défi avec cette section ? Si c'est le cas, faites-nous part de vos commentaires pour que nous puissions l'améliorer.
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