zum Hauptinhalt springen
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

JSON-Ereignis


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Tipp: JSON-Ereignisse sind nur für Benutzer verfügbar, die Zugriff auf die Qualtrics-API erworben haben. Wenn Sie an dieser Funktion interessiert sind, wenden Sie sich an Ihren Account Executive oder Ihren XM Success Manager.

Informationen zum JSON-Ereignis

Wollten Sie schon einmal eine Anfrage auf Ihrer Website stellen, um ein Ticket in Qualtrics auszulösen? Wollten Sie schon einmal eine nahtlose Integration zwischen Qualtrics und Ihrem eigenen internen System herstellen? Wollten Sie jemals eine Aufgabe auf der Registerkarte Workflows auslösen, aber mit einem Ereignis, das außerhalb von Qualtrics auftritt?

JSON-Ereignisse ermöglichen es der externen Software, Workflows über HTTP-Requests zu starten. Anstatt auf ein Ereignis in Qualtrics zu warten, um weitere Aktionen auf der Plattform auszulösen, können Sie einfach ein JSON-Ereignis konfigurieren, um Anfragen von einem Drittanbieter zu erhalten.

Tipp: Sie müssen ein API-Token generieren, bevor Ihnen diese Funktion zur Verfügung steht. Wenn Sie bereits über ein API-Token verfügen, müssen Sie kein neues generieren.
Achtung: Das Einrichten eines JSON-Ereignisses erfordert fortgeschrittene Programmierkenntnisse. Unser Supportteam hilft zwar gerne bei den Grundlagen, um Informationen in die Veranstaltung einzubringen, aber wir können in den Programmieraspekten nicht unterstützen. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen.

Einschränkungen

Das JSON-Ereignis ist mit den folgenden Setups und Konfigurationen nicht kompatibel:

  • Alles, was nicht HTTP ist (z. B. Nachrichtenwarteschlange, SMS).
  • Ausgehende HTTP-Aufrufe.
  • XML verarbeiten (der XML-Request-Body wird ignoriert).
  • Verarbeiten Sie alles andere als JSON.
  • Authentifizieren Sie eine andere Art als einen X-API-TOKEN-Header oder unsere modifizierte HTTP-Basisberechtigung.
    Tipp: OAuth und andere Authentifizierungsformen sind nicht mit JSON-Ereignissen kompatibel.
  • Jegliches JSON-Parsen, das nicht durch JSONPath-Abfragen auf den JSON-Hauptteil erfüllt werden kann.
  • Aufrufe, die die API-Ratengrenze von 3.000 pro Minute überschreiten.
  • Payloads überschreiten 100 KB.

Unterstützte Berechtigungsarten

Token-basierte Autorisierung/Header-Berechtigung

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

Beispiel: Im folgenden POST-Beispiel geben wir in cURL die Basis-URL, den Content-Type und das Token im Header an. Die Umfrage-ID und das Exportformat sind in

body.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'

angegeben.

HTTP-Standardauthentifizierung

Basic Auth ist in der Regel eine Base64-kodierte Version von username:password. Um die Sicherheit zu verbessern, verwendet Qualtrics jedoch eine Base64-kodierte Zeichenfolge von username:x-api-token.

Um Basic Auth zu verwenden, müssen Sie Header für die HTTP-Anforderung festlegen. Der spezifische Kopf ist Authorization.

Beispiel: Angenommen, Ihr Qualtrics-Benutzername lautet demo@qualtrics.com und Ihr API-Token ist f8gIK7G6GFH985Y4. Zuerst würden Sie schreiben,

 demo@qualtrics.com:f8gIK7G6GFH985Y4

Nach der Base64-Kodierung würde dies wie folgt aussehen:

 Basis ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Daher hat der Berechtigungs-Header, den Sie Ihrem HTTP-Request hinzufügen, den Wert Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=.

Tipp: Sehen Sie sich diese Tools an, um base64 zu kodieren und base64 zu dekodieren.

