Guides pratiques

Comment utiliser un Webhook Teams ?

Guide étape par étape pour configurer un Webhook Microsoft Teams afin qu'Astry puisse vous y envoyer des notifications.

Dans cette page, nous allons détailler le processus de configuration d'un Webhook Teams pour que Astry vous notifie.

  1. Création d'un Webhook Teams
  2. Configuration d'Astry avec le Webhook Teams
  3. Test de la configuration
  4. Corps du message qu'Astry envoie à Teams

Création d'un Webhook Teams

Vous devez d'abord ajouter l'application Workflow à votre Teams. Pour cela, rendez-vous dans le sous-menu "Applications" et recherchez "Workflows" puis cliquez sur Ajouter.

Ajouter une application Workflow

Une popup vous demande de choisir dans quel canal/conversation vous souhaitez recevoir les notifications. Sélectionnez le canal/conversation souhaité et cliquez sur Go.

Choix du canal

Dirigez-vous dans le canal/conversation précédemment sélectionné et cliquez sur le menu Power Automate.

Menu Power Automate

Sélectionnez le modèle Envoyer des alertes webhook à un canal.

Modèle webhook

Cliquez ensuite sur Continuer.

Continuer

Sélectionnez l'équipe souhaitée et le canal.

Sélection équipe et canal

Vous arrivez sur la page de configuration du workflow. Nous allons maintenant récupérer le Webhook URL. Cliquez sur Modifier.

Modifier

Cliquez sur When a Teams webhook is received.

When a Teams webhook is received

Copiez la valeur de URL POST HTTP et vous pouvez ensuite quitter les menus de configuration.

URL du Webhook

Note : Si vous souhaitez retrouver l'url du Webhook ultérieurement, vous pouvez retourner dans l'application Workflows via le menu latéral en cliquant sur les ... puis en sélectionnant Workflows.

Menu latéral Workflows

Configuration d'Astry avec le Webhook Teams

Rendez-vous dans l'onglet Notifications et cliquez sur Ajouter un Webhook Teams.

Ajouter un Webhook Teams

Entrez le nom de la notification et collez l'url du Webhook que vous avez copié précédemment.

Nom de la notification

Cliquez sur Ajouter.

Test de la configuration

Toujours dans l'onglet Notifications, cliquez sur le bouton Test de la notification que vous avez ajoutée.

Test

Et si vous retournez dans le canal/conversation pour lequel vous avez configuré le Webhook, vous devriez voir la notification.

Notification reçue dans Teams

Vous avez configuré votre Webhook Teams. N'oubliez pas de configurer votre stratégie de notifications pour qu'Astry vous notifie via Teams.

Corps du message qu'Astry envoie à Teams

À titre d'information, Astry envoie ce corps de message à Teams :

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          { "type": "Image", "url": "...", "size": "Small" },
          { "type": "TextBlock", "text": "title", "weight": "Bolder", "size": "Large", "wrap": true },
          { "type": "TextBlock", "text": "body", "wrap": true },
          { "type": "TextBlock", "text": "timestamp", "weight": "Light", "size": "Small", "wrap": true }
        ]
      }
    }
  ]
}