Envoyer un message à Microsoft Teams lorsqu'un enregistrement est ajouté

Langue: Français

Cet article a été traduit de l'anglais par IA et peut contenir des erreurs. Vos commentaires nous aideront à l'améliorer.

Dans ce tutoriel, nous allons configurer une automatisation qui publie un message sur un canal Microsoft Teams chaque fois qu'un nouvel enregistrement est ajouté à un formulaire — directement depuis ActivityInfo, sans service intermédiaire.

Nous jouons le rôle d'un coordinateur dont l'équipe travaille sur un canal Teams. L'équipe suit les projets dans un formulaire Projets et souhaite que chaque nouveau projet soumis soit annoncé sur le canal dès sa réception.

Ce dont vous avez besoin

Un formulaire à surveiller. Le nôtre est un formulaire Projets avec un champ de texte Nom du projet avec le code NAME et un champ de référence Partenaire avec le code PARTNER, mais n'importe quel formulaire fera l'affaire — adaptez les références de champ aux vôtres.
La permission de concevoir la base de données dans ActivityInfo.
Un canal Microsoft Teams, et la permission d'y ajouter un flux de travail. Teams reçoit les webhooks via l'application Workflows (les anciens connecteurs "Webhook entrant" d'Office 365 ont été retirés par Microsoft).

Nous référençons les champs par leur code (NAME plutôt que [Nom du projet]). Si vos champs n'ont pas encore de codes, prenez une minute pour les ajouter dans le concepteur de formulaires — les codes rendent les modèles lisibles et résistent aux changements d'étiquettes.

Étape 1 : Créer un flux de travail de webhook dans Teams

Dans Teams, allez sur le canal qui doit recevoir les messages et cliquez sur ⋯ (Plus d'options) à côté du nom du canal.
Sélectionnez Workflows.
Choisissez le modèle de webhook — nommé "Envoyer des alertes de webhook à un canal" ou "Publier sur un canal lorsqu'une requête de webhook est reçue", selon votre version de Teams.
Nommez le flux de travail, par exemple "ActivityInfo", confirmez l'équipe et le canal, et ajoutez le flux de travail.
Copiez l'URL que Teams affiche lorsque le flux de travail est créé — elle commence par https://prod-...logic.azure.com/... ou similaire.

Étape 2 : Ajouter l'automatisation

Dans ActivityInfo, ouvrez la base de données, sélectionnez le formulaire Projets, et sélectionnez Automatisations dans le volet de détails du formulaire.
Sélectionnez Ajouter une automatisation et nommez-la "Annoncer les nouveaux projets dans Teams".
Sélectionnez Cliquez ici pour commencer et choisissez le déclencheur Lors de l'ajout d'un enregistrement.
Donnez une étiquette au déclencheur, sélectionnez Sélectionner un formulaire, choisissez le formulaire Projets, confirmez, et sélectionnez Terminé.

Étape 3 : Ajouter l'étape du webhook

Sélectionnez Ajouter une étape, puis Action, puis Déclencher un webhook.
Donnez une étiquette à l'étape, par exemple "Publier sur le canal Teams".
Collez l'URL du flux de travail Teams dans le champ URL du webhook.
Réglez le Format de la charge utile sur Personnalisé, afin que nous puissions écrire exactement le corps du message attendu par le flux de travail Teams.

Étape 4 : Rédiger le message

Sélectionnez Modifier la charge utile.
Saisissez le corps du message — un objet JSON avec une seule propriété text, que le flux de travail du webhook Teams publie sur le canal. Les références ${...} sont remplies à partir de l'enregistrement qui a déclenché l'automatisation ; la liste des champs à droite les insère pour vous :
```
{"text": "Nouveau projet soumis : ${NAME} par ${PARTNER.NAME}, ajouté par ${_user.name}"}
```
Les valeurs sont automatiquement échappées pour le JSON, de sorte que les noms de projets contenant des guillemets ou des sauts de ligne ne peuvent pas casser le message.
Sélectionnez Terminé pour fermer l'éditeur de charge utile, et à nouveau Terminé pour fermer l'étape.
Sélectionnez Enregistrer. L'automatisation est maintenant active.

Étape 5 : Tester

Ajoutez un enregistrement de test au formulaire Projets.
En quelques instants, le message apparaît sur le canal Teams avec les détails du projet renseignés.

Des messages plus riches avec les Cartes Adaptatives

Le flux de travail de Teams accepte également les Cartes Adaptatives, qui peuvent contenir des titres, du texte en gras, des faits, des colonnes et des boutons renvoyant vers ActivityInfo. Concevez la carte, puis collez-la dans l'éditeur de charge utile, enveloppée dans une enveloppe de message, en ajoutant les références ${...} là où les valeurs de l'enregistrement doivent apparaître :

{
  "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": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "Nouveau projet soumis"
          },
          {
            "type": "TextBlock",
            "text": "**${NAME}** par ${PARTNER.NAME}, ajouté par ${_user.name}",
            "wrap": true
          }
        ]
      }
    }
  ]
}

Le texte des Cartes Adaptatives affiche les **doubles astérisques** en gras.

Pour aller plus loin

N'annoncer que certains projets : ajoutez une étape de filtre entre le déclencheur et le webhook — par exemple CONTAINS(SECTORS, "Santé") pour n'annoncer que les projets du secteur de la santé.
Annoncer plutôt les changements de statut : utilisez le déclencheur En cas de modification d'un enregistrement avec le filtre STATUS != _previous.STATUS, et incluez les deux valeurs dans le message : ${_previous.STATUS} → ${STATUS}.