Configurez un Listener afin de déclencher une action lorsqu\'un événement se produit dans une application externe. Cet exemple montre comment créer un Task Bot avec un déclencheur Listener pour envoyer un e-mail à une boîte aux lettres Microsoft 365 Outlook lorsqu\'un utilisateur crée un ticket sur la plateforme Zendesk.

Le déclencheur écoute tous les événements sur la plateforme Zendesk. Lorsque l\'utilisateur crée un ticket sur la plateforme, le déclencheur lance le flux de travail d\'automatisation suivant pour envoyer un e-mail contenant les détails du ticket à la boîte aux lettres Microsoft 365 Outlook configurée.

Prérequis

Assurez-vous de respecter les prérequis suivants :
  • Une URL d\'écouteur pour l\'automatisation. Pour plus d\'informations sur la création d\'URL d\'écouteur, voir Création de l\'URL d\'écouteur pour le déclencheur Web Listener.
  • Privilèges d\'administrateur pour la plateforme Zendesk afin de créer, mettre à jour et supprimer des tickets.
  • Exigences de déclenchement de l\'écouteur répertoriées dans Listener déclencheur.
  • Une variable d\'enregistrement nommée TriggerData.
  • Connexion OAuth active pour Microsoft 365 Outlook.
  • Une variable d\'identifiant qui contient le nom d\'utilisateur Microsoft 365 Outlook.

Procédure

  1. Suivez les étapes ci-dessous pour créer un webhook sur la plateforme Zendesk.
    1. Connectez-vous à votre portail Zendesk
    2. Accédez à Centre d\'administration > Applications et intégrations > Webhooks puis cliquez sur Créer un webhook.
    3. Saisissez les informations suivantes dans les champs appropriés.
      1. Sélectionnez un mode de connexion: Sélectionnez Événements Zendesk et choisissez Tous les événements de ticket dans la liste déroulante des types d\'événements.
      2. Nom : saisissez un nom approprié pour le webhook.
      3. URL du point de terminaison : ajoutez l\'URL d\'écouteur que vous créez dans Control Room.
      4. Authentification : sélectionnez Clé API.
      5. Nom de l\'en-tête : saisissez ticket-header.
      6. Valeur : saisissez une valeur appropriée pour l\'en-tête.
      Pour plus d\'informations sur la création de webhooks, voir Creating webhooks in Zendesk.
  2. Procédez comme suit pour créer un Task Bot dans la Control Room.
    1. Dans le volet de gauche, cliquez sur Automatisation.
    2. Cliquez Créer > Bot de tâche.
      L\'assistant Créer un robot de tâches s\'affiche.
    3. Saisissez un nom approprié pour le robot dans le champ Nom.
      Le système stocke tous les robots dans le dossier <\Bots> par défaut.
    4. Facultatif : Ajoutez une description pour le robot dans le champ Description.
    5. Facultatif : Cliquez sur Choisir et suivez les invites pour enregistrer le robot dans un autre dossier.
    6. Cliquez sur Créer et modifier.
      Le robot est créé et Modifier le robot de tâches s\'affiche.
  3. Procédez comme suit pour ajouter et configurer le déclencheur Web Listener.
    1. Cliquez sur Déclencheurs > Déclencheur web universel, puis double-cliquez ou faites glisser Écouteur pour ajouter le déclencheur web à la section Déclencheurs.
    2. Sélectionnez l\'URL d\'écouteur générée dans la liste déroulante Écouteur.
      Le système renseigne automatiquement l\'URL générée dans le champ URL.
    3. Cliquez sur Ajouter dans En-têtes d\'authentification pour ouvrir la fenêtre modale En-têtes.
    4. Entrez le nom de l\'en-tête d\'authentification dans Nom.
    5. Sélectionnez Chaîne non sécurisée et saisissez la valeur de l\'en-tête dans Valeur.
      Vous pouvez également enregistrer la valeur en tant qu\'identifiant dans Credential Vault et utiliser l\'option Identifiant pour sélectionner la valeur.
    6. Cliquez sur Ajouter pour ajouter l\'en-tête d\'authentification.
    7. Sélectionnez Aucune validation dans la liste déroulante Schéma de signature.
    8. Sélectionnez TriggerData dans la liste déroulante Réponse.
      La variable TriggerData stocke la charge utile de réponse entrante provenant de Zendesk. Pour plus d\'informations sur la charge utile de réponse des événements de ticket, voir Zendesk ticket events payloads.
  4. Procédez comme suit pour ajouter et configurer l\'action Microsoft 365 Outlook Se connecter.
    1. Cliquez sur Actions > Microsoft 365 Outlook, puis double-cliquez ou faites glisser Se connecter pour ajouter l\'action à la section Actions.
    2. Sélectionnez Azure Global dans Azure Cloud.
      Si votre Microsoft 365 Outlook fait partie de la version Microsoft 365 Gouvernement, choisissez Azure US GCC High.
    3. Sélectionnez Géré par la Control Room dans Mode d\'authentification OAuth2.
    4. Cliquez sur Choisir et suivez les instructions dans la fenêtre modale Choisir une connexion OAuth pour sélectionner la connexion OAuth pour Microsoft 365 Outlook.
    5. Cliquez sur Variable > Insérer une valeur et suivez les instructions pour sélectionner l\'identifiant du nom d\'utilisateur Microsoft 365 Outlook.
    6. Facultatif : Saisissez un nom de session approprié dans Créer une session Microsoft 365 Outlook.
      Le système définit Microsoft365OutlookSession comme nom de session par défaut.
  5. Procédez comme suit pour ajouter et configurer l\'action Microsoft 365 Outlook Envoyer.
    1. Cliquez sur Actions > Microsoft 365 Outlook, puis double-cliquez ou faites glisser Envoyer pour ajouter l\'action à la section Actions.
    2. Saisissez le nom de session que vous avez renseigné lors de la configuration de l\'action Se connecter.
      Si le nom par défaut est conservé, le système préremplit Microsoft365OutlookSession comme Session Microsoft 365 Outlook.
    3. Saisissez l\'identifiant de messagerie Microsoft 365 Outlook auquel les détails du fichier doivent être transférés dans À.
    4. Entrez $TriggerData{"detail.subject"}$ dans Objet.
      La clé detail.subject contient l\'objet du ticket Zendesk comme valeur.
    5. Sélectionnez code HTML dans Type de corps d\'e-mail et saisissez le $TriggerData{"detail.description"}$.
      La clé detail.description contient la description du ticket Zendesk comme valeur.
  6. Cliquez sur Enregistrer pour enregistrer la configuration.
Lorsque vous cliquez sur Exécuter > Exécuter avec des déclencheurs, le système active le déclencheur et celui-ci commence à surveiller les événements de gestion des tickets sur la plateforme Zendesk. Lorsqu\'un utilisateur crée un ticket, le déclencheur lance les actions Microsoft 365 Outlook suivantes. La boîte aux lettres Microsoft 365 Outlook reçoit un e-mail dont l\'objet correspond à l\'objet du ticket et la description du ticket constitue le corps du message.