Déclencher une automatisation à l’aide du connecteur HTTP Webhook lorsqu’un message est publié sur Slack

Déclenchez une automatisation à l'aide du HTTP Webhook utilisant le connecteur Trigger.

À propos

Résumé: déclenchez une automatisation à l’aide du connecteur HTTP Webhook lorsqu’un message est publié sur le canal Slack.

Applications: Slack, HTTP Webhook

Description

Le connecteur HTTP Webhook permet aux développeurs RPA de déclencher des automatisations en fonction d'événements externes à l'aide de webhooks. Le connecteur HTTP Webhook génère une URL Webhook. Cela doit être configuré dans les paramètres privés de l’application Slack OAuth et le type d’événement correspondant doit être activé. Les événements sont ensuite reçus instantanément par Orchestrator via cette URL.

Use case

Gestion des demandes d’assistance des clients envoyées dans un canal d’aide Slack. La demande doit soit créer un ticket Jira ou Zendesk, soit envoyer une notification Slack à une équipe ou un groupe d'utilisateurs à l'aide d'un bouton Slack.

Ce guide de l'utilisateur vous guide à travers le premier workflow de ce cas d'utilisation : le déclenchement d'automatisations à l'aide du connecteur Webhook lorsqu'un message est publié sur le canal Slack. Pour le deuxième workflow, par exemple, le déclenchement d'automatisations en fonction de l'événement Bouton Slack cliqué , consultez Utiliser les boutons Slack lorsqu'une opportunité est gagnée dans le système CRM.

Ce workflow utilise le connecteur HTTP Webhook et son déclencheur, Désérialiser JSON, ainsi que certaines activités Slack : Envoyer un message à l'utilisateur et Obtenir les informations de canal. Vous pouvez également utiliser les activités Envoyer un message au canal ou Envoyer une réponse .

Workflow

Remarque :

Pour gagner du temps, utilisez le modèle Déclencher une automatisation à l'aide du connecteur Webhook lorsqu'un message est publié sur le canal Slackdans Studio Web pour créer ce workflow.

1. Ouvrez Studio Web et créez un nouveau projet.

2. Sélectionnez Plus d’options. dans le menu Déclencheur manuel et sélectionnez Modifier le déclencheur.

3. Dans le catalogue des déclencheurs, sélectionnez HTTP Webhook : Événement Webhook affiché. Dans cette activité de déclencheur :

   1. Ajoutez votre connexion Slack. Le connecteur HTTP Webhook génère ensuite une URL Webhook, dont vous aurez besoin à l'étape 4.

      

   2. Ajoutez des filtres supplémentaires, si nécessaire. Nous vous recommandons d'utiliser au moins un filtre pour l' ID de canal. Sinon, tout message dans n'importe quel canal de votre espace de travail déclenchera l'événement.

      • Pour ajouter un filtre à l'ID du canal, sélectionnez le champ Filtres de données pour accéder au générateur de filtres. Dans la première colonne, saisissez body.event.channel, sélectionnez l'opérateur Equals et ajoutez l'ID du canal dans la troisième colonne.

        

   3. Vous pouvez également renommer l'activité de déclencheur afin qu'elle soit plus représentative de votre cas d'utilisation.

