Integration mit Amazon Web Services

Informationen zur Integration mit Amazon Web Services

Amazon Web Services (AWS) ist eine häufig verwendete Cloud-Computing-Plattform. Einer der AWS-Services, Amazon EventBridge, kann als Integrationspunkt zwischen AWS und Qualtrics verwendet werden.

Basierend auf Ereignissen in Amazon EventBridge können Sie einen Qualtrics-Workflow auslösen, um dann andere Aufgaben auszulösen, z.B. das Senden einer Umfrage, eine Dankes-E-Mail oder eine Prämie für das Ausfüllen einer Umfrage.

Schritt 1: Einrichten eines JSON-Ereignisses

1. Erstellen Sie in Qualtrics einen neuen ereignisbasierten Workflow.
2. Wählen Sie für Ihr Ereignis das JSON-Ereignis aus.
3. Klicken Sie auf URL kopieren. Speichern Sie diese URL irgendwo, damit Sie sie später referenzieren können.

Schritt 2: Erstellen einer Verbindung in EventBridge

Der nächste Schritt besteht darin, eine Verbindung in EventBridge zu erstellen, damit Daten zwischen AWS und Qualtrics übertragen werden können.

1. Melden Sie sich auf einer neuen Registerkarte bei Amazon Web Services an, und navigieren Sie zur Amazon-Eventbridge-Konsole.
2. Navigieren Sie zu den API-Destinationen.
3. Klicken Sie auf der Registerkarte Verbindungen auf Verbindung erstellen.
4. Geben Sie einen Verbindungsnamen ein, damit Sie wissen, wofür diese Verbindung verwendet wird.
5. Wählen Sie Andere als Destinationstyp.
6. Wählen Sie für die Art der Berechtigungdie Option Einfach.
7. Geben Sie als Benutzernamen Ihren Qualtrics-Benutzernamen ein.
8. Geben Sie als Kennwort Ihren API-Schlüssel für Ihr Qualtrics-Konto ein.
9. Klicken Sie auf die Aufruf-HTTP-Parameter, um sie zu expandieren.
10. Konfigurieren Sie die folgenden Felder:
    • Parameter: Kopf
    • Key: Content-Type
    • Wert: application/json
11. Klicken Sie auf Anlegen.
12. Stellen Sie im Fenster Verbindungen sicher, dass Ihre Verbindung Autorisiert ist.

Schritt 3: API-Destination in EventBridge anlegen

Als Nächstes legen Sie eine API-Destination in EventBridge an, die steuert, wohin Daten gesendet werden. In diesem Fall ist die API-Destination die JSON-Ereignis-URL, die Sie in Schritt 1 kopiert haben.

1. Navigieren Sie in EventBridge zu API-Destinationen.
2. Klicken Sie auf der Registerkarte API-Destinationen auf API-Destination erstellen.
3. Geben Sie einen Namen ein, damit Sie wissen, wofür diese API-Destination verwendet wird.
4. Fügen Sie für den API-Zielendpunkt die JSON-Ereignis-URL ein, die Sie in Schritt 1 kopiert haben.
5. Wählen Sie für die HTTP-MethodePOST.
6. Geben Sie bei Bedarf ein Aufrufratenlimit pro Sekunde ein. Dadurch wird gesteuert, wie oft der Endpunkt maximal pro Sekunde aufgerufen werden kann.
   Tipp: Qualtrics unterstützt bis zu 3000 Transaktionen pro Minute (50 pro Sekunde).
7. Wählen Sie für Verbindung die Option Vorhandene Verbindung verwenden aus.
8. Wählen Sie über das Dropdown-Menü die Verbindung aus, die Sie in Schritt 2 angelegt haben.
9. Klicken Sie auf Anlegen.
10. Prüfen Sie im Fenster API-Destinationen, ob Ihre API-Destination Aktiv ist.

Schritt 4: Erstellen einer EventBridge-Regel

Regeln in EventBridge werden verwendet, um nach bestimmten Ereignissen und Mustern zu filtern. Die Regeln, die Sie anlegen, sind für Ihre Organisation und Ihren Anwendungsfall eindeutig. Für diesen Abschnitt verwenden wir das Beispiel zum Anlegen einer Regel, um nach der Erstellung neuer Objekte in S3 zu filtern.

1. Navigieren Sie in EventBridge zum Abschnitt Regeln.
2. Klicken Sie auf Regel erstellen.
3. Geben Sie Ihrer Regel einen beschreibenden Namen.
4. Wählen Sie für den Bus Eventdie Option default.
   Tipp: S3-Ereignisbenachrichtigungen können nur an den Standard-EventBridge-Bus gesendet werden.
5. Wählen Sie für den RegeltypRegel mit einem Ereignismuster.
6. Klicken Sie auf Weiter.
7. Wählen Sie als EreignisquelleAWS-Ereignisse oder EventBridge-Partnerereignisse.
   Tipp: Auf dieser AWS-Supportseite finden Sie Beispiele für Ereignisse, die Sie an EventBridge senden können. Für das Beispiel auf dieser Seite gehen wir davon aus, dass ein Objekt in einem S3-Bucket abgelegt wird, um in Qualtrics aufgenommen und verarbeitet zu werden.
8. Wählen Sie für die Methode Creation die Option Pattern-Formular verwenden.
9. Wählen Sie als EreignisquelleAWS-Services.
10. Wählen Sie Simple Storage Service (S3) als AWS-Service.
11. Wählen Sie Amazon S3-Ereignisbenachrichtigung als Ereignistyp aus.
12. Aktivieren Sie Bestimmte(s) Ereignis(e), und wählen Sie das Ereignis Objekt angelegt.
13. Aktivieren Sie Spezifische Bereiche nach Namen, und geben Sie Ihren S3-Bereichsnamen ein.
14. Klicken Sie auf Weiter.
15. Wählen Sie EventBridge-API-Destination für den Zieltyp.
16. Wählen Sie für die API-Destinationdie Option Vorhandene API-Destination verwenden, und wählen Sie dann über die Dropdown-Liste die API-Destination aus, die Sie in Schritt 3 angelegt haben.
17. Legen Sie für die Rolle Ausführung entweder eine neue Rolle an, oder verwenden Sie eine vorhandene Rolle.
18. Folgen Sie den Anweisungen im Editor Regeln, um die Regel zu prüfen und abschließend einzurichten.

Schritt 5: S3-Bereichseinstellungen aktualisieren

Folgen Sie den Anweisungen auf dieser AWS-Supportseite, um Ihren S3-Bucket zu aktualisieren, um Ereignisse an EventBridge zu senden.

Schritt 6: Workflow abschließen

Ihre AWS- und Qualtrics-Instanzen sind nun verbunden! Sobald ein Objekt in S3 hochgeladen wurde, wird ein Ereignis an EventBridge gesendet, das das Ereignis dann an das JSON-Ereignis in Ihrem Qualtrics-Workflow sendet und den Workflow startet. Sie haben vollen Zugriff auf das S3-Ereignis im Hauptteil des JSON-Ereignisses.

Sie können dann Aufgaben hinzufügen, die als Ergebnis Ihres Workflows ausgelöst werden. Weitere Informationen finden Sie unter Aufgaben definieren.