Créer des webhooks entrants

Un webhook entrant permet aux applications externes de partager du contenu dans des 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 carte. Les cartes sont des conteneurs d’interface utilisateur qui incluent du contenu et des actions liées à un seul article. Vous pouvez utiliser des cartes dans les fonctionnalités suivantes :

• Bots
• Extensions de messages
• Connecteurs

Remarque

• La taille limite des messages est de 28 Ko. Lorsque la taille dépasse 28 Ko, vous recevez une erreur. Pour plus d’informations, consultez Limites et spécifications pour Microsoft Teams.
• Si plus de quatre demandes sont faites en une seconde, la connexion client est limitée jusqu’à ce que la fenêtre s’actualise pendant la durée du taux fixe. Une logique de nouvelle tentative avec interruption exponentielle peut atténuer la limitation du débit dans les cas où les demandes dépassent les limites en une seconde. Pour éviter d’atteindre les limites de débit, consultez réponses HTTP 429.

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 messages actionnables hérités carte et carte terrain de jeu de messages.
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	Un webhook entrant est limité et configuré 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 carte 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 un webhook entrant

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

Teams (nouvelle version)

1. Dans le nouveau client Teams, sélectionnez Teams et accédez au canal dans lequel vous souhaitez ajouter un webhook entrant.

2. Sélectionnez Plus d’options ••• à droite du nom du canal.

3. Sélectionnez Gérer le canal.

   

4. Sélectionnez Modifier.

   

5. Recherchez leWebhook entrant sélectionnez Ajouter.

   

   La boîte de dialogue Webhook entrant s’affiche.

6. Sélectionnez Ajouter.

   

   Remarque

   Si vous avez déjà ajouté un webhook entrant, l’option Configurer s’affiche. Sélectionnez Configurer pour créer un webhook entrant.

7. Fournissez un nom pour le webhook et chargez une image si nécessaire.

8. Sélectionnez Créer.

   

9. 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.

10. Sélectionnez Terminé. Le webhook est désormais disponible dans le canal Teams.

    

La représentation graphique suivante fournit les étapes de création d’un webhook entrant :

Teams (version classique)

1. Dans le client Teams classique, sélectionnez Teams et accédez au canal dans lequel vous souhaitez ajouter un webhook entrant.

2. Sélectionnez Autres options ••• dans le coin supérieur droit.

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

   

4. Recherchez leWebhook entrant sélectionnez Ajouter.

   

   La boîte de dialogue Webhook entrant s’affiche.

5. Sélectionnez Ajouter.

   

   Remarque

   Si vous avez déjà ajouté un webhook entrant, l’option Configurer s’affiche. Sélectionnez Configurer pour créer un webhook entrant.

6. Fournissez un nom pour le webhook et chargez une image si nécessaire.

7. Sélectionnez Créer.

   

8. 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.

9. Sélectionnez Terminé.

   

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

Importante

Vous pouvez créer une application Teams de bot de notification à l’aide de Teams Toolkit autre qu’un webhook entrant. 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.

Vous pouvez créer et envoyer des messages actionnables via un webhook entrant ou un 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

C#

Exemple de référence de code

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

JavaScript

Exemple de référence de code

var formatted_Card_Payload = {
        "type": "message",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "contentUrl": null,
                "content": {
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "type": "AdaptiveCard",
                    "version": "1.2",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

Supprimer les webhooks entrants

Pour supprimer un webhook entrant d’un canal Teams, procédez comme suit :

Teams (nouvelle version)

1. Dans le nouveau client Teams, sélectionnez l’icône Teams et accédez au canal dans lequel vous souhaitez supprimer un webhook entrant.

2. Sélectionnez Plus d’options ••• à droite du nom du canal.

3. Sélectionnez Gérer le canal.

   

4. Sélectionnez Modifier.

   

5. Dans le volet gauche, sélectionnez Configuré.

6. Sous Webhook entrant, sélectionnez 1 Configuré.

   

7. Sélectionnez Gérer.

   

8. Sélectionnez Supprimer.

   

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

9. Cochez les cases requises.

10. Sélectionnez Supprimer.

    

Le webhook est maintenant supprimé du canal Teams.

Teams (version classique)

1. Dans le client Teams classique, sélectionnez l’icône Teams et accédez au canal dans lequel vous souhaitez supprimer un webhook entrant.

2. Sélectionnez Autres options ••• dans le coin supérieur droit.

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

4. Dans le volet gauche, sélectionnez Configuré.

5. Sous Webhook entrant, sélectionnez 1 Configuré.

   

6. Sélectionnez Gérer.

   

7. Sélectionnez Supprimer.

   

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

8. Cochez les cases requises.

9. Sélectionnez Supprimer.

   

Le webhook est maintenant supprimé du canal Teams.

Exemple de code

Exemple de nom	Description	.NET	Node.js
Webhook entrant	Cet exemple montre comment implémenter et utiliser un webhook entrant.	View	View

Voir aussi

• Créer des webhooks sortants
• Créer des bots pour Teams
• Extensions de messages
• Intégrer les applications Web
• Partager vers Teams à partir d’applications web