JSON-Ereignis

Beispiel: Integration mit Freshdesk

Das JSON-Ereignis kann für die Integration mit Freshdesk als Webhook-Regel im Dispatch'r verwendet werden. Das bedeutet, dass Ereignisse in Freshdesk dann Aufgaben in Qualtrics auslösen können, z.B. die Erstellung eines Tickets oder die Verteilung einer Umfrage.

1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
   
2. Kopieren Sie die URL.
   
3. Melden Sie sich auf einer neuen Registerkarte bei Freshdesk an.
4. Navigieren Sie im Abschnitt Administration zu der Option, die am besten zu der Art der Regel passt, die Sie festlegen möchten.
   
   Tipp: Lernen Sie den Unterschied zwischen Dispatch'r, Supervisor und Observer in der Supportdokumentation von Freshdesk kennen.
5. Legen Sie eine neue Regel an.
   
6. Legen Sie Bedingungen fest, um festzulegen, welches Freshdesk-Ereignis eine Aufgabe in Qualtrics auslösen soll.
   
   Beispiel: Wenn ein Freshdesk-Agent es veranlasst, den Ticketstatus von einem beliebigen Status in Gelöst zu ändern, möchten Sie eine CSAT-Umfrage mit Qualtrics senden.
7. Fügen Sie eine neue Aktion hinzu, und wählen Sie Web-Hook auslösen.
   
8. Setzen Sie die Anfrageart auf 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, geben Sie X-API-TOKEN: ein, und setzen Sie es auf Ihren API-Token.
    
11. Um die HTTP-Standardauthentifizierung zu verwenden, klicken Sie auf Erfordert Authentifizierung, fügen Sie Ihren Qualtrics-Benutzernamen hinzu, und geben Sie dann anstelle Ihres Kennworts Ihr API-Token ein.
    
12. Stellen Sie sicher, dass die Kodierung JSON ist.
    
13. Wählen Sie den zu übergebenden Inhalt manuell aus, oder wählen Sie Erweitert, um einen JSON-Text einzugeben.
14. Sichern Sie Ihre Regel.
15. Beenden Sie Ihren Workflow in Qualtrics. In diesem Beispiel würden wir wahrscheinlich eine XM-Directory-Aufgabe.
    
16. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, 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ösen können, z.B. das Anlegen eines Tickets oder die Verteilung einer Umfrage.

1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
   
2. Kopieren Sie die URL.
   
3. Melden Sie sich auf einer neuen Registerkarte an Ihrer ServiceNow-Entwicklerinstanz an.
4. Wählen Sie REST-Nachricht.
   
5. Klicken Sie auf Neu.
6. Nennen Sie Ihre Ruhemeldung.
   
7. Fügen Sie im Feld Endpunkt die URL ein, die Sie in Schritt 2 kopiert haben.
8. Ändern Sie den Authentifizierungstyp in Standard.
9. Wechseln Sie zur Registerkarte HTTP-Request.
   
10. Doppelklicken Sie, um X-API-TOKEN hinzuzufügen.
11. Doppelklicken Sie, um Ihr API-Token einzufügen.
    
12. Fügen Sie in einer neuen Zeile den Namen Content-type hinzu.
13. Setzen Sie den Wert auf application/json.
14. Klicken Sie auf Einreichen.
    
15. Öffnen Sie Ihre REST-Nachricht erneut.
    
16. Wählen Sie unter HTTP-Methoden die Option 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 Einreichen.
21. Öffnen Sie die POST-HTTP-Methode, die Sie gerade angelegt haben, erneut.
    
22. Wählen Sie unten auf der Seite Vorschau der Skriptverwendung.
    
23. Kopieren Sie den Text.
24. Suchen und wählen Sie Geschäftsregeln.
    
25. Wählen Sie Neu.
26. Wählen Sie eine Tabelle aus.
    
27. Wählen Sie Erweitert.
28. Legen Sie fest, wann die Geschäftsregel ausgeführt wird.
    Beispiel: Wenn Sie Meldung für Ihre Tabelle 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 der Meldungsstatus in Gelöst ändert.
    Tipp: Der Qualtrics-Support kann Ihnen dabei helfen, Ihr JSON-Ereignis einzurichten und es über ServiceNow zu 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, finden Sie Informationen zur Funktionsweise von Geschäftsregeln in der ServiceNow-Dokumentation.
29. Wechseln Sie zur Registerkarte Erweitert.
    
30. Fügen Sie den Inhalt ein, den Sie aus Schritt 22 kopiert haben, und geben Sie hier Ihren Code ein.
    
