JSON-Ereignis

Über das Ereignis JSON

Wollten Sie schon einmal eine Anfrage auf Ihrer Website stellen, um ein Ticket in Qualtrics Auslöser? Wollten Sie schon einmal eine nahtlose Integration zwischen Qualtrics und Ihrem eigenen internen System schaffen? Wollten Sie schon einmal eine Aufgabe auf der Registerkarte Workflows Auslöser, aber mit einem Ereignis, das außerhalb von Qualtrics eintritt?

JSON ermöglichen es externer Software, Workflows über einen HTTP-Request zu starten. Anstatt auf ein Ereignis in Qualtrics zu warten, das weitere Aktionen in der Plattform auslöst, können Sie einfach ein JSON-Ereignis konfigurieren, um Anfragen von Dritten zu erhalten.

Einschränkungen

Das EREIGNIS JSON ist mit den folgenden Einrichtungen und Konfigurationen nicht kompatibel:

• Alles, was nicht HTTP ist (z.B. Nachrichtenwarteschlange, SMS).
• Ausgehende HTTP-Aufrufe.
• XML verarbeiten (der XML wird ignoriert).
• Verarbeiten Sie alles andere als JSON.
• Authentifizieren Sie auf andere Weise als einen X-API-TOKEN-Header oder unsere modifizierte HTTP-Basisberechtigung.
  Tipp: OAuth und andere Authentifizierungsformen sind mit JSON nicht kompatibel.
• Jegliches JSON, das nicht durch die Verwendung von JSONPath-Abfragen im JSON erfüllt werden kann.
• Aufrufe, die das API von 3.000 pro Minute überschreiten.
• Payloads größer als 100 KB.
• 10 manuell einzugebende Felder.
  TIPP: Sobald Informationen mit der Erfassung von Ereignissen eingezogen werden, werden sie dem JSON-Body hinzugefügt. Die Erfassung von Ereignissen ist die einzige Möglichkeit, mehr als 10 Felder hinzuzufügen.

Unterstützte Berechtigungstypen

Token-basierte Authentifizierung/Kopfauthentifizierung

Sie können sich authentifizieren, indem Sie Ihr API-Token über den Header der Anforderung als X-API-TOKEN.

.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json' -d '{

 

surveyId": "SV_012345678912345",

  "format": "csv"

}' 'https://yourdatacenterid.qualtrics.com/API/v3/responseexports'

HTTP-Basisauthentifizierung

Basic Auth ist in der Regel eine Base64-kodierte Version von username:password. Aus Sicherheitsgründen verwendet Qualtrics jedoch eine Base64-kodierte Zeichenfolge mit dem Benutzernamen:x-api-token.

Um Basic Auth zu verwenden, müssen Sie Header für den HTTP-Request festlegen. Der spezifische Kopf lautet Berechtigung.

 qualtrics:f8gIK7G6GFH985Y4

 Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Einrichten eines JSON-Ereignisses

1. Zunächst müssen Sie einen Workflow anlegen. Wechseln Sie zum Seite „Standalone Workflows“.
   
   Tipp: Sie können JSON auch in der Workflows Registerkarte in einem Projekt. Wir empfehlen, einen Workflow nur dann zu einem bestimmten Projekt hinzuzufügen, wenn sie sich explizit auf sie beziehen. (Zum Beispiel verteilen Sie dieses Projekt mit dem Ereignis JSON.)
2. Stellen Sie sicher, dass Sie im Ihre Workflows Registerkarte.
3. Klicken Sie auf Workflow anlegen .
4. Auswählen Wird gestartet, wenn ein Ereignis empfangen wird.
5. Wählen Sie die JSON Ereignis.
   
6. Wenn Sie möchten, können Sie eine Zusammenfassung des Auslösers angeben, die den Zweck des JSON-Ereignisses beschreibt.
7. Sie erhalten eine URL. Verwenden Sie diese Option, um Ihren neuen Workflow von außerhalb von Qualtrics über Postman, Ihr eigenes internes System oder andere ähnliche Anwendungen aufzurufen. Um sie zu kopieren, wählen Sie URL kopieren .
8. Standardmäßig erfordern JSON Folgendes: Authentifizierung. Wenn Sie nicht authentifizierte Anforderungen zulassen möchten, können Sie Authentifizierung durch Qualtrics verlangen .
9. Nun können Sie die Ereignis definieren. Dadurch werden Daten aus der Einlagerungsanforderung erfasst. Klicken Sie zum Starten auf Erweiterte Einstellungen.
   
   Tipp: Informationen zum Abschnitt Test finden Sie unter. Ereignisse erfassen unten.
