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 sind nur für Benutzer verfügbar, die Zugriff auf die Qualtrics erworben haben. Wenn Sie daran interessiert sind, diese Funktion zu erhalten, sprechen Sie mit Ihrem Benutzerkonto oder Ihre XM Success Manager:in.

Informationen zum 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 darauf zu warten, dass ein Ereignis in Qualtrics weitere Aktionen auf der Plattform Auslöser, können Sie einfach ein JSON konfigurieren, um Anforderungen von einem Drittanbieter zu empfangen.

Tipp: Sie müssen 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 erfordert fortgeschrittene Programmierkenntnisse. Unser Support-Team hilft zwar gerne bei den Grundlagen, Informationen in die Ereignis einzubringen, aber wir können keine Unterstützung in Bezug auf die Programmieraspekte leisten. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen.

Einschränkungen

Das JSON ist nicht kompatibel mit den folgenden Einstellungen und Konfigurationen:

  • 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.

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.

Beispiel: Im folgenden POST-Beispiel geben wir in cURL die URL, den Content-Type und das Token im Header an. Die Umfrage und das Exportformat werden im Hauptteil angegeben.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json ' -d '{   "surveyId": "SV_012345678912345",   "format": “csv”}' 'qualtrics'


 

 

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.

Beispiel: Angenommen, Ihr Qualtrics lautet qualtrics und Ihr API ist f8gIK7G6GFH985Y4. Zuerst würden Sie schreiben,

 qualtrics:f8gIK7G6GFH985Y4

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

 Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Also wird die Berechtigung Header, den Sie Ihrem HTTP-Request hinzufügen, den Wert Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=.

Tipp: Sehen Sie sich diese Werkzeuge für an Kodierung Base64 und Dekodierung Base64.