JSON-Ereignis einrichten

  1. Zunächst müssen Sie einen Workflow anlegen. Wechseln Sie zur Seite „Standalone-Workflows“.
    Auf der Registerkarte "Workflows" auf "Workflows anlegen" klicken und dann starten, wenn ein Ereignis empfangen wird

    Tipp: Sie können auch JSON-Ereignisse im Registerkarte Workflows in einem Projekt. Wir empfehlen, einem bestimmten Projekt nur dann einen Workflow hinzuzufügen, wenn sie explizit zusammengehören. (Sie verteilen dieses Projekt beispielsweise mit dem JSON-Ereignis.)
  2. Stellen Sie sicher, dass Sie sich auf der Registerkarte Ihre Workflows befinden.
  3. Klicken Sie auf Workflow erstellen.
  4. Wählen Sie Gestartet, wenn ein Ereignis empfangen wurde.
  5. Wählen Sie das JSON-Ereignis aus.
    Auswählen des JSON-Ereignisses zum Starten des Workflows
  6. Wenn Sie möchten, geben Sie eine Trigger-Übersicht an, die den Zweck des JSON-Ereignisses beschreiben soll. Hinzufügen einer Übersicht, Kopieren des Endpunkts und Aktivieren der Authentifizierung
  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, klicken Sie auf URL kopieren.
  8. Standardmäßig erfordern JSON-Ereignisse eine Authentifizierung. Wenn Sie nicht authentifizierte Anforderungen zulassen möchten, können Sie Authentifizierung durch Qualtrics verlangen deaktivieren.
  9. Nun können Sie die Ereignisdaten definieren. Dadurch werden Daten aus der Einlagerungsanforderung erfasst. Klicken Sie zum Starten auf Erweiterte Einstellungen.
    Definieren von Ereignisdaten im Abschnitt „Erweiterte Einstellungen“

    Tipp: Informationen zum Abschnitt Test finden Sie unten unter Ereignisse erfassen.
  10. Geben Sie im Feld auf der linken Seite den JSON-Feldnamen ein. Geben Sie im Feld auf der rechten Seite den Ort innerhalb der Ereignisdaten an (HTTP-Request-Body).
    Tipp: Die Orte müssen im JSONPath-Format vorliegen! In der folgenden Tabelle finden Sie eine kurze Anleitung zur JSONPath-Syntax.
  11. Um ein weiteres Feld hinzuzufügen, klicken Sie auf JSON-Feld hinzufügen.
  12. Wenn Sie einen QUERY-Parameter hinzufügen möchten, fügen Sie ihn im Abschnitt QUERY-Parameter hinzu. Weitere Informationen zu diesen Parametern und ihrer Funktionsweise im API finden Sie in unserer API-Dokumentation zu Parametern.
    Warnung: Es ist nicht ratsam, persönlich identifizierbare Daten über QUERY-Parameter zu übergeben. Personenbezogene Daten oder sensible Daten sollten nach Möglichkeit über den POST-Body weitergeleitet werden, da POST sicherer ist. Wenden Sie sich an den Qualtrics Support, wenn Sie Fragen oder Bedenken haben.
  13. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( ).
  14. Um Ihre Änderungen zu sichern, wählen Sie Sichern.
  15. Nun können Sie Ihrem Workflow Bedingungen und eine Aufgabe hinzufügen, indem Sie auf das Pluszeichen (+) klicken. Bedingungen bestimmen, wann ein Workflow läuft, während Aufgaben das Ergebnis des Workflows sind. Siehe Workflow-Übersicht für weitere Informationen
    Klicken Sie auf das Pluszeichen und dann auf Aufgabe oder Bedingungen.

Tipp: Klicken Sie auf Ihr JSON-Ereignis, um die Parameter und JSON-Felder zu ändern.

Achtung: Ein JSON-Ereignis kann nur über das API von demselben Konto ausgelöst werden, das das Ereignis angelegt hat. Wenn ein anderes Konto zum Auslösen der API für ein JSON-Ereignis verwendet wird, erhalten Sie möglicherweise weiterhin eine 202-Success-API-Antwort. Dies bedeutet jedoch, dass ein gültiges API-Token verwendet wurde, um eine gültige Anforderung zu stellen, aber nicht unbedingt bedeutet, dass das richtige API-Token verwendet wurde oder dass das JSON-Ereignis korrekt ausgelöst wurde. Wenn Sie eine 202-Success-API-Meldung erhalten, möchten Sie prüfen, ob die Plattform die korrekte API verwendet hat.

 

