Créer des webhooks entrants

Un webhook entrant permet aux applications externes de partager du contenu dans les canaux Microsoft Teams. Les webhooks sont utilisés comme outils pour suivre et notifier. Les webhooks fournissent une URL unique pour envoyer 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és à un seul article. Vous pouvez utiliser des cartes dans les fonctionnalités suivantes :

  • Bots
  • Extensions de messages
  • Connecteurs

Importante

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.

Remarque

Regardez la vidéo suivante pour découvrir comment créer des webhooks entrants :

Principales fonctionnalités des webhooks entrants

Le tableau suivant fournit les fonctionnalités et la description d’un webhook entrant :

Fonctionnalités Description
Les cartes adaptatives utilisant un webhook entrant Les cartes adaptatives peuvent être envoyées via des webhooks entrants. Pour plus d’informations, consultez 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 les groupes Microsoft 365, 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, consultez Informations de référence sur les cartes de message actionnables héritées et Terrain de jeu de carte de message.
Prise en charge indépendante de la messagerie HTTPS Les cartes fournissent des informations de manière claire et 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 prennent en charge le markdown de base. N’utilisez pas les marques HTML dans vos cartes. Le code HTML est ignoré et traité comme texte brut.
Configuration dé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.

Remarque

  • Les bots Teams, les extensions de message, le webhook entrant et le Bot Framework prennent en charge les Cartes adaptatives. La carte adaptative est une infrastructure de plateforme multi-cartes ouverte qui est utilisée sur toutes les plateformes telles que Windows, Android, iOS, etc. Actuellement, les connecteurs Teams ne prennent pas en charge les cartes adaptatives. Toutefois, il est possible de créer un flux qui publie des cartes adaptatives sur un canal Teams.
  • Pour plus d’informations sur les cartes et les webhooks, consultez Cartes adaptatives et Webhooks entrants.

Créer des webhooks entrants

Pour ajouter un webhook entrant à un canal Teams, procédez comme suit :

  1. Ouvrez le canal dans lequel vous souhaitez ajouter le webhook et sélectionnez ••• dans le coin supérieur droit.

  2. Sélectionnez Connecteurs dans le menu déroulant.

    Cette capture d’écran montre comment sélectionner le connecteur.

  3. Recherchez leWebhook entrant sélectionnez Ajouter.

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

    Cette capture d’écran montre comment configurer et charger une image pour vos webhooks.

  5. Copiez et enregistrez l’URL de webhook unique présente dans la boîte de dialogue. L’URL est mappée au canal et vous pouvez l’utiliser pour envoyer des informations à Teams.

  6. Sélectionnez Terminé.

    Cette capture d’écran montre l’URL unique du webhook.

Le webhook est désormais disponible dans le canal Teams.

Vous pouvez créer et envoyer des messages actionnables via le webhook entrant ou le connecteur pour Groupes Microsoft 365. Pour plus d’informations, consultez Créer et envoyer des messages.

Remarque

Dans Teams, sélectionnez Paramètres>Autorisations des membres>Autoriser les membres à créer, mettre à jour et supprimer des connecteurs, afin que tout membre d’équipe puisse ajouter, modifier ou supprimer un connecteur.

Exemple

Exemple de référence de code

url = {{Webhook_URL}};
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var content = new StringContent({{formatted_Card_Payload}}(Adaptive_Card_Json), System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync({{WebhookUrl}}, content);