4. Copiez l'URL du Webhook générée à l'étape 1.

   1. Dans un autre onglet du navigateur, accédez à https://api.slack.com/apps et ouvrez votre application privée OAuth Slack.

   2. Accédez à la page des paramètres des abonnements aux événements .

      1. Configurez l'option Activer les événements sur Activé.

      2. Dans le champ URL de la demande , collez l'URL du webhook.

         

   3. Ensuite, faites défiler jusqu'à S'abonner aux événements au nom des utilisateurs et sélectionnez Ajouter un événement d'espace de travail. Ajoutez l’événement message.channels . Cela récupère les événements lorsqu'un message est publié par un utilisateur sur le canal. Vous pouvez ajouter tous les autres événements de votre choix.

      

   4. Sélectionnez Enregistrer les modifications. Les webhooks sont maintenant configurés pour votre application.

      Remarque :

      La sortie du connecteur Webhook (après la configuration de l'URL du Webhook pour Slack) est dans un format de chaîne JSON spécifique. Un exemple est fourni dans la section ci-dessous. Il doit être converti en objet JSON pour utiliser les champs de charge utile d'événement, tels que l'ID du canal, l'ID utilisateur, le texte du message, etc. dans les activités ultérieures (à l'aide de la notation pointée JSON/de l'expression VB). La charge utile de l’événement Slack peut également être récupérée à partir de https://api.slack.com/types/event. Pour éviter toute erreur, récupérez/consignez la chaîne de charge utile de l'événement à l'aide du message Journal avant d'utiliser la notation pointée JSON/l'expression VB.

5. Ajoutez une activité Désérialiser JSON à votre workflow. Cette étape convertit la sortie de la chaîne JSON du connecteur Webhook en objet JSON.

   1. Sélectionnez le paramètre d’entrée de la chaîne JSON pour ajouter une variable.

   2. Sous Événement de Webhook Webhook, accédez à Corps > Contenu.

      

6. Ajoutez l'activité Slack Obtenir les informations de canal à votre workflow. À cette étape, vous devez transmettre les champs de sortie de l'activité Désérialiser JSON à l'aide de la notation pointée JSON/de l'expression VB pour récupérer le nom du canal. Dans l’activité :

   1. Pour le champ Canal , sélectionnez Voir plus cliquez sur l'icône pour modifier le type d'entrée et sélectionnez Ouvrir l'éditeur d'expressions. Utilisez l'entrée ci-dessous pour transmettre l'ID de canal récupéré dans l'événement Webhook.

      jSONObject("event")("channel").ToString
      

7. Ajoutez l’activité Slack Envoyer un message à l’utilisateur à votre workflow. Maintenant, vous souhaitez envoyer un message à un utilisateur (vous-même) lorsqu’un message est publié sur un canal particulier (un canal d’aide) et saisir le message publié et le nom du canal à l’aide de variables. Dans cette activité :

   1. Dans le champ Saisie de l'utilisateur , sélectionnez l'utilisateur dans la liste déroulante ou saisissez manuellement l'adresse e-mail de l'utilisateur.

   2. Dans le champ Message , entrez un message en entrant le nom du canal (où le message a été publié) et le contenu textuel du message, à l'aide de variables. Par exemple: « Il y a une demande d'assistance client dans le canal <name>: »jSONObject("event")("text")

      • où <name> est récupéré à partir de la sortie Obtenir les informations du canal.

   3. Dans les champs Actions Boutons , saisissez deux actions de bouton pour Approuver le ticket et Avertir l'équipe. Ajoutez l'ID de l'action (requis), le nom de l'action (requis), le style (principal/danger), le titre de confirmation, le texte de confirmation, le titre de confirmation ok, le titre de refus de confirmation, au format séparé par des virgules :

      aks1,Approve Ticket,primary;
      aks2,Notify Team;
      

8. Vous êtes maintenant prêt à publier ou à exécuter le projet. Sélectionnez le bouton Publier en haut du workflow et saisissez les détails tels que le Nom de l'automatisation, la Description et l' Espace de travail. La version est mise à jour automatiquement.

   

Exemple de chaîne JSON

{
 "token": "SUAVTSGdUyb2qBaclIC14wKq",
 "team_id": "T02KZCJHY1W",
 "enterprise_id": "E02K962QC91",
 "context_team_id": "T02KZCJHY1W",
 "context_enterprise_id": "E02K962QC91",
 "api_app_id": "A04JJM6SUFM",
 "event": {
   "client_msg_id": "4abfc195-c381-4c8e-b952-00aa705ce507",
   "type": "message",
   "text": "YoYo",
   "user": "U02K95UU71Q",
   "ts": "1705418063.837779",
   "blocks": [
     {
       "type": "rich_text",
       "block_id": "moF7O",
       "elements": [
         {
           "type": "rich_text_section",
           "elements": [
             {
               "type": "text",
               "text": "YoYo"
             }
           ]
         }
       ]
     }
   ],
   "team": "T02KZCJHY1W",
   "channel": "C05LTLGRHEJ",
   "event_ts": "1705418063.837779",
   "channel_type": "channel"
 },
 "type": "event_callback",
 "event_id": "Ev06E0PJ7M45",
 "event_time": 1705418063,
 "authorizations": [
   {
     "enterprise_id": "E02K962QC91",
     "team_id": "T02KZCJHY1W",
     "user_id": "U02K95UU71Q",
     "is_bot": false,
     "is_enterprise_install": false
   }
 ],
 "is_ext_shared_channel": false,
 "event_context": "4-eyJldCI6Im1lc3NhZ2UiLCJ0aWQiOiJUMDJLWkNKSFkxVyIsImFpZCI6IkEwNEpKTTZTVUZNIiwiY2lkIjoiQzA1TFRMR1JIRUoifQ"
}