10. Geben Sie im Feld auf der linken Seite den Feldname. Geben Sie im Feld auf der rechten Seite den Ort innerhalb der Ereignis an (HTTP-Request-Body).
    Tipp: Die Speicherorte müssen im JSONPath-Format vorliegen. Eine Kurzanleitung zur JSONPath-Syntax finden Sie in der folgenden Tabelle.
11. Um ein weiteres Feld hinzuzufügen, wählen Sie JSON hinzufügen.
12. Wenn Sie einen QUERY-Parameter hinzufügen möchten, fügen Sie ihn im QUERY-Parameter Abschnitt. Weitere Informationen dazu, was diese Parameter sind und wie sie im API funktionieren, finden Sie in unserer API zu Parametern.
    Warnung: Es ist nicht ratsam, persönlich identifizierbare Daten über QUERY-Parameter zu übergeben. Personenbezogene oder sensible Daten sollten nach Möglichkeit über den POST-Hauptteil weitergegeben werden, da POST sicherer ist.
13. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ).
14. Um Ihre Änderungen zu sichern, wählen Sie Sichern.
15. Jetzt können Sie Folgendes hinzufügen: Bedingungen und eine Aufgabe in Ihren Workflow, indem Sie auf das Pluszeichen ( + ). Bedingungen legen fest, wann ein Workflow ausgeführt wird, während Aufgaben das Ergebnis des Workflow sind. Siehe Aufbau von Arbeitsabläufen für weitere Informationen
    

Ereignisse erfassen

Wenn Sie ein externes API-Ereignis erstellen, müssen Sie möglicherweise Daten aus dem Post-Body auswerten. Es kann jedoch manchmal schwierig sein, diese Daten zu parsen. Wenn Sie herausfinden möchten, was Ihr externes API sendet, führen Sie die folgenden Schritte aus.

1. Klicken Sie auf Ihr JSON-Ereignis.
   
2. Standardmäßig wird die JSON aus den Ergebnisse erfassen, damit sie als dynamischer Text in anderen Aufgaben in diesem Workflow verwendet werden können wird aktiviert. Diese Option bewirkt, dass Felder, die in den Hauptteil der Payload geparst werden, automatisch als dynamischer Text wenn Sie Ihren Workflow hinzufügen Aufgaben.
   
3. Klicken Sie auf Neuen Test ausführen.
4. Es wird eine Nachricht angezeigt, dass Qualtrics auf den Empfang des Ereignis von Ihrem externen System wartet. Lösen Sie Ihr externes API aus.
   Tipp: Um diesen Test abzubrechen, wählen Sie Test abbrechen.
5. Wenn der Test erfolgreich war, wird die Meldung Verbindung zum Server erfolgreich hergestellt. Die Payload wird geparst und dem Fenster hinzugefügt.
6. Klicken Sie bei Bedarf auf Neuen Test ausführen um einen weiteren Test auszuführen. Sie müssen Ihren weiter API ausführen, nachdem Sie auf diese Option geklickt haben.
7. Klicken Sie auf Speichern.

JSONPath-Syntax

Die folgende Tabelle enthält einige Grundlagen der JSONPath-Syntax. Beachten Sie, dass diese nicht von Qualtrics eingerichtet werden, sondern Standards sind, die mit JSON verwendet werden.

JSONPath-Syntaxbeispiel

In diesem Beispiel wird gezeigt, wie die JSONPath-Tabelle bei einem JSON verwendet werden kann.

Dies ist unser JSON:

{
"eventDescription": "Monatlicher Umsatz",
"Stores": [
{
"name": "Acme Store",
"total": 1000000,
"topItem":

{ "price": "50", "description": "Anvil" }
},
{
"Name": "The Banana Stand",
"total": 250000,
"topItem":

{ "Preis": "4", "Beschreibung": "The Gob" }
},
{
"Name": "Pizza Planet",
"total": 80000,
"topItem":

{ "price": "15", "description": "Pepperoni" }
}
]
}