31. Fügen Sie einen Text hinzu. Hier kommunizieren Sie die Informationen, die Sie an Qualtrics weitergeben 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 der Qualtrics Support bei benutzerdefiniertem Code nicht helfen. Wenn Sie Probleme mit Ihrem Code haben, wenden Sie sich an die ServiceNow-Community, um Unterstützung zu erhalten.

    Der fettgedruckte Teil des Codes enthält drei zusätzliche Funktionen, die nicht im ursprünglichen Code enthalten sind: einen JSON-Hauptteil, der die Benutzer-ID und den Vorfallsstatus abruft, und einen Anruf, der die E-Mail-Adresse des Kunden des Vorfalls abruft, damit er die CSAT senden kann (kursiv unten). Weitere Fragen finden Sie in der ServiceNow-Dokumentation und in deren Community.

    (function executeRule(current, zurück /*null when async*/) {
    
         // Fügen Sie Ihren Code hier hinzu
        
      try { 
         var r = new sn_ws.RESTMessageV2('Qualtrics JSON Event ', 'JSON Event POST');
         var body = {
              "User 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);
         }
     anfangen(ex) {
          var message = ex.message;
          gs.addInfoMessage("Error Communicating w Qualtrics " + message);
    
     }
    
     })(current)(current)(rück)

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

     r.setRequestBody(JSON.stringify(body)); 

33. Klicken Sie auf Einreichen.
34. Beenden Sie Ihren Workflow in Qualtrics. Um das CSAT-Umfragebeispiel fortzusetzen, würden wir wahrscheinlich eine XM-Directory-Aufgabe.
    
35. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, 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 dann Aufgaben in Qualtrics auslösen können, z.B. die Erstellung eines Tickets oder die Verteilung einer Umfrage. Wenn Sie beispielsweise einen Kontodatensatz in Microsoft löschen, können Sie eine Qualtrics-Umfrage an den Kontoinhaber verteilen, der Ausgangsfragen stellt. (Beispiel: Es tut uns leid, dass Sie gehen! Wie war Ihre Zeit mit uns? Wie können wir uns verbessern?)

Um das JSON-Ereignis mit Aktionen zu integrieren, die in Microsoft Dynamics auftreten, müssen Sie die Einrichtung in Microsoft Flow anstelle von Dynamics vornehmen. Keine Sorge! Microsoft Flow wird mit jedem Microsoft-Dynamics-Konto kostenlos bereitgestellt, sodass Sie sich hier mit Ihren Dynamics-Informationen bei Flow anmelden können.

1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
   
2. Kopieren Sie die URL.
   
3. Gehen Sie auf einer separaten Registerkarte zu https://us.flow.microsoft.com/en-us/, und melden Sie sich mit Ihren Microsoft-Dynamics-Informationen bei Flow an.
4. Wählen Sie links Meine Flows aus.
   
5. Wählen Sie Neu, und wählen Sie Automatisiert aus.
6. Nennen Sie den Ablauf.
   
7. Wählen Sie einen Auslöser aus. Dies ist das Ereignis in Microsoft, das die Aufgabe in Qualtrics startet. Sie können wählen, was Ihren Zwecken dient. In diesem Beispiel würden wir jedoch „Wenn ein Datensatz gelöscht wird (Dynamics 365)“ auswählen.
8. Klicken Sie auf Erstellen.
9. Melden Sie sich unter Organisationsname an Ihrem Dynamics-Konto an.
   
10. Wählen Sie unter Entitätsname die Art des Datensatzes oder der Datei aus. Für unser Beispiel würden wir „Konten“ verwenden.
11. Klicken Sie auf Nächster Schritt, und wählen Sie Aktion hinzufügen.
12. Wählen Sie HTTP.
    
13. Ändern Sie die Methode in POST.
14. Fügen Sie Ihre JSON-Ereignis-URL in das Feld URI ein.
15. Verwenden Sie die Token-Authentifizierung. Geben Sie unter Header X-API-TOKEN ein, und fügen Sie in das Feld daneben Ihr API-Token ein.
16. Unter Body können Sie einen JSON-Body eingeben. Auf diese Weise können Sie entscheiden, welche Informationen Sie von Dynamics an Qualtrics übergeben möchten.
    Tipp: Verwenden Sie die Schaltfläche Dynamischen Inhalt hinzufügen, um Dynamics-Datensatzfelder auszuwählen, die Sie an Qualtrics übertragen möchten. Stellen Sie sicher, dass Sie dem richtigen JSON-Format folgen, wie im Screenshot dargestellt. Wenn Sie Hilfe bei der Fehlerbehebung dynamischer Inhalte benötigen, wenden Sie sich an den Microsoft-Support.
17. Wenn Sie fertig sind, klicken Sie auf Speichern.
18. Beenden Sie Ihren Workflow in Qualtrics. In diesem Beispiel würden wir wahrscheinlich eine XM-Directory-Aufgabe.
    
19. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit Genesys PureCloud

Mithilfe von JSON-Ereignissen können Sie mit Genesys PureCloud integrieren, um Kunden eine Folgeumfrage zu senden, nachdem sie eine Support-Telefon- oder Chat-Interaktion abgeschlossen haben.

1. Navigieren Sie in der Umfrage, die Sie senden möchten, zu Workflows.
   
2. Legen Sie einen neuen ereignisbasierten Workflow an.
3. Wählen Sie für das Workflow-Ereignis das JSON-Ereignis aus.
   
4. Klicken Sie auf URL kopieren, um den Ereignisendpunkt in Ihre Zwischenablage zu kopieren.
   
5. Öffnen Sie eine neue Registerkarte in Ihrem Browser, ohne das JSON-Ereignisfenster zu schließen, und navigieren Sie zu Genesys.
6. Navigieren Sie zu Admin.
   
7. Klicken Sie auf Aktionen.
8. Klicken Sie auf Aktion hinzufügen.
   
9. Wählen Sie Webdienst-Datenaktionen als Integrationsname aus.
   
   Tipp: Wenn Sie die Option zum Auswählen der Webdienst-Datenaktionen nicht haben, müssen Sie die Integration aktivieren. Weitere Informationen finden Sie auf dieser Seite.
10. Geben Sie Ihrer Aktion einen Aktionsnamen.
11. Klicken Sie auf Hinzufügen.
12. Navigieren Sie zur Registerkarte Setup.
    
13. Wechseln Sie zur Registerkarte Verträge.
14. Wählen Sie unter Eingabekontrakt die Option JSON.
15. Konfigurieren Sie die Eigenschaften, die an Qualtrics gesendet werden.

    Beispiel: Mit dem folgenden Code werden beispielsweise E-Mail-Adresse, Telefonnummer, Vorname und Nachname übergeben.

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

16. Wechseln Sie zur Registerkarte Konfiguration.
17. Ändern Sie den Request-Typ in POST.
18. Fügen Sie im Feld Anforderungs-URL-Vorlage die URL aus dem JSON-Ereignis in Qualtrics ein.
19. Klicken Sie auf Kopfzeile hinzufügen.
    
20. Geben Sie im Feld Schlüssel X-API-TOKEN ein.
21. Geben Sie im Feld Wert Ihr Qualtrics-API-Token ein.
22. Wechseln Sie zur Registerkarte Test.
23. Geben Sie Testwerte für Ihre Eigenschaften ein.
24. Klicken Sie auf Aktion ausführen.
25. Genesys wird Ihnen mitteilen, ob die Aktion erfolgreich war. Wenn dies fehlschlägt, 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 prü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 Teilnehmer senden, daher wählen wir die XM-Directory-Aufgabe aus.
    Tipp: Verwenden Sie beim Einrichten Ihrer Aufgabe das Piped-Text-Menü, um Werte zu verwenden, die von Genesys übergeben werden (z. B. Kunden-E-Mail, Name usw.).
29. Kehren Sie nach dem Einrichten der Aufgabe in Qualtrics zu Genesys zurück, und klicken Sie auf Speichern & Veröffentlichen.
    
30. Klicken Sie auf Ja.
31. Navigieren Sie zu Admin.
32. Klicken Sie auf Architekt.
33. Wählen Sie im Dropdown-Menü „Ablauf“ die Option Einladung zur Umfrage.
34. Klicken Sie auf Hinzufügen.
35. Geben Sie einen Namen, eine Beschreibung und eine Sparte für Ihren Ablauf ein.
36. Klicken Sie auf Fluss anlegen.
37. Wählen Sie unter dem Abschnitt Daten in Ihrer Toolbox die Option Datenaktion aufrufen, und ziehen Sie sie in die Auswahlliste im Ablauf.
38. Geben Sie Ihrer Aktion einen Namen.
39. Wählen Sie als Kategorie die Option Webdienst-Datenaktion aus.
40. Wählen Sie unter Datenaktion die Datenaktion aus, die Sie zuvor angelegt haben.
41. Klicken Sie neben jeder Eigenschaft auf das Dropdown-Menü, und wählen Sie Ausdruck aus.
42. Geben Sie für die Merkmalswerte an, welche Daten für jede Eigenschaft gesendet werden. Das Feld vervollständigt Ihre Felder während der Eingabe automatisch.
    Tipp: Auf dieser Seite sind alle Standardeigenschaften im Einladungsablauf der Umfrage enthalten. Sie können auch komplexe Ausdrücke verwenden, wenn Kundenkontaktinformationen fehlen oder eine zusätzliche Formatierung erforderlich ist.
    Tipp: Kontaktinformationen werden Survey.CustomerContact vorangestellt.
43. Klicken Sie auf das Feld ganz unten in Ihrem Ablauf.
44. Wählen Sie Toolbox, dann Umfrageeinladungen und dann Umfrage abbrechen.
45. Wählen Sie optOut für die Disposition.
46. Klicken Sie auf Veröffentlichen. Genesys validiert den Fluss und veröffentlicht ihn anschließend. Sobald dies erfolgt ist, ist der Ablauf aktiv und beginnt mit dem Senden von Umfragen an Kunden, wenn sie die Support-Interaktionen abgeschlossen haben.

Häufig gestellte Fragen