Lösen Sie eine Automatisierung mithilfe des HTTP Webhook-Connectors aus, wenn eine Nachricht an Slack gesendet wird

Über

Zusammenfassung: Lösen Sie eine Automatisierung mit dem HTTP Webhook-Connector aus, wenn eine Nachricht an den Slack-Kanal gesendet wird.

Anwendungen: Slack, HTTP Webhook

Beschreibung

Der HTTP-Webhook-Connector ermöglicht es RPA-Entwicklern, Automatisierungen basierend auf externen Ereignissen mit Webhooks auszulösen. Der HTTP Webhook-Connector generiert eine Webhook-URL. Dies muss in den privaten Slack-OAuth-App-Einstellungen konfiguriert und der jeweilige Ereignistyp muss aktiviert sein. Die Ereignisse werden dann sofort vom Orchestrator über diese URL empfangen.

Use case

Verwalten von Kundensupport-Anfragen, die in einem Slack-Hilfekanal gestellt werden. Die Anforderung muss entweder ein Jira- oder Zendesk-Ticket erstellen oder eine Slack-Benachrichtigung über eine Slack-Schaltfläche an ein Team oder eine Benutzergruppe senden.

Diese Benutzeranleitung führt Sie durch den ersten Workflow dieses Anwendungsfalls: Auslösen von Automatisierungen mit dem Webhook-Connector, wenn eine Nachricht an den Slack-Kanal gesendet wird. Für den zweiten Workflow, d. h. das Auslösen von Automatisierungen basierend auf dem Ereignis Slack-Schaltfläche angeklickt , finden Sie weitere Informationen unter Verwenden von Slack-Schaltflächen, wenn eine Opportunity im CRM-System gewonnen wird.

Dieser Workflow verwendet den HTTP Webhook-Connector und seinen Webhook Event Happed -Trigger, Deserialize JSON, zusammen mit einigen Slack-Aktivitäten: Send Message to User und Get Channel Info. Sie können auch die Aktivitäten Send Message to Channel oder Send Reply verwenden.

Workflow

Hinweis: Wenn Sie Zeit sparen möchten, verwenden Sie die Vorlage Eine Automatisierung mit Webhook auslösen, wenn eine Nachricht an den Slack-Kanal gesendet wird in Studio Web, um diesen Workflow zu erstellen.

1. Öffnen Sie Studio Web und erstellen Sie ein neues Projekt.
2. Wählen Sie Weitere Optionen aus auf dem manuellen Trigger und wählen Sie Trigger ändern aus.
3. Wählen Sie im Triggerkatalog die Option HTTP Webhook: Webhook Event Happed aus. In dieser Triggeraktivität:
   1. Fügen Sie Ihre Slack-Verbindung hinzu. Der HTTP Webhook-Connector generiert dann eine Webhook-URL, die Sie in Schritt 4 benötigen.
      
      

      

      
      
   2. Fügen Sie bei Bedarf zusätzliche Filter hinzu. Wir empfehlen Ihnen, mindestens einen Filter für die Kanal-ID zu verwenden. Andernfalls löst jede Nachricht in einem beliebigen Kanal Ihres Arbeitsbereichs das Ereignis aus.
      • Um einen Filter für die Kanal-ID hinzuzufügen, wählen Sie das Feld Datenfilter aus, um auf den Filtergenerator zuzugreifen. Geben Sie in der ersten Spalte body.event.channel ein, wählen Sie den Operator Gleich aus und fügen Sie die Kanal-ID in der dritten Spalte hinzu.
        
   3. Sie können die Triggeraktivität auch in einen für Ihren Anwendungsfall repräsentativeren Namen umbenennen.