Nun sollten wir die Rückgabewerte hinzufügen, die in der JSONPath-Tabelle angezeigt werden, um sie klarer zu machen.

$ -> Acme Store
@ -> [
{
"name": "Acme Store",
"total": 1000000,
"topItem":

{ "price": "50", "description": "Anvil" }
}
]
. -> Monatlicher Umsatz
.. -> 50

-> ["Acme Store", "The Banana Stand", "Pizza Planet"]
[] -> Acme Store
[,] -> [
Unbekanntes Makro: { "name"}
,

Unbekanntes Makro: { "name"}
]

**Ändern Sie das Beispiel von [start:end:step] in "$.stores[1:3:1]".
[start:end:step] -> [
{
"Name": "The Banana Stand",
"total": 250000,
"topItem":

{ "Preis": "4", "Beschreibung": "The Gob" }
},
{
"Name": "Pizza Planet",
"total": 80000,
"topItem":

{ "price": "15", "description": "Pepperoni" }
}
]

?() -> [{
"name": "Acme Store",
"total": 1000000,
"topItem":

{ "price": "50", "description": "Anvil" }
}]

() -> [
{
"Name": "Pizza Planet",
"total": 80000,
"topItem":

{ "price": "15", "description": "Pepperoni" }
}
]

API im Knoten Javascript

Das folgende Beispiel ist eine Basisvorlage, der Sie bei der Formatierung Ihrer Ereignis folgen können.

var request = required('Request-Promise');
var surveyId = "SV_XXXXXXXXXXXX";
var triggerId = "OC_XXXXXXXXX";
var brandId = "YOUR_BRAND_ID";
var userId = "UR_XXXXXXXXXXXXXXX";
var datacenter = "xx1";
var apiToken = "YOUR_QUALTRICS_API_TOKEN";

var url = "https://" + Rechenzentrum + ".qualtrics/inbound-event/v1/Ereignis/JSON/ggers" +
     "?contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId;
var payload = {
    "text": "Dies ist etwas Text",
    "object": {
        "Nummer": 4
    },
    "array": ["a", "b", "c", "d"]
};

var options = {
    url: url,
    json: true,
    Hauptteil: Payload,
    Kopfzeilen: {
        "Content-Type": "application/json ", // ERFORDERLICH!!!
        "X-API-TOKEN": apiToken
    }
};

request.post(options).then(function (ret) {
    console.log("Success:", url, Payload);
}).atch(function (err) {
    console.log("error: ", url);
    console.log(err);
});

Beispiel: Integration mit Freshdesk

Das JSON Ereignis kann zur Integration mit Freshdesk als Webhook-Regel im Dispatch’r verwendet werden. Das bedeutet, dass Ereignisse in Freshdesk dann Aufgaben in Qualtrics Auslöser können, z. B. die Erstellung eines Ticket oder die Verteilung einer Umfrage.

1. Setzen Sie in QUALTRICS Ihr Ereignis auf JSON Ereignis.
   
2. Kopieren Sie die URL.
   
3. Melden Sie sich in einer neuen Registerkarte bei Freshdesk an.
4. In der Admin navigieren Sie zu der Option, die der Art der Regel am besten entspricht, die Sie festlegen möchten.
   
   Tipp: Erfahren Sie mehr über den Unterschied zwischen Dispatch’r, Supervisor und Observer in der Supportdokumentation von Freshdesk.
5. Legen Sie eine neue Regel an.
   
6. Legen Sie Bedingungen fest, um festzulegen, welches Ereignis eine Aufgabe in Qualtrics Auslöser soll.
   
   Beispiel: Wenn ein Freshdesk-Agent dafür sorgt, dass der Status eines Tickets von einem beliebigen Status in “Gelöst” geändert wird, möchten Sie vielleicht eine CSAT-Umfrage mit Qualtrics versenden.
7. Fügen Sie eine neue Aktion hinzu, und wählen Sie  Web-Hook Auslöser.
   
8. Setzen Sie das Kennzeichen Anforderungstyp bis POST.
   
