Créer un webhook entrant

Le webhook entrant permet à toutes les applications externes de partager du contenu Teams canaux. Ces webhooks sont utilisés comme outils de suivi et de notification. Ils fournissent une URL unique à laquelle vous envoyez une charge utile JSON avec un message au format de carte. Les cartes sont des conteneurs d’interface utilisateur qui incluent du contenu et des actions liées à un seul sujet. Teams utiliser des cartes dans les fonctionnalités suivantes :

  • Bots
  • Extensions de messagerie
  • Connecteurs

Principales fonctionnalités du webhook entrant

Le tableau suivant fournit les fonctionnalités et la description du webhook entrant :

Fonctionnalités Description
Cartes adaptatives utilisant un webhook entrant Les cartes adaptatives peuvent être envoyées via des webhooks entrants. Pour plus d’informations, voir Envoyer des cartes adaptatives à l’aide de webhooks entrants.
Prise en charge de la messagerie actionnable Les cartes de message actionnables sont prises en charge dans tous Office 365 groupes, y compris Teams. Si vous envoyez des messages par le biais de cartes, vous devez utiliser le format de carte de message actionnable. Pour plus d’informations, voir la référence de carte de message actionnable héritée et l’aire de jeu de carte de message.
Prise en charge indépendante de la messagerie HTTPS Les cartes fournissent des informations clairement et de manière cohérente. Tout outil ou infrastructure qui peut envoyer des demandes HTTPS POST peut envoyer des messages Teams via un webhook entrant.
Prise en charge de Markdown Tous les champs de texte dans les cartes de messagerie actionnables prendre en charge markdown de base. N’utilisez pas de balise HTML dans vos cartes. Le code HTML est ignoré et traité comme texte brut.
Configuration limitée Le webhook entrant est limitée et configurée au niveau du canal.
Définitions de ressources sécurisées Les messages sont formatés en tant que charges utiles JSON. Cette structure de messagerie déclarative empêche l’insertion de code malveillant.

Notes

  • Teams bots, extensions de messagerie, webhook entrant et Bot Framework prise en charge les cartes adaptatives. Les cartes adaptatives sont une infrastructure ouverte de plateforme de cartes croisées qui peut être utilisée sur toutes les plateformes telles que Windows, Android, iOS, etc. Actuellement, Teams connecteurs ne sont pas en charge les cartes adaptatives. Toutefois, il est possible de créer un flux qui publie des cartes adaptatives sur Teams canal.
  • Pour plus d’informations sur les cartes et les webhooks, voir Cartes adaptatives et Webhooks entrants.

Créer un webhook entrant

Pour ajouter un webhook entrant à un canal Teams web

  1. Go to the channel where you want to add the webhook and select ••• More options from the top navigation bar.

  2. Sélectionnez connecteurs dans le menu déroulant :

    Select Connector

  3. Recherchez le webhook entrant et sélectionnez Ajouter.

  4. Sélectionnez Configurer, fournissez un nom et téléchargez une image pour votre webhook si nécessaire :

    Bouton Configurer

  5. La fenêtre de boîte de dialogue présente une URL unique qui mase au canal. Copiez et enregistrez l’URL de webhook, pour envoyer des informations Microsoft Teams et sélectionnez Terminé:

    Unique URL

Le webhook est disponible dans le canal Teams webhook.

Notes

Dans Teams, sélectionnez Paramètres autorisations de membre autoriser les membres à créer, mettre à jour et supprimer des > > connecteurs, afin que n’importe quel membre d’équipe puisse ajouter, modifier ou supprimer un connecteur.

Supprimer le webhook entrant

Pour supprimer un webhook entrant d’un canal Teams web

  1. Go to the channel.

  2. Sélectionnez ••• options supplémentaires dans la barre de navigation supérieure.

  3. Sélectionnez connecteurs dans le menu déroulant.

  4. Sur la gauche, sous Gérer, sélectionnez Configuré.

  5. Sélectionnez < le 1> configuré pour voir la liste de vos connecteurs actuels :

    Webhook configuré

  6. Sélectionnez Gérer en côté du connecteur que vous souhaitez supprimer :

    Gérer le webhook

  7. Sélectionnez Supprimer:

    Supprimer un webhook

    La boîte de dialogue Supprimer la configuration s’affiche :

    Supprimer la configuration

  8. Complétez les champs et les case à cocher de la boîte de dialogue, puis sélectionnez Supprimer:

    Suppression finale

    Le webhook est supprimé du canal Teams webhook.

Voir aussi