Créer des webhooks entrants avec des flux de travail pour Microsoft Teams
Un webhook entrant permet aux applications externes de partager du contenu dans des conversations et des canaux dans Microsoft Teams. Les webhooks sont utilisés comme outils de suivi et de notification. Vous pouvez publier sur un canal ou une conversation lors de la réception d’une demande de webhook.
Configurer un flux de travail webhook entrant à partir d’un modèle
Sélectionnez Plus d’options en regard du canal ou de la conversation pour lequel vous souhaitez créer un flux de travail, puis sélectionnez Flux de travail .
Selon que vous souhaitez que le webhook publie dans une conversation ou un canal, choisissez le modèle de webhook le mieux adapté à vos besoins. Chaque modèle a un type d’authentification différent.
Modèles de webhook de conversation
-
Publier dans une conversation lors de la réception d’une demande de webhook
-
Publier dans une conversation lorsqu’une demande de webhook est reçue d’utilisateurs spécifiques
-
Publier sur une conversation lorsqu’une demande de webhook est reçue des utilisateurs de mon locataire
Modèles de webhook de canal
-
Publier sur un canal lorsqu’une demande de webhook est reçue
-
Publier sur un canal lorsqu’une demande de webhook est reçue d’utilisateurs spécifiques
-
Publier sur un canal lorsqu’une demande de webhook est reçue d’utilisateurs de mon locataire
Remarque : Le modèle de webhook Publier dans une conversation lors de la réception d’une demande de webhook peut ne pas être disponible en fonction de votre type de organization. Pour obtenir de l’aide, contactez votre administrateur informatique.
Une fois le flux de travail ouvert, vous pouvez modifier son nom.
Vous devez également vous authentifier auprès de votre compte pour que vos flux de travail publient sur le canal ou la conversation. Si vous souhaitez choisir un autre compte avec lequel vous authentifier, sélectionnez Changer de compte et choisissez le compte que vous souhaitez utiliser.
Une fois que vous avez terminé de mettre à jour le nom et que vous avez authentifié le compte approprié, sélectionnez Suivant.
Sur la page suivante, vous serez en mesure de choisir l’équipe, le canal ou la conversation dans laquelle cette notification sera envoyée. Notez que si vous utilisez ce flux de travail à partir d’une conversation ou d’un canal, ces champs sont renseignés automatiquement pour vous. Après avoir renseigné les détails requis, sélectionnez Ajouter un workflow.
Une fois le flux de travail créé, une nouvelle boîte de dialogue avec l’URL que vous pouvez copier s’affiche.
Si vous avez besoin de copier à nouveau l’URL du flux de travail, vous pourrez la trouver en ouvrant l’application Workflows dans Teams, en sélectionnant le flux de travail qui a été créé, en sélectionnant Modifier et en développant le déclencheur Lors de la réception d’une demande de webhook Teams.
Configurer un flux de travail webhook entrant à partir de zéro
-
Sélectionnez Afficher d’autres applications sur le côté gauche de Teams, puis ouvrez Workflows .
-
Accédez à l’onglet Créer et sélectionnez Créer à partir de zéro en regard de la barre de recherche.
-
Utilisez la barre de recherche pour rechercher le déclencheur Lors de la réception d’une demande de webhook Teams, puis sélectionnez-la.
-
Choisissez qui peut déclencher le flux (type d’authentification). Vous pouvez choisir parmi trois types d’authentification différents :
-
Tout le monde (ce choix n’est pas authentifié)
-
Tout utilisateur dans mon locataire
-
Utilisateurs spécifiques dans mon locataire
-
-
Vous devez maintenant ajouter une action à votre workflow. Sélectionnez Nouvelle étape et choisissez l’action Publier carte dans la conversation ou le canal qui provient du connecteur Teams.
-
Vous allez maintenant choisir l’emplacement où les informations du webhook sont publiées. Sélectionnez le champ déroulant Publier dans et choisissez l’emplacement. Après avoir choisi l’emplacement du canal, de la conversation de groupe ou de la conversation avec le bot de flux, renseignez les autres champs obligatoires.
-
Sélectionnez Enregistrer sous votre workflow. Une fois enregistré, vous pouvez revenir à la zone Lors de la réception d’un webhook Teams et copier votre URL HTTP POST.
Remarque : Lors de la configuration du déclencheur de webhook, vous pouvez ajouter des conditions facultatives. Accédez au déclencheur Menu et sélectionnez Paramètres . Faites défiler vers le bas et sélectionnez Ajouter sous la section Conditions du déclencheur . Cette étape est facultative et n’est pas nécessaire pour que le workflow s’exécute.
En savoir plus
Documentation pour les développeurs pour le connecteur webhook Teams
Parcourir et ajouter des flux de travail dans Microsoft Teams
Ajouter ou exécuter un workflow à partir d’un message