9. Fügen Sie in Callback URL die JSON Ereignis URL aus Schritt 2 ein.
10. Um die Token-Authentifizierung zu verwenden, fügen Sie benutzerdefinierte Header hinzu, und geben Sie ein. X-API-TOKEN: und setzen Sie es auf Ihre API-Token.
    
11. Um die HTTP-Standardauthentifizierung zu verwenden, wählen Sie Authentifizierung erforderlich, fügen Sie Ihren Qualtrics hinzu, und geben Sie dann anstelle Ihres Kennworts Ihren API-Token.
    
12. Stellen Sie sicher, dass die Kodierung ist JSON.
    
13. Wählen Sie den zu übergebenden Inhalt manuell aus, oder wählen Sie Erweitert , um einen JSON einzugeben.
14. Sichern Sie Ihre Regel.
15. Schließen Sie Ihren Workflow in Qualtrics ab. In diesem Beispiel würden wir wahrscheinlich eine Aufgabe Umfrage per E-Mail senden oder Umfrage per SMS senden hinzufügen .
    
16. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit ServiceNow

Das JSON Ereignis kann für die Integration mit ServiceNow verwendet werden. Das bedeutet, dass Ereignisse in ServiceNow dann Aufgaben in Qualtrics Auslöser können, z.B. die Erstellung eines Ticket oder die Verteilung einer Umfrage.

1. Setzen Sie in QUALTRICS Ihr Ereignis auf JSON Ereignis.
   
2. Kopieren Sie die URL.
   
3. Melden Sie sich auf einer neuen Registerkarte bei Ihrer ServiceNow-Entwicklerinstanz an.
4. Auswählen REST.
   
5. Klicken Sie auf Neu.
6. Benennen Sie Ihre rest.
   
7. In der Endpunkt fügen Sie die URL ein, die Sie in Schritt 2 kopiert haben.
8. Authentifizierungstyp ändern in Grundlegend.
9. Wechseln Sie zum HTTP-Request Registerkarte.
   
10. Zum Hinzufügen doppelklicken X-API-TOKEN.
11. Doppelklicken Sie, um Ihre API-Token.
    
12. Fügen Sie in einer neuen Zeile den Namen hinzu. Inhaltstyp.
13. Setzen Sie den Wert auf application/json.
14. Klicken Sie auf Absenden.
    
15. Öffnen Sie Ihre Rest erneut.
    
16. Klicken Sie unter HTTP-Methoden auf Neu.
    
17. Geben Sie der Methode einen Namen.
    
18. Setzen Sie die HTTP-Methode auf POST.
19. Setzen Sie den Authentifizierungstyp auf Von übergeordnetem Element erben.
20. Klicken Sie auf Absenden.
21. Öffnen Sie die soeben angelegte POST-HTTP-Methode erneut.
    
22. Wählen Sie unten auf der Seite Skriptnutzung in der Vorschau anzeigen.
    
23. Kopieren Sie den Text.
24. Suchen und auswählen Geschäftsregeln.
    
25. Auswählen Neu.
26. Wählen Sie eine Tabelle aus.
    
27. Auswählen Erweitert.
28. Legen Sie fest, wann die Geschäftsregel ausgeführt wird.
    Beispiel: Wenn Sie für Ihre Tabelle “Vorfall” ausgewählt haben und eine CSAT-Umfrage für gelöste Tickets senden möchten, können Sie eine Bedingung hinzufügen, die besagt, dass diese Regel ausgeführt werden soll, wenn sich derStatus des Vorfalls in “gelöst” ändert.
    TIPP: Der Qualtrics Support kann Ihnen bei der Einrichtung Ihres JSON Ereignisses helfen und es über ServiceNow verbinden. Es kann jedoch einige Fragen zu ServiceNow-Funktionen geben, die sie nicht beantworten können. Wenn Sie Fragen dazu haben, wie/wann Geschäftsregeln ausgeführt werden, lesen Sie die ServiceNow-Dokumentation unter wie Geschäftsregeln funktionieren.
29. Wechseln Sie zum Erweitert Registerkarte.
    
