Konfigurieren Sie einen Listener, um eine Aktion auszulösen, wenn ein Ereignis in einer externen Anwendung auftritt. Dieses Beispiel zeigt, wie Sie einen Task Bot mit einem Listener-Auslöser erstellen, um eine E-Mail an ein Microsoft 365 Outlook-Postfach zu senden, wenn ein Nutzer ein Ticket auf der Zendesk-Plattform erstellt.

Der Auslöser hört auf alle Ereignisse in der Zendesk-Plattform. Wenn der Benutzer ein Ticket in der Plattform erstellt, startet der Auslöser den anschließenden Automatisierungs-Workflow, um eine E-Mail mit den Ticketdetails an das konfigurierte Microsoft 365 Outlook-Postfach zu senden.

Vorbereitungen

Vergewissern Sie sich, dass Sie die folgenden Voraussetzungen erfüllen:
  • Eine Listener-URL für die Automatisierung. Weitere Informationen zum Erstellen von Listener-URLs finden Sie unter Listener-URL für Listener-Web-Auslöser wird erstellt.
  • Administratorrechte für die Zendesk-Plattform, um Tickets zu erstellen, zu aktualisieren und zu löschen.
  • Listener-Auslöseranforderungen in Listener-Auslöser aufgeführt.
  • Eine Datensatzvariable mit dem Namen TriggerData.
  • Aktive OAuth-Verbindung für Microsoft 365 Outlook.
  • Eine Anmeldeinformationsvariable, die den Microsoft 365 Outlook-Nutzernamen enthält.