JSON

  1. Zunächst müssen Sie einen Workflow anlegen. Wechseln Sie zum Seite „Standalone Workflows“.
    Wählen Sie auf der Registerkarte "Workflows" die Option zum Anlegen eines Workflows, und starten Sie ihn, wenn ein Ereignis empfangen wird.

    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. (Beispiel: Sie sind Verteilen des Projekts mit dem 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.
    Auswählen des JSON</span zum Starten des Workflow
  6. Wenn Sie möchten, geben Sie eine Auslöser, die den Zweck des JSON beschreiben sollte. Hinzufügen einer Zusammenfassung, 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, 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.
    Definieren von Ereignis im Abschnitt „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. Bitte Kontakt kontaktieren 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. 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 Workflow-Übersicht für weitere Informationen
    Klicken Sie auf das Pluszeichen und dann Aufgabe oder die Bedingungen.
Tipp: Klicken Sie auf Ihr JSON, um die Parameter und JSON zu ändern.

Achtung: Ein JSON kann nur über API aus demselben Benutzerkonto ausgelöst werden, das das Ereignis angelegt hat. Wenn ein anderes Benutzerkonto verwendet wird, um das API für ein JSON auszulösen, erhalten Sie möglicherweise weiterhin eine API mit 202-Erfolg. 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 korrekt ausgelöst wurde. Wenn Sie eine API erhalten, möchten Sie die Plattform prüfen, um zu bestätigen, dass das richtige API verwendet wurde.

 

Ereignisse erfassen

Wenn Sie ein externes API erstellen, müssen Sie möglicherweise Daten aus dem Hauptteil des Beitrags parsen. 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.
    Auswählen des JSON</span
  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.
    Klicken Sie auf „Neuen Test ausführen“.
  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.das json</span, das auf den Empfang eines Ereignis von Ihrem externen System wartet
    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.Erfolgreicher Test - die JSON befindet sich im Ereignis
  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.

Achtung: Das Einrichten eines JSON erfordert erweiterte Programmierkenntnisse. Unser Support-Team hilft zwar gerne bei den Grundlagen, Informationen in die Ereignis einzubringen, aber wir können keine Unterstützung in Bezug auf die Programmieraspekte leisten. Sie können immer versuchen, unsere Community mit dedizierten Benutzern statt dessen.
JSON-Pfad Beschreibung Beispiel
$ Wurzelobjekt/-element $.store[0].name
@ Das aktuelle Objekt/Element $.store[?(@.name===”ACME Store”)]
. Untergeordneter Operator $.eventDescription
.. Rekursiver Nachfahrenoperator $.Stores[0]..Preis
* Platzhalter $.store[*].name
[] Subskriptoperator $.store[0].name
[,] Union-Operator $.shops[0,1]
[Start:Ende:Schritt] Array-Slice-Operator $.shops[0:10:2]
?() Wendet einen Filter an $.store[?(@.name==”ACME Store”)]
() Skriptausdruck $.store[(@.length-1)]

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.

Achtung: Das Einrichten eines JSON erfordert erweiterte Programmierkenntnisse. Unser Support-Team hilft zwar gerne bei den Grundlagen, Informationen in die Ereignis einzubringen, aber wir können keine Unterstützung in Bezug auf die Programmieraspekte leisten. Sie können immer versuchen, unsere Community mit dedizierten Benutzern statt dessen.
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

Tipp: Dies ist getrennt von der Aufgabe.

Das JSON kann für die Integration mit Freshdesk als Webhook-Regel in 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.

Tipp: Qualtrics Support kann Ihnen dabei helfen, Ihr JSON einzurichten und ü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 Versandregeln.
  1. Legen Sie in Qualtrics Ereignis bis JSON .
    Auswählen des JSON</span
  2. Kopieren Sie die URL.
    Klicken auf URL im JSON</span
  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.
    Drei verschiedene Optionen oben im Helpdesk-Produktionsbereich, wenn Sie auf das Admin-Zahnrad in der Randleiste auf der linken Seite geklickt haben

    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.
    Neue Regeldrucktaste in Schwarz oben rechts
  6. Legen Sie Bedingungen fest, um festzulegen, welches Ereignis eine Aufgabe in Qualtrics Auslöser soll.
    Der Name lautet Qualtrics CSAT, die Beschreibung lautet Umfrage gesendet, wenn Ticket gelöst ist. Bedingungssatz. Der Status ist "Aufgelöst". Aktion expandiert, sodass Auslöser angezeigt wird

    Beispiel: Vielleicht, wenn ein Freshdesk Agent macht es so, dass das Ticket Der Status wird von einem beliebigen Status in Gelöst geändert.möchten Sie eine CSAT mit Qualtrics senden.
  7. Fügen Sie eine neue Aktion hinzu, und wählen Sie  Web-Hook Auslöser.
    Aktion hat Menü mit hervorgehobenem Auslöser Webhook aufgeklappt
  8. Setzen Sie das Kennzeichen Anforderungstyp bis POST.
    Das Feld für die Anforderungsart lautet POST, und die URL enthält die URL aus dem Ereignis
  9. In URLFügen Sie die JSON 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.
    Im benutzerdefinierten Header-Feld steht X-API-TOKEN: und dann ein verschwommenes 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.
    Standardauthentifizierung - erfordert Berechtigung wurde ausgewählt, und die oben genannten Informationen wurden ausgefüllt
  12. Stellen Sie sicher, dass die Kodierung ist JSON.
    Die Kodierung ist json, und die Anforderer-E-Mail wird aus dem Text ausgewählt.
  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 XM Directory Aufgabe.
    xm directory</span auswählen
  16. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.
Tipp: Weitere Informationen zu Freshdesk’s Webhooksfinden Sie in der verlinkten Dokumentation auf ihrer Support-Seite.

Beispiel: Integration mit ServiceNow

Tipp: Dies ist getrennt von der Aufgabe.

Das JSON 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.

Tipp: Qualtrics Support kann Ihnen dabei helfen, Ihr JSON einzurichten und über ServiceNow zu verbinden. Es kann jedoch einige Fragen zu ServiceNow-Funktionen geben, die sie nicht beantworten können. Wenn Sie Fragen zum Anmelden an und Aktivieren Ihrer ServiceNow-Entwicklerinstanz haben, lesen Sie die Dokumentation zu Persönliche Entwicklerinstanzen.
  1. Legen Sie in Qualtrics Ereignis bis JSON .
    Auswählen des JSON</span
  2. Kopieren Sie die URL.
    Klicken auf URL im JSON</span
  3. Melden Sie sich auf einer neuen Registerkarte bei Ihrer ServiceNow-Entwicklerinstanz an.
  4. Auswählen REST.
    REST auswählen
  5. Klicken Sie auf Neu.
  6. Benennen Sie Ihre rest.
    Geben Sie der Nachricht einen Namen, geben Sie den Endpunkt an, und wählen Sie den Authentifizierungstyp aus.
  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.
    Wählen Sie den HTTP-Request aus, und fügen Sie X-API-TOKEN hinzu.
  10. Zum Hinzufügen doppelklicken X-API-TOKEN.
  11. Doppelklicken Sie, um Ihre API-Token.
    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.
    Klicken Sie auf Einreichen.
  15. Öffnen Sie Ihre Rest erneut.
    Öffnen der rest Meldung
  16. Klicken Sie unter HTTP-Methoden auf Neu.
    Klicken Sie auf Neu.
  17. Geben Sie der Methode einen Namen.
    Setzen der HTTP-Methode und Vergeben eines Namens
  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.
    Öffnen der POST-Methode
  22. Wählen Sie unten auf der Seite Skriptnutzung in der Vorschau anzeigen.
    Kopieren des Textes
  23. Kopieren Sie den Text.
  24. Suchen und auswählen Geschäftsregeln.
    In: servicenow. Geschäftsregeln gesucht und links ausgewählt. Teal New Knopf oben, Mitte
  25. Auswählen Neu.
  26. Wählen Sie eine Tabelle aus.
    Vitalfelder auf der Seite rot hervorgehoben
  27. Auswählen Erweitert.
  28. Legen Sie fest, wann die Geschäftsregel ausgeführt wird.
    Beispiel: Wenn Sie für Ihre Tabelle Meldung ausgewählt haben und eine CSAT für gelöste Tickets senden möchten, können Sie eine Bedingung hinzufügen, die angibt, dass diese Regel ausgeführt werden soll, wenn Vorfallsstatus Änderungen an Gelöst.
    Tipp: Qualtrics Support kann Ihnen dabei helfen, Ihr JSON einzurichten und ü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, lesen Sie die ServiceNow-Dokumentation unter wie Geschäftsregeln funktionieren.
  29. Wechseln Sie zum Erweitert Registerkarte.
    Registerkarte "Erweitert" geöffnet und JSON hervorgehoben. Schaltfläche „Senden“ unten
  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.
    Einfügen des Inhalts
  31. Fügen Sie einen Hauptteil hinzu. Hier teilen Sie die Informationen mit, die Sie an Qualtrics weiterleiten möchten.
    Hinzufügen eines Hauptteils

    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 Ziel = new GlideRecord('sys_user');Ziel('sys_id', '=', current.caller_id);Ziel(); while(Ziel ()) { body["email"] = Ziel();}
         
         
         
             
               
          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 mit dem CSAT fortzufahren, fügen wir wahrscheinlich ein XM Directory Aufgabe.
    Aufgabe „XM Directory“ auswählen
  35. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.

Beispiel: Integration mit Microsoft Dynamics über Microsoft Flow

Tipp: Dies ist getrennt von der Microsoft Aufgabe.

Das JSON sorgt dafür, dass Ereignisse in Microsoft Dynamics dann Aufgaben in Qualtrics Auslöser können, z. B. die Erstellung eines Ticket oder die Verteilung einer Umfrage. Wenn Sie beispielsweise einen Benutzerkonto in Microsoft löschen, können Sie eine Qualtrics an den Benutzerkonto verteilen, der Fragen zum Beenden stellt. (z. B., es tut uns leid, dass Sie gehen! Wie war Ihre Zeit mit uns? Wie können wir uns verbessern?)Um das JSON 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 Benutzerkonto kostenlos ausgeliefert, sodass Sie sich mit Ihren Dynamics-Informationen bei Flow anmelden können. hier.

Tipp: Qualtrics Support kann Ihnen dabei helfen, Ihr JSON einzurichten und ü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 an. Ablauf und ihre ressourcen für Dynamik.
  1. Legen Sie in Qualtrics Ereignis bis JSON .
    Auswählen des JSON</span
  2. Kopieren Sie die URL.
    Klicken auf URL im JSON</span
  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.
    Oberste linke Ecke des Microsoft-Flows, meine aus der dritten Option des linken Menüs ausgewählten Flüsse und neue Schaltfläche oben angeklickt und erweitert, um die automatische Option ab der leeren Option dritter in der Liste anzuzeigen
  5. Klicken Sie auf Neu und wählen Sie Automatisiert – von leer.
  6. Benennen Sie den Fluss.
    Erstellen Sie ein automatisiertes Flussfenster. Bild und Anweisungen nach links, Schritte, die auf der rechten Seite des Fensters beschrieben werden, gehen die Linie nach unten
  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.
    beim Löschen eines Datensatzes mit den Feldern Organisation und den Entitätsnamen direkt darunter eingezoomt. Neue Schrittdrucktaste unten, links neben der Mitte
  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.
    http und Optionen erweitert
  13. Ändern Sie die Methode bis POST.
  14. Fügen Sie Ihre JSON in das URI Feld.
  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 XM Directory Aufgabe.
    Wählen des xm directory</span
  19. Vergessen Sie nicht, veröffentlichen Ihre Umfrage ändert sich, wenn Sie bereit zum Starten sind.
Tipp: Für diese Schritte wird Microsoft Flow bevorzugt, da er weitere Informationen im JSON an Qualtrics senden kann. Wenn Sie dies in Microsoft Dynamics anstelle von Flow einrichten, werden nur Felder an Qualtrics gesendet, die während des Ereignis geändert wurden. Wenn Sie beispielsweise festlegen, dass der Auslöser werden soll und nur das Feld „E-Mail“ geändert wird, werden „Name“ und „Adresse“ nicht an Qualtrics gesendet, auch wenn Sie explizit nach diesen Feldern im Hauptteil fragen. Flow sendet alles, was Sie angefordert 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 können Sie eine Integration mit Genesys PureCloud vornehmen, um Kunden nach Abschluss einer Supporttelefon- oder Chat-Interaktion eine Umfrage zu senden.

  1. Navigieren Sie in der Umfrage, die Sie senden möchten, zu Workflows.
    Klicken Sie auf Workflow und dann Ereignis.
  2. Neuen ereignisbasierten Workflow anlegen .
  3. Wählen Sie für das Workflow die Option JSON Ereignis.
    Auswählen des JSON</span
  4. Klicken Sie auf URL kopieren um den Ereignis in Ihre Zwischenablage zu kopieren.
    Klicken Sie auf URL
  5. Öffnen Sie eine neue Registerkarte in Ihrem Browser, ohne das JSON zu schließen, und navigieren Sie zu Genesys.
  6. Navigieren Sie zu Admin.
    Zugriff auf Aktionen über die Registerkarte „Admin“
  7. Klicken Sie auf Aktionen.
  8. Klicken Sie auf Aktion hinzufügen.
    die Schaltfläche „Aktion hinzufügen“
  9. Auswählen Web-Services-Datenaktionen als Integrationsname ein.
    Geben Sie der Integration einen Namen und der Aktion einen Namen

    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.
    Auswählen von JSON und Definieren unserer Eigenschaften auf der Registerkarte „Vertragseinrichtung“
  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.Ändern Sie den Request in POST, und fügen Sie unsere url
  17. Ändern Sie den Anforderungstyp in POST.
  18. In der URL die URL aus dem JSON in Qualtrics ein.
  19. Klicken Sie auf Kopfzeile hinzufügen.
    Hinzufügen unseres API-Token als Header
  20. In der Schlüssel ein, und geben Sie Folgendes ein: X-API-TOKEN.
  21. In der Wert geben Sie Ihre Qualtrics .
  22. Wechseln Sie zum Test Registerkarte.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 sagen, ob die Aktion erfolgreich war. Wenn dies fehlgeschlagen ist, wird die Fehlerantwort angezeigt, um Sie bei der Behebung des Problems zu unterstützen.
    Erfolgsmeldung
  26. Kehren Sie zu Ihrem JSON in Qualtrics zurück, und prüfen Sie, ob Ihre Eigenschaften erfolgreich an Qualtrics übergeben wurden.Anzeigen der Test-Payload und Klicken auf Sichern
  27. Klicken Sie auf Speichern.
  28. Klicken Sie auf das Pluszeichen ( + ) und dann Aufgabe zum Einrichten der Aufgabe Sie beim Auslösen des JSON folgen möchten. In unserem Fall möchten wir eine Umfrage an die Umfrageteilnehmer senden, daher wählen wir die XM Directory .Klicken Sie auf das Pluszeichen und dann auf Aufgabe
    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.
    Veröffentlichen der Aktion
  30. Klicken Sie auf Ja.
  31. Navigieren Sie zu Admin.Architekt auf der Administrationsseite auswählen
  32. Klicken Sie auf Architekt.
  33. Auswählen Umfrage im Ablauf-Dropdown-Menü.Umfrageeinladung aus der Ablauf-Dropdown-Liste auswählen
  34. Klicken Sie auf Hinzufügen.Geben Sie dem Fluss einen Namen, eine Beschreibung und Abteilung
  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.Ziehen Sie den Titel Datenaktion aufrufen in den Ablauf.
  38. Geben Sie Ihrer Aktion eine Bezeichnung.Geben Sie der Anrufdatenaktion einen Namen, wählen Sie die Kategorie aus, und wählen Sie die Datenaktion aus, die Sie zuvor angelegt haben.
  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.Hinzufügen von Ausdrücken zu jeder Eigenschaft
  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.Hinzufügen der Aktion Umfrage abbrechen“ am Ende des Verlaufs
  44. Auswählen Toolbox, dann Umfrage, dann Umfrage abbrechen .
  45. Auswählen Opt-Out für die Disposition.Ändern der Disposition in Opt-out vor der Veröffentlichung des Flusses
  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

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.