30. Fügen Sie den Inhalt, den Sie aus Schritt 22 kopiert haben, dort ein, wo Folgendes steht: Fügen Sie hier Ihren Code hinzu.
    
31. Fügen Sie einen Hauptteil hinzu. Hier teilen Sie die Informationen mit, die Sie an Qualtrics weiterleiten möchten.
    

    Beispiel: Dies ist ein Beispiel für den endgültigen Code, den Sie in dieses Feld aufnehmen würden. Der Großteil dieses Codes ist die von ServiceNow bereitgestellte Ausgangsnachricht und variiert von Beispiel zu Beispiel. Leider kann Ihnen Qualtrics Support mit benutzerdefiniertem Code nicht helfen. Wenn Sie Probleme mit Ihrem Code haben, wenden Sie sich an ServiceNow-Community um Unterstützung zu erhalten.

    Der fett formatierte Teil des Codes enthält drei zusätzliche Funktionen, die nicht im ursprünglichen Code enthalten sind: einen JSON, der die Benutzer-ID und den Vorfallsstatus abruft, und einen Anruf, der die E-Mail-Adresse des Vorfallkunden abruft, sodass er die CSAT senden kann (kursiv unten). Siehe ServiceNow-Dokumentation und konsultieren Sie ihre Community wenn Sie weitere Fragen haben.

    (Funktion executeRule(current, before /*null when async*/) {
    
        // Fügen Sie hier Ihren Code hinzu
        
     try { 
         var r = new sn_ws.RESTMessageV2(' Qualtrics JSON Ereignis ', ' JSON Ereignis POST');
         var body = {
             "Benutzer-ID": gs.getUserID()
             "Incident State": current.state.getDisplayValue()
         };
         
         var target = new GlideRecord('sys_user');
         target.addQuery('sys_id', '=', current.caller_id);
         target.query(); 
         while(target.next()) { 
             body["email"] = target.email.getDisplayValue();
         }      
          var response = r.execute();
         var responseBody = response.getBody();
         var httpStatus = response.getStatusCode();
         gs.addInfoMessage(httpStatus);
        }
    atch(ex) {
         var message = ex;
         gs.addInfoMessage("Fehler bei der Kommunikation mit Qualtrics " + Nachricht);
    
    }
    
    })(Aktuell, Vorherige);

32. Fügen Sie den Hauptteil der Anforderung hinzu. Fügen Sie unter dem fettgedruckten, kursiven Teil des Codes aus dem vorherigen Schritt Folgendes hinzu:

     r.setRequestBody(JSON(body)); 

33. Klicken Sie auf Absenden.
34. Schließen Sie Ihren Workflow in Qualtrics ab. Um das Beispiel der Umfrage fortzusetzen, würden wir wahrscheinlich eine Aufgabe” Umfrage per E-Mail senden” oder ” Umfrage per Textnachricht (SMS) senden” hinzufügen .
    
35. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit Microsoft Dynamics über Microsoft Flow

Das JSON-Ereignis sorgt dafür, dass Ereignisse in Microsoft Dynamics Aufgaben in Qualtrics auslösen können, z. B. die Erstellung eines Tickets oder die Verteilung einer Umfrage. Wenn Sie beispielsweise einen Benutzerkonto-Datensatz in Microsoft löschen, können Sie eine Qualtrics-Umfrage an den Besitzer des Benutzerkontos verteilen, in der Fragen zum Ausstieg gestellt werden. (z. B. “Wir bedauern, dass Sie gehen! Wie war Ihre Zeit mit uns? Wie können wir uns verbessern?)

Um das JSON-Ereignis mit den in Microsoft Dynamics stattfindenden Ereignissen zu integrieren, müssen Sie die Einrichtung in Microsoft Flow und nicht in Dynamics vornehmen. Keine Sorge – Microsoft Flow wird mit jedem Microsoft Benutzerkonto kostenlos ausgeliefert, sodass Sie sich mit Ihren Dynamics-Informationen bei Flow anmelden können. hier.

1. Setzen Sie in QUALTRICS Ihr Ereignis auf JSON Ereignis.
   
2. Kopieren Sie die URL.
   