Prozedur

  1. Führen Sie die folgenden Schritte aus, um einen Webhook in der Zendesk-Plattform zu erstellen.
    1. Melden Sie sich bei Ihrem Zendesk-Portal an
    2. Gehen Sie zu Admin Center > Apps und Integrationen > Webhooks und klicken Sie dann auf Webhook erstellen.
    3. Geben Sie Folgendes in die entsprechenden Felder ein.
      1. Verbindungsmethode auswählen: Wählen Sie Zendesk-Ereignisse aus und wählen Sie Beliebige Ticket-Ereignisse aus der Dropdown-Liste der Ereignistypen.
      2. Name: Geben Sie einen geeigneten Namen für den Webhook ein.
      3. Endpunkt-URL: Fügen Sie die Listener-URL hinzu, die Sie im Control Room erstellen.
      4. Authentifizierung: Wählen Sie API-Schlüssel aus.
      5. Headername: Geben Sie ticket-header ein.
      6. Wert: Geben Sie einen passenden Wert für den Header ein.
      Weitere Informationen zum Erstellen von Webhooks finden Sie unter Creating webhooks in Zendesk.
  2. Führen Sie die folgenden Schritte aus, um einen Task Bot in Control Room zu erstellen.
    1. Klicken Sie im linken Fensterbereich auf Automatisierung.
    2. Klicken Sie auf Erstellen > Task Bot.
      Der Assistent Task Bot erstellen wird angezeigt.
    3. Geben Sie einen geeigneten Namen für den Bot in das Feld Name ein.
      Das System speichert alle Bots standardmäßig im Ordner <\Bots>.
    4. Optional: Fügen Sie eine Beschreibung für den Bot im Feld Beschreibung hinzu.
    5. Optional: Klicken Sie auf Auswählen und folgen Sie den Anweisungen, um den Bot in einem anderen Ordner zu speichern.
    6. Klicken Sie auf Erstellen und bearbeiten.
      Der Bot ist erstellt und Task Bot bearbeiten wird angezeigt.
  3. Führen Sie die folgenden Schritte aus, um den Listener-Web-Auslöser hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Auslöser > Universal-Web-Auslöser und doppelklicken Sie anschließend auf Listener oder ziehen Sie ihn, um den Web-Auslöser zum Abschnitt Auslöser hinzuzufügen.
    2. Wählen Sie die generierte Listener-URL aus der Listener Dropdown-Liste aus.
      Das System füllt die generierte URL automatisch im Feld URL aus.
    3. Klicken Sie auf Hinzufügen in den Authentifizierungs-Headern, um das Header-Modal zu öffnen.
    4. Geben Sie den Namen der Authentifizierungs-Header in Name ein.
    5. Wählen Sie Unsichere Zeichenfolge aus und geben Sie den Wert des Headers in Wert ein.
      Alternativ können Sie den Wert als Anmeldeinformation im Credential Vault speichern und die Option Anmeldeinformation verwenden, um den Wert auszuwählen.
    6. Klicken Sie auf Hinzufügen, um den Authentifizierungs-Header hinzuzufügen.
    7. Wählen Sie Keine Validierung aus der Dropdown-Liste Signaturschema aus.
    8. Wählen Sie TriggerData aus der Dropdown-Liste Antwort aus.
      Die Variable TriggerData speichert die eingehende Antwortnutzlast von Zendesk. Weitere Informationen zur Antwort-Payload der Ticket-Ereignisse finden Sie unter Zendesk ticket events payloads.
  4. Führen Sie die folgenden Schritte aus, um die Microsoft 365 Outlook Connect-Aktion hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Aktionen > Microsoft 365 Outlook und doppelklicken Sie dann auf Verbinden oder ziehen Sie diese, um die Aktion zum Abschnitt Aktionen hinzuzufügen.
    2. Wählen Sie Azure Global in Azure Cloud.
      Wenn Ihr Microsoft 365 Outlook Teil der Microsoft 365 Government-Version ist, wählen Sie Azure US GCC High.
    3. Wählen Sie Control Room verwaltet im Feld OAuth2-Authentifizierungsmodus aus.
    4. Klicken Sie auf Auswählen und folgen Sie den Anweisungen im OAuth-Verbindung auswählen-Modal, um die OAuth-Verbindung für das Microsoft 365 Outlook auszuwählen.
    5. Klicken Sie auf Variable > Wert einfügen und folgen Sie den Anweisungen, um die Anmeldeinformation für den Microsoft 365 Outlook-Benutzernamen auszuwählen.
    6. Optional: Geben Sie einen passenden Sitzungsnamen in Microsoft 365 Outlook-Sitzung erstellen ein.
      Das System legt Microsoft365OutlookSession standardmäßig als Sitzungsnamen fest.
  5. Führen Sie die folgenden Schritte aus, um die Microsoft 365 Outlook Senden-Aktion hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Aktionen > Microsoft 365 Outlook und doppelklicken Sie dann auf Senden oder ziehen Sie es, um die Aktion zum Abschnitt Aktionen hinzuzufügen.
    2. Geben Sie den Sitzungsnamen ein, den Sie bei der Konfiguration der Aktion Verbinden eingegeben haben.
      Wenn der Standardname beibehalten wird, trägt das System Microsoft365OutlookSession als Microsoft 365 Outlook session ein.
    3. Geben Sie die Microsoft 365 Outlook E-Mail-ID ein, an die die Dateidetails in Empfänger weitergeleitet werden sollen.
    4. Geben Sie $TriggerData{"detail.subject"}$ in Betreff ein.
      Der detail.subject-Schlüssel enthält den Betreff des Zendesk-Tickets als Wert.
    5. Wählen Sie HTML-Code in E-Mail-Texttyp und geben Sie $TriggerData{"detail.description"}$ ein.
      Der Schlüssel detail.description enthält die Beschreibung des Zendesk-Tickets als Wert.
  6. Klicken Sie auf Speichern, um die Konfiguration zu speichern.
Wenn Sie auf Ausführen > Mit Auslösern ausführen klicken, aktiviert das System den Auslöser, und der Auslöser beginnt, auf Ticketing-Ereignisse in der Zendesk-Plattform zu warten. Wenn ein Benutzer ein Ticket erstellt, aktiviert der Auslöser die nachfolgenden Microsoft 365 Outlook-Aktionen. Das Microsoft 365 Outlook-Postfach erhält eine E-Mail, bei der der Ticket-Betreff als E-Mail-Betreff und die Ticket-Beschreibung als E-Mail-Text verwendet werden.