Tutorial: Erstellen einer Verbindung zu Zendesk als API-Ziel

Sie können Ereignisse EventBridge an Dienste von Drittanbietern weiterleiten, Zendeskz.

In diesem Tutorial verwenden Sie die EventBridge Konsole, um eine Verbindung zuZendesk, ein API-Ziel, auf das verwiesen wirdZendesk, und eine Regel zum Weiterleiten von Ereignissen herzustellenZendesk.

Voraussetzungen

Zum Durcharbeiten dieses Tutorials benötigen Sie die folgenden Ressourcen:

• Ein Zendesk-Konto

• Ein EventBridge -fähiger Amazon Simple Storage Service (Amazon S3) -Bucket.

Schritt 1: Erstellen einer Verbindung

Zum Senden von Ereignissen an Zendesk müssen Sie zunächst eine Verbindung zur Zendesk-API herstellen.

So erstellen Sie die Verbindung

1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

2. Wählen Sie im Navigationsbereich API-Ziele aus.

3. Wählen Sie die Registerkarte Verbindungen und dann Verbindung erstellen aus.

4. Geben Sie einen Namen und eine Beschreibung für die Verbindung ein. Geben Sie beispielsweise Zendesk für den Namen und Connection to Zendesk API für die Beschreibung ein.

5. Wählen Sie als Autorisierungstyp die Option Basic (Benutzername/Passwort) aus.

6. Geben Sie für Benutzername Ihren Zendesk-Benutzernamen ein.

7. Geben Sie für Passwort Ihr Zendesk-Passwort ein.

8. Wählen Sie Erstellen.

Schritt 2: Erstellen eines API-Ziels

Nachdem Sie die Verbindung erstellt haben, erstellen Sie als Nächstes das API-Ziel, das als Ziel der Regel verwendet werden soll.

So erstellen Sie das API-Ziel

1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

2. Wählen Sie im Navigationsbereich API-Ziele aus.

3. Wählen Sie API-Ziel erstellen aus.

4. Geben Sie einen Namen und eine Beschreibung für das API-Ziel ein. Geben Sie beispielsweise ZendeskAD für den Namen und Zendesk API destination für die Beschreibung ein.

5. Geben Sie für API-Zielendpunkt https://your-subdomain.zendesk.com/api/v2/tickets.json ein, wobei your-subdomain die mit Ihrem Zendesk-Konto verknüpfte Subdomain ist.

6. Wählen Sie in HTTP method POST.

7. Geben Sie für Begrenzung der Aufrufrate 10 ein.

8. Wählen Sie für Verbindung die Option Vorhandene Verbindung verwenden und die Zendesk-Verbindung aus, die Sie in Schritt 1 erstellt haben.

9. Wählen Sie Erstellen.

Schritt 3: Erstellen einer Regel

Als Nächstes erstellen Sie eine Regel zum Senden von Ereignissen an Zendesk, wenn ein Amazon-S3-Objekt erstellt wird.

So erstellen Sie eine Regel

1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

2. Wählen Sie im Navigationsbereich Rules aus.

3. Wählen Sie Regel erstellen aus.

4. Geben Sie einen Namen und eine Beschreibung für die Regel ein. Geben Sie beispielsweise ZendeskRule für den Namen und Rule to send events to Zendesk when S3 objects are created für die Beschreibung ein.

5. Bei Event bus (Ereignisbus) wählen Sie default (Standard) aus.

6. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

7. Wählen Sie Weiter aus.

8. Wählen Sie für Event source (Ereignisquelle) Other (Andere) aus.

9. Geben Sie für Ereignismuster Folgendes ein:

   {
     "source": ["aws.s3"]
   }

10. Wählen Sie Weiter aus.

11. Wählen Sie für Zieltypen die Option EventBridge API-Ziel aus.

12. Wählen Sie für API-Ziel die Option Vorhandenes API-Ziel verwenden und dann das ZendeskAD-Ziel aus, das Sie in Schritt 2 erstellt haben.

13. Wählen Sie für Ausführungsrolle die Option Eine neue Rolle für diese spezifische Ressource erstellen aus.

14. Gehen Sie für Weitere Einstellungen wie folgt vor:

    1. Wählen Sie für Zieleingabe konfigurieren die Option Eingabe-Transformator aus der Dropdown-Liste aus.

    2. Wählen Sie Eingabe-Transformator konfigurieren aus.

    3. Geben Sie für Beispielereignisse Folgendes ein:

       {
         "detail":[]
       }

    4. Gehen Sie für Zieleingabe-Transformator wie folgt vor:

       1. Geben Sie für Eingabepfad Folgendes ein:

          {"detail":"$.detail"}

       2. Geben Sie für Eingabevorlage Folgendes ein:

          {"message": <detail>}

    5. Wählen Sie Bestätigen aus.

15. Wählen Sie Weiter.

16. Wählen Sie Weiter.

17. Überprüfen Sie die Details der Regel und wählen Sie dann Create rule (Regel erstellen) aus.

Schritt 4: Testen der Regel

Um Ihre Regel zu testen, erstellen Sie ein Amazon S3 S3-Objekt, indem Sie eine Datei in einen EventBridge -fähigen Bucket hochladen. Wenn das Ereignis der Regel entspricht, EventBridge wird die ZendeskCreate Ticket API aufgerufen. Das neue Ticket wird im Zendesk-Dashboard angezeigt.

Schritt 5: Bereinigen Ihrer Ressourcen

Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Indem Sie AWS Ressourcen löschen, die Sie nicht mehr verwenden, verhindern Sie, dass Ihr AWS Konto unnötig belastet wird.

Um die EventBridge Verbindungen zu löschen

1. Öffnen Sie die API-Zielseite der EventBridge Konsole.

2. Wählen Sie die Registerkarte Connections (Verbindungen) aus.

3. Wählen Sie die Verbindung(en) aus, die Sie erstellt haben.

4. Wählen Sie Löschen aus.

5. Geben Sie den Namen der Verbindung ein und wählen Sie Löschen aus.

Um die EventBridge API-Destination (en) zu löschen

1. Öffnen Sie die API-Zielseite der EventBridge Konsole.

2. Wählen Sie das/die API-Ziel(e) aus, das/die Sie erstellt haben.

3. Wählen Sie Löschen aus.

4. Geben Sie den Namen des API-Ziels ein und wählen Sie Löschen aus.

Um die EventBridge Regel (n) zu löschen

1. Öffnen Sie die Regelseite der EventBridge Konsole.

2. Wählen Sie die Regel(n) aus, die Sie erstellt haben.

3. Wählen Sie Delete (Löschen).

4. Wählen Sie Löschen.