3. Wechseln Sie auf einer separaten Registerkarte zu https://us.flow.microsoft.com/en-us/ und verwenden Sie Ihre Microsoft Dynamics-Informationen, um sich bei Flow anzumelden.
4. Auswählen Meine Bewegungen auf der linken Seite.
   
5. Klicken Sie auf Neu und wählen Sie Automatisiert – von leer.
6. Benennen Sie den Fluss.
   
7. Wählen Sie einen Auslöser aus. Dies ist das Ereignis, das in Microsoft eintritt und die Aufgabe in Qualtrics startet. Sie können wählen, was Ihren Zwecken dient, aber für dieses Beispiel würden wir “Wenn ein Datensatz gelöscht wird (Dynamics 365)” wählen.
8. Klicken Sie auf Erstellen.
9. Unter Organisation, melden Sie sich bei Ihrem Benutzerkonto.
   
10. Unter Entitätsnamewählen Sie den Typ des Datensatzes oder der Datei aus. Für unser Beispiel würden wir „Konten“ verwenden.
11. Klicken Sie auf Weiter Schrittund wählen Sie Aktion hinzufügen.
12. Auswählen HTTP.
    
13. Ändern Sie die Methode bis POST.
14. Fügen Sie Ihre JSON Ereignis URL in das URI-Feld ein.
15. Verwenden Sie die Token-Authentifizierung. Unter Kopfzeilen, geben Sie ein X-API-TOKEN und fügen Sie im Feld weiter Ihre API-Token.
16. Unter Hauptteilkönnen Sie einen JSON eingeben. Auf diese Weise können Sie entscheiden, welche Informationen Sie von Dynamics an Qualtrics übergeben möchten.
    Tipp: Verwenden Sie die Dynamischen Inhalt hinzufügen Schaltfläche zum Auswählen der Dynamics-Datensatzfelder, die Sie in Qualtrics übernehmen möchten. Stellen Sie sicher, dass Sie das richtige JSON verwenden, das im Screenshot angezeigt wird. Um Hilfe bei der Fehlerbehebung bei dynamischen Inhalten zu erhalten, wenden Sie sich an Microsoft-Support.
17. Wenn Sie fertig sind, klicken Sie auf Sichern.
18. Schließen Sie Ihren Workflow in Qualtrics ab. In diesem Beispiel würden wir wahrscheinlich eine Aufgabe Umfrage per E-Mail senden oder Umfrage per SMS senden hinzufügen .
    
19. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit Genesys PureCloud

Mithilfe von JSON können Sie eine Integration mit Genesys PureCloud vornehmen, um Kunden nach Abschluss einer Supporttelefon- oder Chat-Interaktion eine Umfrage zu senden.

1. Rufen Sie die Seite Globale Workflows auf.
   
2. Neuen ereignisbasierten Workflow anlegen .
3. Wählen Sie für das Workflow-Ereignis das JSON-Ereignis aus.
   
4. Klicken Sie auf URL kopieren um den Ereignis in Ihre Zwischenablage zu kopieren.
   
5. Öffnen Sie, ohne das Fenster JSON Ereignis zu schließen, eine neue Registerkarte in Ihrem Browser und navigieren Sie zu Genesys.
6. Navigieren Sie zu Admin.
   
7. Klicken Sie auf Aktionen.
8. Klicken Sie auf Aktion hinzufügen.
   
9. Auswählen Web-Services-Datenaktionen als Integrationsname ein.
   
   Tipp: Wenn Sie keine Option zum Auswählen der Web-Services-Datenaktionen haben, müssen Sie die Integration aktivieren. Siehe diese Seite für weitere Informationen.
10. Geben Sie Ihrer Aktion einen Aktion Bezeichnung.
11. Klicken Sie auf Hinzufügen.
12. Navigieren Sie zum Einrichtung Registerkarte.
    
13. Wechseln Sie zum Verträge Registerkarte.
14. Wählen Sie unter Kontrakt eingeben die Option JSON.
15. Konfigurieren Sie die Eigenschaften, die an Qualtrics gesendet werden.

    Beispiel: Der folgende Code übergibt beispielsweise E-Mail-Adresse, Telefonnummer, Vorname und Nachname.

    {
           "Typ": "Objekt",
           "properties": {
             "emailAddress": {
               "type": "string"
             },
             "phoneNumber": {
               "type": "string"
             },
             "firstName": {
               "type": "string"
             },
             "lastName": {
               "type": "string"
             }
           },
           "additionalProperties": true
         }

