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

Dans ce tutoriel, nous configurons 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. Elle utilise l'étape de webhook intégrée d'ActivityInfo pour publier le message.

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 permettent de garder les modèles lisibles et | de survivre aux changements d'étiquettes.

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

1. Dans Teams, allez sur le canal qui doit recevoir les messages et cliquez sur ⋯ (Plus d'options) à côté du nom du canal et sélectionnez Workflows.

   

2. Choisissez le modèle de webhook — nommé "Send webhook alerts to a channel" ou "Post to a channel when a webhook request is received", selon votre version de Teams.

   

3. Sélectionnez "Team" et "Channel".

   

4. Copiez le lien du webhook.

   

Étape 2 : Ajouter l'automatisation

1. Dans ActivityInfo, ouvrez la base de données, sélectionnez les Paramètres de la base de données.

   

2. Sélectionnez le formulaire Projets, puis sélectionnez Automatisations dans le volet de détails du formulaire.

   

3. Sélectionnez Ajouter une automatisation et nommez-la "Annoncer les nouveaux projets dans le chat Teams".

   

4. Sélectionnez Cliquez ici pour commencer et choisissez le déclencheur Lors de l'ajout d'un enregistrement.

   

5. Donnez une étiquette au déclencheur et Sélectionner un formulaire.

   

6. Choisissez le formulaire Projets et Sélectionner un formulaire.

   

7. Sélectionnez Terminé.

   

Étape 3 : Ajouter l'étape de webhook

1. Sélectionnez Ajouter une étape.

   

2. Sélectionnez Action.

   

3. Sélectionnez Déclencher un webhook.

   

4. Donnez une étiquette à l'étape, par exemple "Publier sur le canal Teams".

5. Collez l'URL du flux de travail Teams dans le champ URL du webhook.

6. Définissez 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

1. Sélectionnez Modifier la charge utile.

   

2. Saisissez le corps du message. Le flux de travail Teams accepte 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 des références ${...} là où les valeurs de l'enregistrement doivent apparaître :

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

   {
        "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
                }
              ]
            }
          }
        ]
      }
   

   

3. Sélectionnez Terminé pour fermer l'éditeur de charge utile, et à nouveau Terminé pour fermer l'étape.

   

4. Sélectionnez Enregistrer. L'automatisation est maintenant active.

   

Étape 5 : Tester

1. Ajoutez un enregistrement de test au formulaire Projets.

   

2. En quelques instants, le message apparaît dans le canal Teams avec les détails du projet renseignés.

   

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 les changements de statut à la place : 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}.

Articles connexes

• Étape de webhook — tous les formats de charge utile en détail
• Envoyer un message à Google Chat lorsqu'un enregistrement est ajouté
• Publier un flux de travail lorsqu'une requête de webhook est reçue dans Teams (lien externe)
• Concepteur de Cartes Adaptatives (lien externe)