4. Kopieren Sie die in Schritt 1 generierte Webhook-URL.
   1. Gehen Sie in einer anderen Registerkarte im Browser zu https://api.slack.com/apps und öffnen Sie Ihre private Slack-OAuth-Anwendung.
   2. Navigieren Sie zur Seite Ereignisabonnements -Einstellungen.

      1. Setzen Sie den Umschalter Ereignisse aktivieren auf Ein.

      2. Fügen Sie die Webhook- URL in das Feld Anforderungs-URL ein.
         
         

         

         
         
   3. Scrollen Sie als Nächstes nach unten zu Ereignisse im Namen von Benutzern abonnieren und wählen Sie Arbeitsbereichsereignis hinzufügen aus. Fügen Sie das Ereignis message.channels hinzu. Dadurch werden Ereignisse abgerufen, wenn eine Nachricht von einem Benutzer auf dem Kanal gepostet wird. Sie können weitere Ereignisse Ihrer Wahl hinzufügen.
      
      

      

      
      
   4. Wählen Sie Änderungen speichern aus. Webhooks sind nun für Ihre App konfiguriert.
   Hinweis: Die Ausgabe des Webhook-Connectors (nachdem die Webhook-URL für Slack konfiguriert wurde) erfolgt in einem bestimmten JSON-String-Format (ein Beispiel findet sich im Abschnitt unten). Es muss in ein JSON-Objekt konvertiert werden, um die Ereignisnutzlastfelder wie Kanal-ID, Benutzer-ID, Nachrichtentext usw. in nachfolgenden Aktivitäten zu verwenden (mithilfe der JSON-Punktnotation/VB-Ausdruck). Die Slack-Ereignisnutzlast kann auch von https://api.slack.com/types/event abgerufen werden. Um Fehler zu vermeiden, rufen/protokollieren Sie die Ereignisnutzlastzeichenfolge mithilfe der Protokollmeldung, bevor Sie die JSON-Punktnotation/VB-Ausdruck verwenden.
5. Fügen Sie Ihrem Workflow die Aktivität Deserialize JSON hinzu . Mit diesem Schritt wird die JSON-Stringausgabe des Webhook-Connectors in ein JSON-Objekt konvertiert.
   1. Wählen Sie den Eingabeparameter JSON-Zeichenfolge aus, um eine Variable hinzuzufügen.
   2. Navigieren Sie unter Webhook-Ereignis passiert zu Textkörper > Inhalt.
      
6. Fügen Sie die Aktivität Slack Get Channel Info zu Ihrem Workflow hinzu. Bei diesem Schritt müssen Sie die Ausgabefelder der Aktivität Deserialize JSON mit der JSON-Punktnotation/VB-Ausdruck übergeben, um den Kanalnamen abzurufen. In der Aktivität:
   1. Wählen Sie für das Feld Kanal die Option Mehr anzeigen aus Symbol zum Ändern des Eingabetyps und zur Auswahl von Ausdrucks-Editor öffnen. Verwenden Sie den folgenden Eintrag, um die im Webhook-Ereignis abgerufene Kanal-ID zu übergeben.

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

7. Fügen Sie die Aktivität Slack Send Message to User zu Ihrem Workflow hinzu. Jetzt möchten Sie eine Nachricht an einen Benutzer (sich selbst) senden, wenn eine Nachricht in einem bestimmten Kanal (einem Hilfekanal) gepostet wird, und die gesendete Nachricht und den Kanalnamen mithilfe von Variablen eingeben. In dieser Aktivität:
   1. Wählen Sie im Feld Benutzereingabe den Benutzer aus der Dropdownliste aus oder geben Sie die E-Mail-Adresse des Benutzers manuell ein.
   2. Geben Sie im Feld Nachricht eine Nachricht ein, indem Sie den Namen des Kanals (auf dem die Nachricht gepostet wurde) und den Nachrichtentextinhalt mithilfe von Variablen eingeben. Zum Beispiel: „Im Kanal <name>: jSONObject("event")("text") “ ist eine Kundensupport-Anfrage vorhanden.“
      • wobei <name> aus der Ausgabe von Get Channel Info abgerufen wird.
   3. Geben Sie in den Feldern Schaltflächenaktionen zwei Schaltflächenaktionen für Ticket genehmigen und Team benachrichtigen ein. Fügen Sie die Aktions-ID (erforderlich), den Aktionsnamen (erforderlich), den Stil (Primär/Gefahren), den Bestätigungstitel, den Bestätigungstext, den Titel „Ok bestätigen“ und den Titel „Verweigern“ bestätigen in einem durch Kommas getrennten Format hinzu:

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

8. Sie können das Projekt nun veröffentlichen oder ausführen. Wählen Sie die Schaltfläche Veröffentlichen oben im Workflow aus und geben Sie Details wie Automatisierungsname, Beschreibung und Arbeitsbereich ein. Die Version wird automatisch aktualisiert.
   

JSON-Beispielzeichenfolge

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