Ereignisse erfassen

Wenn Sie ein externes API-Ereignis erstellen, müssen Sie möglicherweise Daten aus dem Beitrags-Body parsen. Manchmal kann es jedoch 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.
    Auswählen des JSON-Ereignisses
  2. Standardmäßig ist die Option JSON-Felder aus den Testergebnissen erfassen aktiviert, damit sie als dynamischer Text in anderen Aufgaben in diesem Workflow verwendet werden können. Diese Option sorgt dafür, dass Felder, die in den Hauptteil der Payload geparst werden, automatisch als dynamischer Text verfügbar sind, wenn Sie Ihre Workflow-Aufgaben hinzufügen.
    Klicken Sie auf „Neuen Test ausführen“.
  3. Klicken Sie auf Neuen Test ausführen.
  4. Es wird eine Meldung angezeigt, die besagt, dass Qualtrics auf den Empfang des Ereignisses aus Ihrem externen System wartet. Lösen Sie Ihr externes API aus.das JSON-Ereignis, das auf den Empfang eines Ereignisses von Ihrem externen System wartet
    Tipp: Um diesen Test abzubrechen, klicken Sie auf Test abbrechen.
  5. Wenn der Test erfolgreich war, wird die Meldung Erfolgreich mit dem Server verbunden angezeigt. Die Payload wird geparst und dem Fenster hinzugefügt.ein erfolgreicher Test - die JSON-Payload befindet sich im Ereignisfenster
  6. Klicken Sie bei Bedarf auf Neuen Test ausführen, um einen weiteren Test auszuführen. Nachdem Sie auf diese Option geklickt haben, müssen Sie Ihren nächsten API-Aufruf ausführen.
  7. Klicken Sie auf Speichern.

JSONPath-Syntax

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

Achtung: Das Einrichten eines JSON-Ereignisses erfordert fortgeschrittene Programmierkenntnisse. Unser Supportteam hilft zwar gerne bei den Grundlagen, um Informationen in die Veranstaltung einzubringen, aber wir können in den Programmieraspekten nicht unterstützen. Sie können immer versuchen, stattdessen unsere Community mit dedizierten Benutzern zu fragen.
JSONPath Beschreibung Beispiel
$ Wurzelobjekt/Element $.store[0].name
@ das aktuelle Objekt/Element $.store[?(@.name==”ACME Store”)]
. Untergeordneter Operator $.eventDescription
.. Rekursiver nachfolgender Operator $.shops[0]..price
* Platzhalter $.store[*].name
[] Tiefpunkt-Operator $.store[0].name
[,] Unionsbetreiber $.shops[0,1]
[start:end:step] Array-Slice-Operator $.shops[0:10:2]
?() Wendet einen Filter an $.store[?(@.name==”ACME Store”)]
() Skriptausdruck $.stores[(@.length-1)]

JSONPath-Syntaxbeispiel

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

Dies ist unser JSON-Objekt:

