Integration mit Gainsight

Suite
Customer Experience Employee Experience Strategy & Research
Produkt
Qualtrics
Was finden Sie hier?

Über die Integration mit Gainsight

Gainsight ist eine Plattform für Customer success, die das Engagement der Kunden erhöht, die Kundenbindung verbessert und die Expansion vorantreibt.

Sie können Ihr Benutzerkonto in Qualtrics mit Gainsight integrieren, um Daten zwischen den Plattformen zu übertragen und einen Qualtrics Workflow auf der Grundlage von Ereignissen in Gainsight auszulösen. Wenn ein Kunde beispielsweise eine KUNDENERFAHRUNG abschließt, die in Gainsight verfolgt wird, können Sie ihm über Qualtrics eine UMFRAGE schicken, in der Sie ihn nach seinen Erfahrungen beim Onboarding fragen.

Achtung: Kundeneigene Quelltextfunktionen werden unverändert bereitgestellt und erfordern Programmierkenntnisse zur Implementierung. Der Qualtrics Support bietet keinerlei Hilfestellung oder Beratung im Zusammenhang mit eigenem Programmcode an. Sie können immer versuchen, unsere Community mit dedizierten Benutzern. Wenn Sie mehr über unsere Services für kundenspezifisches Coding erfahren möchten, Kontakt Ihren Qualtrics Benutzerkonto Executive.

Schritt 1: Erstellen eines Authentifizierer-Kopfes

Um die Verbindung mit Gainsight einzurichten, benötigen Sie einen grundlegenden Authentifizierer-Header. Dieser Header ist eine Base64-kodierte Zeichenkette, die Ihren Qualtrics-Benutzernamen und Ihr API-Token enthält, getrennt durch einen Doppelpunkt. So erstellen Sie die Kopfzeile:

Hier finden Sie Ihren Qualtrics-Benutzernamen und Ihr Qualtrics API-Token.
Achtung!: Wenn Sie bereits einen API-Token haben, erzeugen Sie keinen neuen.
Erstellen Sie eine Autorisierungszeichenfolge in folgendem Format: “Benutzername:APItoken”.
Kodieren Sie Ihre Zeichenfolge mit einem Base64-Kodierer.
Speichern Sie diesen Schlüssel für später.

Schritt 2: Einrichten eines JSON-Ereignisses

WEITER erstellen Sie einen neuen Qualtrics Workflow, um die von Gainsight gesendeten Daten zu empfangen. Dieser Workflow kann als reiner Auslöser verwendet werden, oder er kann auch Daten aufnehmen, die in späteren Workflow-Schritten nützlich sein können.

Navigieren Sie in Qualtrics zur Seite Workflows.
Auf der Registerkarte Workflows einen neuen Workflow erstellen
Auf der Registerkarte Workflows einen neuen Workflow erstellen
Klicken Sie auf Workflow anlegen .
Auswählen Wird gestartet, wenn ein Ereignis empfangen wird.
Geben Sie Ihrem Workflow einen Namen.
speichern des Workflows als eigenständigen Workflow
speichern des Workflows als eigenständigen Workflow
Speichern Sie Ihren Workflow als eigenständigen Workflow.
Klicken Sie auf Workflow anlegen .
Wählen Sie das JSON-Ereignis.
auswahl des json ereignisses
auswahl des json ereignisses
Klicken Sie in Ihrem JSON-Ereignis auf URL kopieren. Speichern Sie diese URL für später.
Klicken Sie auf „url
Klicken Sie auf „url

An dieser Stelle kann das in den obigen Schritten erstellte JSON-Ereignis verwendet werden, um die Integration einzurichten und andere Aufgaben im Workflow auszulösen. Wenn Sie Ihren Workflow einfach nur starten wollen, können Sie die weiteren Schritte überspringen und das JSON-Ereignis speichern. Wenn Sie jedoch zusätzliche Daten von Gainsight an Qualtrics weitergeben möchten (z. B. “Company GSID” oder “Renewal Date”), müssen Sie diese Felder in das JSON-Ereignis aufnehmen:

Gehen Sie zum Abschnitt Erweiterte Einstellungen des JSON-Ereignisses.
zuordnung von JSON-Feldern im Abschnitt "Erweiterte Einstellungen" des Ereignisses "JSON
zuordnung von JSON-Feldern im Abschnitt "Erweiterte Einstellungen" des Ereignisses "JSON
Klicken Sie auf Ein JSON-Feld hinzufügen.
Geben Sie den JSON-Feldnamen ein.
Definieren Sie den JSON-Pfadausdruck (für einfache Schlüssel-Wert-Paare verwenden Sie “$.[fieldName]”, z. B. “$.companyGSID”).
Klicken Sie auf Speichern.

Diese JSON-Felder stehen nun in nachfolgenden Aufgaben des Workflows als “Ereignisdaten: Benutzerdefiniertes Feld”. Sie können über das Menü DYNAMISCHER TEXT, {a}, aufgerufen werden.