16. Wechseln Sie zum Konfiguration Registerkarte.
17. Ändern Sie den Anforderungstyp in POST.
18. Fügen Sie in das Feld Vorlage für die Anfrage-URL die URL aus dem JSON-Ereignis in Qualtrics ein.
19. Klicken Sie auf Kopfzeile hinzufügen.
    
20. In der Schlüssel ein, und geben Sie Folgendes ein: X-API-TOKEN.
21. Geben Sie in das Feld Wert Ihren Qualtrics API-Token ein.
22. Wechseln Sie zum Test Registerkarte.
23. Geben Sie Testwerte für Ihre Eigenschaften ein.
24. Klicken Sie auf Aktion ausführen.
25. Genesys wird Ihnen sagen, ob die Aktion erfolgreich war. Wenn dies fehlgeschlagen ist, wird die Fehlerantwort angezeigt, um Sie bei der Behebung des Problems zu unterstützen.
    
26. Kehren Sie zu Ihrem JSON-Ereignis in QUALTRICS zurück und überprüfen Sie, ob Ihre Eigenschaften erfolgreich an QUALTRICS übergeben wurden.
27. Klicken Sie auf Speichern.
28. Klicken Sie auf das Pluszeichen ( + ) und dann auf Aufgabe, um die Aufgabe einzurichten, der Sie folgen möchten, wenn das JSON-Ereignis ausgelöst wird. In unserem Fall möchten wir eine Umfrage an die Befragten senden, also wählen wir die Aufgabe Umfrage per E-Mail senden oder Umfrage per Textnachricht (SMS) senden.
    Tipp: Verwenden Sie beim Einrichten Ihrer Aufgabe die dynamischer Text Menü zur Verwendung von Werten, die von Genesys übergeben wurden (z. B. Kunden-E-Mail, Name usw.).
29. Nachdem Sie die Aufgabe in Qualtrics eingerichtet haben, kehren Sie zu Genesys zurück, und klicken Sie auf S&peichern; Veröffentlichen.
    
30. Klicken Sie auf Ja.
31. Navigieren Sie zu Admin.
32. Klicken Sie auf Architekt.
33. Auswählen Umfrage im Ablauf-Dropdown-Menü.
34. Klicken Sie auf Hinzufügen.
35. Geben Sie Ihrem Flow eine Bezeichnung, Beschreibung, und Abteilung.
36. Klicken Sie auf Bewegung anlegen.
37. Wählen Sie im Abschnitt Daten in Ihrer Toolbox die Option Datenaktion aufrufen und ziehen Sie sie in die Dropbox im Fluss.
38. Geben Sie Ihrer Aktion eine Bezeichnung.
39. Wählen Sie für die Kategorie die Option Web-Services-Datenaktion.
40. Wählen Sie für Datenaktion die Datenaktion aus, die Sie zuvor angelegt haben.
41. Klicken Sie Weiter jeder Eigenschaft auf das Dropdown-Menü, und wählen Sie Ausdruck.
42. Geben Sie für die Eigenschaftswerte an, welche Daten für jede Eigenschaft gesendet werden. Das Feld füllt Ihre Felder während der Eingabe automatisch aus.
    Tipp: Diese Seite hat jede Standardeigenschaft im Umfrageeinladung. Sie können auch Folgendes verwenden: komplexe Ausdrücke in Situationen, in denen Kontakt fehlen oder zusätzliche Formatierungen erforderlich sind.
    Tipp: Kontakt werden vorangestellt mit: Umfrage.
43. Klicken Sie auf das unterste Feld in Ihrem Ablauf.
44. Auswählen Toolbox, dann Umfrage, dann Umfrage abbrechen .
45. Auswählen Opt-Out für die Disposition.
46. Klicken Sie auf Veröffentlichen. Genesys validiert den Fluss und veröffentlichen ihn anschließend. Sobald dies erfolgt ist, ist der Ablauf vorhanden und beginnt mit dem Senden von Umfragen an Kunden, wenn sie Supportinteraktionen abschließen.

FAQs