{
 "eventDescription": "Monthly Revenue",
 "stores": [
 {
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 { "price": "50", "description": "Anvil" }
,
 {
 "name": "Banana Stand", "total

": "topItem": { "peroni": "4", "]" {
"zap": "}" total":

 "Banana Stand",
 "total",
 "topItem":

 { "price": "4",


 "]
 "Gizet price" {"}
" total"

Nun sollten die in der JSONPath-Tabelle angezeigten Rückgabewerte hinzugefügt werden, um dies klarer zu machen.

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

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


 ->

 ["Acme Store", "The Banana Stand", "Pizza Planet"]

 [] -> Acme Store

 [,] -> [
 Unbekanntes Makro: { "name"}
 ,

 Unbekanntes Makro: {"name"}
 ein, 

, ändern 

 **Ändern [Stand:end:step] "Stand:step" "
 name": 
 Beschreibung: 








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

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

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

" "
" {"}price"

Beispiel-API in Knoten-JavaScript

Das folgende Beispiel ist eine grundlegende Vorlage, der Sie beim Formatieren Ihrer Ereignisdaten folgen können.

Achtung: Das Einrichten eines JSON-Ereignisses erfordert fortgeschrittene Programmierkenntnisse. Unser Supportteam hilft zwar gerne bei den Grundlagen, um Informationen in die Veranstaltung einzubringen, aber wir können in den Programmieraspekten nicht unterstützen. Sie können immer versuchen, stattdessen unsere Community mit dedizierten Benutzern zu fragen.
var request = required('request-versprechen');
 var surveyId = "SV_XXXXXXXXXXXXXX";
 var triggerId = "OC_XXXXXXXXX";
 var brandId = "YOUR_BRAND_ID";
 var userId = "UR_XXXXXXXXXXXXXXX";
 var brandId = "xx1";URvar/ ICinni_event = "

     

Beispiel: Integration mit Freshdesk

Tipp: Das ist getrennt von der Freshdesk-Aufgabe.

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.

Tipp: Der Qualtrics-Support kann Ihnen dabei helfen, Ihr JSON-Ereignis einzurichten und es über Freshdesk zu verbinden. Es kann jedoch einige Fragen zu Freshdesk-Funktionen geben, die sie nicht beantworten können. Wenn Sie Fragen zur Freshdesk-Seite haben, schauen Sie sich die Dokumentation zu Dispatch'r Rules an.
  1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
    Auswählen des JSON-Ereignisses
  2. Kopieren Sie die URL.
    Klicken auf „URL kopieren“ im JSON-Ereignis
  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.
    Drei verschiedene Optionen oben im Helpdesk-Produktivitätsabschnitt, wenn Sie in der Randleiste links auf das Admin-Zahnrad geklickt haben

    Tipp: Lernen Sie den Unterschied zwischen Dispatch'r, Supervisor und Observer in der Supportdokumentation von Freshdesk kennen.
  5. Legen Sie eine neue Regel an.
    Neue Regelschaltfläche oben rechts in Schwarz
  6. Legen Sie Bedingungen fest, um festzulegen, welches Freshdesk-Ereignis eine Aufgabe in Qualtrics auslösen soll.
    Der Name lautet Qualtrics CSAT, die Beschreibung lautet Umfrage gesendet, wenn das Ticket gelöst ist. Bedingung auf Beispiel gesetzt, Status ist aufgelöst. Aktion expandiert, sodass Trigger-Webhook angezeigt wird

    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.
    In der Aktion ist ein Menü expandiert, bei dem der auslösende Webhook hervorgehoben ist.
  8. Setzen Sie die Anfrageart auf POST.
    Das Anforderungstypfeld lautet POST, und die Callback-URL enthält die URL aus dem JSON-Ereignis.
  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.
    Im benutzerdefinierten Kopfzeilenfeld steht X-API-TOKEN: und dann ein unscharfer 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.
    Standardauthentifizierung - die erforderliche Berechtigung wurde ausgewählt, und die oben genannten Informationen wurden ausgefüllt.
  12. Stellen Sie sicher, dass die Kodierung JSON ist.
    Die Kodierung ist JSON, und die Anforderer-E-Mail wird aus dem Hauptteil ausgewählt.
  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.
    Auswählen der xm-Verzeichnisaufgabe
  16. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, wenn Sie bereit zum Starten sind.
Tipp: Weitere Informationen zu den Webhooks von Freshdesk finden Sie in der verlinkten Dokumentation auf ihrer Support-Website.

Beispiel: Integration mit ServiceNow

Tipp: Das ist getrennt von der ServiceNow-Aufgabe.

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.

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 zur Anmeldung an und Aktivierung Ihrer ServiceNow-Entwicklerinstanz haben, lesen Sie die Dokumentation zu Personal Developer Instances.
  1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
    Auswählen des JSON-Ereignisses
  2. Kopieren Sie die URL.
    Klicken auf „URL kopieren“ im JSON-Ereignis
  3. Melden Sie sich auf einer neuen Registerkarte an Ihrer ServiceNow-Entwicklerinstanz an.
  4. Wählen Sie REST-Nachricht.
    REST-Message auswählen
  5. Klicken Sie auf Neu.
  6. Nennen Sie Ihre Ruhemeldung.
    Geben Sie der Nachricht einen Namen, geben Sie den Endpunkt an, und wählen Sie den Authentifizierungstyp aus.
  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.
    Auswahl des HTTP-Requests und Hinzufügen des X-API-TOKEN
  10. Doppelklicken Sie, um X-API-TOKEN hinzuzufügen.
  11. Doppelklicken Sie, um Ihr API-Token einzufügen.
    API-Token einfü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.
    Klicken Sie auf „Senden“.
  15. Öffnen Sie Ihre REST-Nachricht erneut.
    Öffnen der restlichen Nachricht
  16. Wählen Sie unter HTTP-Methoden die Option Neu.
    auf Neu klicken
  17. Geben Sie der Methode einen Namen.
    die HTTP-Methode zu setzen und ihr einen Namen zu geben
  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.
    Öffnen der POST-Methode
  22. Wählen Sie unten auf der Seite Vorschau der Skriptverwendung.
    Kopieren des Textes
  23. Kopieren Sie den Text.
  24. Suchen und wählen Sie Geschäftsregeln.
    In: Servicenow. Geschäftsregeln wurden gesucht und nach links ausgewählt. Neue Drucktaste oben in der Mitte
  25. Wählen Sie Neu.
  26. Wählen Sie eine Tabelle aus.
    auf der Seite rot hervorgehobene Vitalfelder
  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.
    Registerkarte "Erweitert" geöffnet und JSON-Hauptteil hervorgehoben. Schaltfläche „Absenden“ unten
  30. Fügen Sie den Inhalt ein, den Sie aus Schritt 22 kopiert haben, und geben Sie hier Ihren Code ein.
    Inhalt einfügen
  31. Fügen Sie einen Text hinzu. Hier kommunizieren Sie die Informationen, die Sie an Qualtrics weitergeben möchten.
    Text hinzufügen

    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.
    Aufgabe „XM Directory“ auswählen
  35. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit Microsoft Dynamics über Microsoft Flow

Tipp: Das ist getrennt von der Microsoft Dynamics-Aufgabe.

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.

Tipp: Der Qualtrics-Support kann Ihnen dabei helfen, Ihr JSON-Ereignis einzurichten und es über Microsoft Flow und Microsoft Dynamics zu verbinden. Es kann jedoch einige Fragen zu Microsoft-Funktionen geben, die sie nicht beantworten können. Wenn Sie Fragen zur Microsoft-Seite haben, schauen Sie sich die Dokumentation für Flow und ihre Ressourcen für Dynamics an.
  1. Setzen Sie Ihr Ereignis in Qualtrics auf JSON-Ereignis.
    Auswählen des JSON-Ereignisses
  2. Kopieren Sie die URL.
    Klicken auf „URL kopieren“ im JSON-Ereignis
  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.
    Obere linke Ecke des Microsoft-Flows, Meine aus der dritten Option des linken Menüs ausgewählten Bewegungen und neue Drucktaste oben angeklickt und aufgeklappt, um die automatisierte Option von der dritten leeren Option in der Liste anzuzeigen
  5. Wählen Sie Neu, und wählen Sie Automatisiert aus.
  6. Nennen Sie den Ablauf.
    Erstellen Sie ein automatisiertes Flussfenster. Bild und Anweisungen nach links, Schritte auf der rechten Seite des Fensters nach unten
  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.
    Vergrößert, wenn ein Datensatz mit den Feldern für den Organisationsnamen und den Entitätsnamen direkt darunter gelöscht wird. Die neue Drucktaste für den Schritt befindet sich unten links in der Mitte.
  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.
    http und Optionen erweitert
  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.
    Wählen Sie das Ereignis xm directory.
  19. Vergessen Sie nicht, Ihre Umfrageänderungen zu veröffentlichen, wenn Sie bereit zum Starten sind.
Tipp: Microsoft Flow wird für diese Schritte bevorzugt, da es in der Lage ist, im JSON-Body weitere Informationen an Qualtrics zu senden. Wenn Sie dies in Microsoft Dynamics anstelle von Flow einrichten, werden nur Felder an Qualtrics gesendet, die während des Dynamics-Ereignisses geändert wurden. Wenn Sie sich beispielsweise für eine Datensatzaktualisierung entscheiden und nur ein E-Mail-Feld geändert wird, werden der Name und die Adresse nicht an Qualtrics gesendet, auch wenn Sie speziell nach diesen Feldern im Hauptteil fragen. Der Ablauf sendet alles, worum Sie gefragt haben, an Qualtrics, unabhängig davon, ob dieses Feld im auslösenden Ereignis geändert wurde.

Beispiel: Integration mit Genesys PureCloud

Tipp: Um diese Integration einzurichten, müssen Sie Zugriff auf Genesys Cloud Architect und Genesys Web Service Data Actions haben.

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.
    auf „Workflow erstellen“ und dann auf „Ereignisbasiert“ klicken
  2. Legen Sie einen neuen ereignisbasierten Workflow an.
  3. Wählen Sie für das Workflow-Ereignis das JSON-Ereignis aus.
    Auswählen des JSON-Ereignisses
  4. Klicken Sie auf URL kopieren, um den Ereignisendpunkt in Ihre Zwischenablage zu kopieren.
    auf URL kopieren klicken
  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.
    Zugriff auf Aktionen über die Admin-Registerkarte
  7. Klicken Sie auf Aktionen.
  8. Klicken Sie auf Aktion hinzufügen.
    die Drucktaste "Aktion hinzufügen".
  9. Wählen Sie Webdienst-Datenaktionen als Integrationsname aus.
    der Integration einen Namen und der Aktion einen Namen geben

    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.
    Auswählen von JSON und Definieren unserer Eigenschaften auf der Registerkarte „Vertragseinrichtung“
  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.Ändern der Anforderung in POST und Einfügen unserer JSON-URL
  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.
    Hinzufügen unseres API-Tokens als Header
  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.Hinzufügen von Testwerten vor dem Ausführen eines Tests
  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.
    die Erfolgsmeldung
  26. Kehren Sie zu Ihrem JSON-Ereignis in Qualtrics zurück, und prüfen Sie, ob Ihre Eigenschaften erfolgreich an Qualtrics übergeben wurden.Anzeigen der Test-Payload und Klicken auf Speichern
  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.Klicken Sie auf das Pluszeichen und dann auf die Aufgabe
    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.
    Veröffentlichen der Aktion
  30. Klicken Sie auf Ja.
  31. Navigieren Sie zu Admin.Architekten auf der Admin-Seite auswählen
  32. Klicken Sie auf Architekt.
  33. Wählen Sie im Dropdown-Menü „Ablauf“ die Option Einladung zur Umfrage.Auswählen der Umfrageeinladung aus der Ablauf-Dropdown-Liste
  34. Klicken Sie auf Hinzufügen.Geben Sie dem Ablauf einen Namen, eine Beschreibung und eine Sparte.
  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.Ziehen Sie den Titel Datenaktion aufrufen in den Ablauf.
  38. Geben Sie Ihrer Aktion einen Namen.Geben Sie der Anruf-Datenaktion einen Namen, wählen Sie die Kategorie aus, und wählen Sie die Datenaktion aus, die Sie zuvor angelegt haben.
  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.Hinzufügen von Ausdrücken zu jeder Eigenschaft
  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.Hinzufügen der Aktion zum Abbrechen der Umfrage am Ende des Ablaufs
  44. Wählen Sie Toolbox, dann Umfrageeinladungen und dann Umfrage abbrechen.
  45. Wählen Sie optOut für die Disposition.Ändern der Disposition in "Optout" vor dem Veröffentlichen des Flows
  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

Viele Seiten dieses Portals wurden mithilfe maschineller Übersetzung aus dem Englischen übersetzt. Obwohl wir bei Qualtrics die bestmögliche maschinelle Übersetzung ausgewählt haben, um ein möglichst gutes Ergebnis zu bieten, ist maschinelle Übersetzung nie perfekt. Der englische Originaltext gilt als offizielle Version. Abweichungen zwischen dem englischen Originaltext und den maschinellen Übersetzungen sind nicht rechtlich bindend.