das Menü DYNAMISCHER TEXT mit Json-Feldern
das Menü DYNAMISCHER TEXT mit Json-Feldern

Schritt 3: Erstellen eines benutzerdefinierten Gainsight-Anschlusses

TIPP: Einmal hinzugefügte benutzerdefinierte Anschlüsse können nicht mehr gelöscht werden. It wird empfohlen, die Tests in einer Sandbox durchzuführen, insbesondere wenn Sie die API-Funktionen von Gainsight zum ersten Mal nutzen. Sie müssen Superadministrator in Gainsight sein, um die Schritte in diesem Abschnitt ausführen zu können.

WEITER müssen Sie einen neuen benutzerdefinierten Connector in Gainsight erstellen, um eine Verbindung zu Qualtrics herzustellen. Dieser Konnektor speichert Ihr Authentifizierer-Token von vorhin und wird verwendet, um Daten über externe Aktionen in Gainsight an Qualtrics zu senden.

Sie benötigen nur 1 Anschluss für Qualtrics. Wenn bereits ein benutzerdefinierter Anschluss für Qualtrics vorhanden ist, fahren Sie mit dem nächsten Abschnitt über die Konfiguration einer externen Aktion in Gainsight fort.

Navigieren Sie in Gainsight zu Administration.
navigieren zur Administration in Gainsight
navigieren zur Administration in Gainsight
Wählen Sie Integrationen und dann Connectors 2.0.
umstellung auf Anschlüsse 2.0 in Gainsight
umstellung auf Anschlüsse 2.0 in Gainsight
Klicken Sie auf Verbindung erstellen.
einrichten einer neuen Verbindung
einrichten einer neuen Verbindung
Wählen Sie Benutzerdefinierter Anschluss.
einrichtung des benutzerdefinierten qualtrics-anschlusses
einrichtung des benutzerdefinierten qualtrics-anschlusses
Nennen Sie Ihre Verbindung.
Wählen Sie die Art der Autorisierung: Tokenbasiert.
Geben Sie das folgende Schlüssel-Wert-Paar für Header ein:
Geben Sie eine Beschreibung für den Anschluss ein, damit Sie seinen Zweck kennen.
Klicken Sie auf Sichern Sie.

Schritt 4: Konfigurieren von Gainsight External Action

TIPP: Einmal hinzugefügte externe Aktionen können in der Regel nicht mehr gelöscht werden. It wird empfohlen, die Tests in einer Sandbox durchzuführen, insbesondere wenn Sie die API-Funktionen von Gainsight zum ersten Mal nutzen. Sie müssen Superadministrator in Gainsight sein, um die Schritte in diesem Abschnitt ausführen zu können.

Nach der Erstellung des benutzerdefinierten Connectors können Sie eine externe Aktion in Gainsight konfigurieren, um eine Anfrage an Ihr Qualtrics JSON-Ereignis zu senden. Wenn Sie mehrere Workflows erstellen möchten, die von Gainsight ausgelöst werden, müssen Sie für jeden Workflow eine eigene externe Aktion erstellen.

Denken Sie daran, dass Sie für Qualtrics immer nur 1 Anschluss benötigen. Alle externen Aktionen, die zur Interaktion mit Qualtrics verwendet werden, sollten unter demselben benutzerdefinierten Qualtrics-Konnektor liegen.

Navigieren Sie in Gainsight zu Administration.
navigieren zur Administration in Gainsight
navigieren zur Administration in Gainsight
Wählen Sie Integrationen und dann Externe Aktionen.
navigation zu externen Maßnahmen in Gainsight
navigation zu externen Maßnahmen in Gainsight
Klicken Sie oben auf der Seite auf Aktion erstellen.
Wählen Sie den benutzerdefinierten Qualtrics-Anschluss, den Sie zuvor erstellt haben.
einrichtung des externen aktionssatzes
einrichtung des externen aktionssatzes
Geben Sie einen Namen für die Aktion ein. Dies kann später nicht mehr geändert werden.
Wählen Sie POST als Methode.
Fügen Sie die JSON-URL des Ereignisses , die Sie zuvor kopiert haben, in das URL-Feld der neuen externen Aktion ein.

Weiter müssen Sie die Nutzlast Ihrer Anfrage konfigurieren. Wenn Sie diese externe Gainsight-Aktion nur als Auslöser verwenden und keine zusätzlichen Daten senden möchten, müssen Sie lediglich vor dem Speichern eine öffnende und schließende geschweifte Klammer an die Nutzlast anfügen, z. B. { }. Andernfalls, wenn Sie zusätzliche Daten von Gainsight an Qualtrics senden möchten, müssen Sie der Nutzlast Schlüssel-Wert-Paare hinzufügen:

