Déclencheurs Web Microsoft Teams

Les déclencheurs Web Microsoft Teams vous permettent d\'automatiser des tâches en fonction des événements qui surviennent dans les discussions ou canaux Microsoft Teams. Les déclencheurs Web surveillent des événements spécifiques se produisant dans Microsoft Teams. Une fois que les événements se produisent, le déclencheur lance les actions configurées.

Présentation

Les déclencheurs Web Microsoft Teams vous permettent de créer des déclencheurs basés sur des événements tels que des messages de chat direct, des messages de chat de groupe et des modifications d\'appartenance à un canal dans Microsoft Teams. Vous pouvez utiliser les déclencheurs pour lancer des flux de travail dès qu\'un événement se produit dans Microsoft Teams, réduisant ainsi la surveillance manuelle et le temps de réponse pour les communications critiques. Les options disponibles des déclencheurs Web Microsoft Teams vous permettent de créer des automatisations basées sur des déclencheurs pour des cas d\'utilisation tels que l\'attribution de tickets, l\'extraction d\'informations à partir de n\'importe quel message de chat, et le démarrage d\'un fil de discussion par e-mail pour informer les parties prenantes.

La latence entre l\'événement se produisant dans une application Microsoft Teams et le déclencheur initiant l\'automatisation basée sur l\'événement est inférieure à 30 secondes. Si la transmission de l\'événement à la session échoue, le déclencheur réessaie automatiquement de récupérer l\'événement.

Les déclencheurs Web Microsoft Teams ont la possibilité d\'utiliser des mots-clés pour filtrer les messages. L\'option Filtrer vous permet de configurer le déclencheur pour les cas d\'utilisation où l\'automatisation doit être déclenchée en fonction de mots-clés spécifiques. Cette option limite les réponses aux événements aux messages contenant les mots-clés spécifiés.

Le déclencheur capture les informations de la charge utile de la réponse d\'événement depuis le serveur Microsoft dans un format JSON structuré. Ce contenu inclut les informations d\'authentification qui permettent de valider les données. Vous pouvez afficher la charge utile de la réponse dans la page Audit log sous forme de paires clé-valeur. Vous pouvez utiliser ces informations de type clé-valeur comme paramètres d\'entrée pour les actions suivantes au sein de la session.

Authentification

Les déclencheurs web Microsoft Teams utilisent OAuth pour authentifier la connexion au compte Microsoft 365. Configurer la connexion OAuth avec les paramètres applicables pour Microsoft Entra pour Microsoft Teams. Pour en savoir plus sur la configuration des connexions OAuth, voir Créer OAuth connexion.

Les déclencheurs Web Microsoft Teams utilisent des certificats Microsoft Azure pour authentifier l\'abonnement au compte Microsoft et déchiffrer les données entrantes provenant des serveurs Microsoft. Connectez-vous à votre portail Microsoft Azure et créez un certificat. Pour plus d\'informations sur la création de certificats dans le portail Microsoft Azure, consultez Certificate creation methods dans le portail Microsoft Learn. Pour plus d\'informations sur la gestion des certificats, voir Managing encryption keys.

Assurez-vous d\'ajouter le certificat créé dans le Credential Vault. Effectuez les opérations suivantes pour ajouter les données du certificat au Credential Vault :

  1. Ouvrez le fichier de certificat dans n\'importe quel éditeur de texte.
  2. Copiez l\'intégralité du contenu du fichier de certificat.
  3. Connectez-vous à la Control Room en tant qu\'administrateur.
  4. Accédez à Gérer > Identifiants et cliquez sur Créer un identifiant.
  5. Saisissez un Nom d\'identifiant et une Description appropriés pour l\'identifiant.
  6. Saisissez un nom approprié dans Nom de l\'attribut dans la section Attributs.
  7. Sélectionnez Standard et collez le contenu du certificat dans le champ Valeur de la section Entrée des Attributs.
  8. Cliquez sur Créer des informations d\'identification pour enregistrer les données du certificat dans le Credential Vault.

Événements pris en charge

Les événements suivants sont pris en charge dans la configuration du déclencheur de discussion individuelle et d\'équipe :

Événements Description
Lorsqu\'un message de chat est ajouté. Lorsqu\'un nouveau message est reçu.
Lorsqu\'un message de chat est mis à jour Lorsqu\'un message de chat existant est modifié.
Lorsqu\'un message de chat est supprimé Lorsqu\'un message de chat existant est supprimé.

Les événements suivants sont pris en charge dans la configuration du déclencheur d\'appartenance à une équipe :

Événements Description
Lorsqu\'un nouveau membre d\'équipe est ajouté Lorsque les propriétaires de l\'équipe ajoutent un nouveau membre à l\'équipe sélectionnée.
Lorsqu\'un membre d\'équipe est mis à jour Lorsque les propriétaires d\'équipe modifient les informations d\'un membre existant de l\'équipe.
Lorsqu\'un membre d\'équipe est supprimé Lorsque les propriétaires d\'équipe retirent un membre de l\'équipe sélectionnée.