hinzufügen einer JSON-Nutzlast zur externen Aktion
hinzufügen einer JSON-Nutzlast zur externen Aktion
Geben Sie für jedes Feld, das Sie an Qualtrics senden möchten, ein Schlüssel-Wert-Paar ein.
    • Jeder Schlüssel sollte genau mit dem JSON-Feldnamen aus dem JSON-Ereignis in Qualtrics übereinstimmen.
    • Jeder Wert kann als statischer Wert konfiguriert oder mit Token versehen werden, um Eingaben aus anderen Bereichen in Gainsight wie der Rules Engine zu akzeptieren.
    • Jedes Schlüssel-Wert-Paar sollte durch ein Komma vom weiteren getrennt werden.
      Beispiel: Nachfolgend sehen Sie die JSON-Nutzdaten für die Felder, die wir zuvor konfiguriert haben. Beide Schlüssel-Wert-Paare in diesem Beispiel akzeptieren geparste Werte, die von einer Rules Engine Action eingegeben werden
      .{

      "companyGSID" : "{{Company_GSID}}",

      "recipientEmailAddress" : "{{Recipient_Email}}"

       }
Klicken Sie oben auf der Seite auf Erstellen, um Ihre externe Aktion zu speichern.

Verbindung testen

So testen Sie die Verbindung:

Öffnen Sie in Qualtrics das zuvor erstellte JSON-Ereignis.
Klicken Sie auf Test ausführen. Sie erhalten eine Meldung, dass ein Ereignis erwartet wird.
klicken Sie auf den Testlauf im Ereignis Json
klicken Sie auf den Testlauf im Ereignis Json
Rufen Sie in Gainsight die externe Aktion auf, die Sie zuvor erstellt haben.
Klicken Sie oben auf der Seite auf Test .
klick-Test auf die externe Aktion gainsight
klick-Test auf die externe Aktion gainsight
Geben Sie Werte für jeden bezahlten Schlüsselwert ein, den Sie testen möchten.
hinzufügen von Beispielwerten und Testen
hinzufügen von Beispielwerten und Testen
Klicken Sie auf Aktion testen.

Ein erfolgreicher Test liefert den Statuscode 202, eventId und requestId.

eine erfolgreiche Testmeldung in Gainsight
eine erfolgreiche Testmeldung in Gainsight

Die Schlüssel-Wert-Paare des Tests werden auch in Qualtrics unter “JSON captured from most recent test” angezeigt.

eine erfolgreiche Testmeldung in QUALTRICS
eine erfolgreiche Testmeldung in QUALTRICS

Schritt 5: Verwendung von Gainsight External Actions in der Rules Engine

Um Ihre neu konfigurierte externe Aktion zu verwenden, müssen Sie dieAktion“Call External API” innerhalb der Rules Engine verwenden. Jede Zeile, die an diese Aktion übermittelt wird, wird unabhängig ausgeführt. Ein Datensatz mit 100 Datensätzen, der die Aktion Externe API aufrufen verwendet, führt also zu 100 separaten API-Aufrufen.

Navigieren Sie in Gainsight zu Administration.
navigieren zur Administration in Gainsight
navigieren zur Administration in Gainsight
Wählen Sie Rules Engine.
hinzufügen einer neuen Regel in der Regelmaschine
hinzufügen einer neuen Regel in der Regelmaschine
Erstellen Sie eine Regel, die die Daten enthält, die Sie an Qualtrics senden möchten. Diese Felder, aus denen der Datensatz besteht, sind für Ihren Anwendungsfall einzigartig.
hinzufügen von Datenfeldern für die Regel
hinzufügen von Datenfeldern für die Regel
Klicken Sie im Abschnitt “Action Setup” der Regel auf das Pluszeichen(+).
hinzufügen einer Aktion zur Regel
hinzufügen einer Aktion zur Regel
Klicken Sie auf dem Bildschirm “Kriterien hinzufügen” auf “Diesen Schritt überspringen “.
überspringen dieses Schrittes
überspringen dieses Schrittes
Klicken Sie auf Aktion erstellen und wählen Sie Externe API aufrufen.
hinzufügen eines externen api-Aufrufs für die Aktion
hinzufügen eines externen api-Aufrufs für die Aktion
Wählen Sie den Qualtrics-Anschluss, den Sie zuvor erstellt haben.
auswahl der Datenfelder Verbindung, Aktion und Mapping
auswahl der Datenfelder Verbindung, Aktion und Mapping
Wählen Sie die externe Aktion, die Sie zuvor erstellt haben.
Ordnen Sie Ihre Quellfeldwerte (aus dem Regeldatensatz) den Aktionsfeldschlüsseln (aus der JSON-Nutzlast) zu.
TIPP: Sie können einen statischen Wert als Quellfeld festlegen, anstatt ein Feld aus dem Dataset zuzuordnen.
ein Feld als statischen Wert abbilden
ein Feld als statischen Wert abbilden
Klicken Sie auf Aktionen speichern.
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.

Hat Ihnen das weitergeholfen?

Das von Ihnen eingereichte Feedback, dient lediglich dazu, diese Seite zu verbessern.

Großartig! Vielen Dank für die Rückmeldung!

Vielen Dank für die Rückmeldung!