Prérequis

Assurez-vous que les prérequis suivants sont satisfaits :

  • Une licence Bot Creator ou Citizen Developer.
  • Autorisations DÉCLENCHEURS D\'ÉVÉNEMENTS et Afficher mes robots.
  • Autorisation Archiver et Extraire sur les dossiers dans lesquels se trouve l\'automatisation.
  • Une connexion OAuth active pour le compte Microsoft 365.
  • Un certificat Microsoft Azure.

Paramètres

Les paramètres suivants sont disponibles pour les déclencheurs Web Microsoft Teams :

Capture d\'écran du panneau des paramètres pour l\'option Chat dans le déclencheur Microsoft Teams
Remarque : Actuellement, le bouton Actualiser n\'est pas disponible sur les fenêtres modales Chat, Équipes et Canaux.
Connexion OAuth de la Control Room
Utilisez l\'option Choisir, et suivez les instructions dans la fenêtre modale Choisir une connexion OAuth pour sélectionner la connexion OAuth. La OAuth authentifie la connexion entre le compte Control Room et le compte Microsoft 365.
Chat
Utilisez cette option pour configurer le déclencheur en fonction des discussions individuelles. Le nom du chat fonctionne sur la base de l\'identifiant e-mail du destinataire du chat et non sur le nom d\'affichage du destinataire.
  • Écouter l\'événement : Spécifiez le type d\'événement que le déclencheur doit écouter.
  • Nom du chat : saisissez le nom du chat. Vous pouvez également utiliser le bouton Obtenir des noms de discussion pour sélectionner une discussion à l\'aide de la fenêtre modale Discussion.
  • Filtre : activez la case à cocher et saisissez les mots-clés pour filtrer les messages.
Teams et canal
Chat d\'équipe : utilisez l\'option Chat d\'équipe pour configurer le déclencheur en fonction des messages publiés sur un canal Teams. Les paramètres suivants sont disponibles pour cette option :

Capture d\'écran du panneau des paramètres pour l\'option Chat d\'équipe dans le déclencheur Microsoft Teams

  • Choisissez un ou plusieurs événements : spécifiez un ou plusieurs types d\'événements que le déclencheur doit écouter.
  • Nom de l\'équipe : saisissez le nom de l\'équipe. Vous pouvez également utiliser le bouton Sélectionner le nom de l\'équipe pour sélectionner l\'équipe à l\'aide de la fenêtre modale Équipes.
  • Nom du canal : saisissez le nom du canal. Vous pouvez également utiliser Sélectionner le nom du canal pour sélectionner l\'équipe en utilisant la fenêtre modale Canaux.
  • Filtre : activez la case à cocher et saisissez les mots-clés pour filtrer les messages.
Appartenance à l\'équipe : utilisez l\'option Appartenance à l\'équipe pour configurer le déclencheur en fonction des changements d\'appartenance au sein d\'une équipe. Les paramètres suivants sont disponibles pour cette option :

Capture d\'écran du panneau des paramètres pour l\'option Appartenance à l\'équipe dans le déclencheur Microsoft Teams

  • Options de membre : spécifiez un ou plusieurs types d\'événements que le déclencheur doit écouter.
  • Nom de l\'équipe : saisissez le nom de l\'équipe. Vous pouvez également utiliser le bouton Sélectionner le nom de l\'équipe pour sélectionner l\'équipe à l\'aide de la fenêtre modale Équipes.
Certificat
Utilisez l\'option Certificat pour sélectionner le certificat pour l\'authentification et le chiffrement.
  • Informations d\'identification : Utilisez l\'option Choisir et suivez les invites dans la fenêtre modale Sélectionner un identifiant pour sélectionner le certificat Microsoft Azure enregistré dans le Credential Vault.
  • Chaîne non sécurisée : Utilisez l\'option Chaîne non sécurisée pour saisir directement le contenu du certificat dans le champ de saisie.
Réponse
Utilisez l\'option Réponse pour enregistrer les données de réponse du déclencheur dans une variable Enregistrement. Vous pouvez soit créer une nouvelle variable, soit sélectionner une variable existante pour stocker ces données de réponse.

Lecture des données de réponse du déclencheur dans Audit log

Les données de réponse du déclencheur contiennent toutes les informations de l\'enregistrement d\'événement dans lequel un changement s\'est produit. Ces données de réponse sont stockées au format paire clé-valeur. Vous pouvez extraire ces données et les utiliser comme entrées pour d\'autres actions au sein de l\'automatisation. Une fois que le robot a terminé son exécution, les informations de données du déclencheur sont enregistrées comme type d\'événement Exécution de robot par déclencheur dans le Journal d\'audit.