Integration mit Gainsight

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

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:

1. Hier finden Sie Ihren Qualtrics-Benutzernamen und Ihr Qualtrics API-Token.
   Achtung! Wenn Sie bereits einen API-Token haben, erzeugen Sie keinen neuen.
2. Erstellen Sie eine Autorisierungszeichenfolge in folgendem Format: “Benutzername:APItoken”.
3. Kodieren Sie Ihre Zeichenfolge mit einem Base64-Kodierer.
4. 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.

1. Navigieren Sie in Qualtrics zur Seite Workflows.
2. Klicken Sie auf Workflow anlegen .
3. Auswählen Wird gestartet, wenn ein Ereignis empfangen wird.
4. Geben Sie Ihrem Workflow einen Namen.
5. Speichern Sie Ihren Workflow als eigenständigen Workflow.
6. Klicken Sie auf Workflow anlegen .
7. Wählen Sie das JSON-Ereignis.
8. Klicken Sie in Ihrem JSON-Ereignis auf URL kopieren. Speichern Sie diese URL für später.

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:

1. Gehen Sie zum Abschnitt Erweiterte Einstellungen des JSON-Ereignisses.
2. Klicken Sie auf Ein JSON-Feld hinzufügen.
3. Geben Sie den JSON-Feldnamen ein.
4. Definieren Sie den JSON-Pfadausdruck (für einfache Schlüssel-Wert-Paare verwenden Sie “$.[fieldName]”, z. B. “$.companyGSID”).
5. 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.

Schritt 3: Erstellen eines benutzerdefinierten Gainsight-Anschlusses

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.

1. Navigieren Sie in Gainsight zu Administration.
2. Wählen Sie Integrationen und dann Connectors 2.0.
3. Klicken Sie auf Verbindung erstellen.
4. Wählen Sie Benutzerdefinierter Anschluss.
5. Nennen Sie Ihre Verbindung.
6. Wählen Sie die Art der Autorisierung: Tokenbasiert.
7. Geben Sie das folgende Schlüssel-Wert-Paar für Header ein:
   • Schlüssel: “Autorität”
   • Wert: “Basic {{codierterBenutzername und Tokenwert von vorhin}}”
     Beispiel: Ihr Wert sieht etwa so aus
     :Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=Weitere
     Informationen finden Sie im Abschnitt HTTP BASIC AUTH auf dieser Supportseite.
8. Geben Sie eine Beschreibung für den Anschluss ein, damit Sie seinen Zweck kennen.
9. Klicken Sie auf Sichern Sie.

Schritt 4: Konfigurieren von Gainsight External Action

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.

1. Navigieren Sie in Gainsight zu Administration.
2. Wählen Sie Integrationen und dann Externe Aktionen.
3. Klicken Sie oben auf der Seite auf Aktion erstellen.
4. Wählen Sie den benutzerdefinierten Qualtrics-Anschluss, den Sie zuvor erstellt haben.
5. Geben Sie einen Namen für die Aktion ein. Dies kann später nicht mehr geändert werden.
6. Wählen Sie POST als Methode.
7. 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:

1. 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}}"
}
2. Klicken Sie oben auf der Seite auf Erstellen, um Ihre externe Aktion zu speichern.

Verbindung testen

So testen Sie die Verbindung:

1. Öffnen Sie in Qualtrics das zuvor erstellte JSON-Ereignis.
2. Klicken Sie auf Test ausführen. Sie erhalten eine Meldung, dass ein Ereignis erwartet wird.
3. Rufen Sie in Gainsight die externe Aktion auf, die Sie zuvor erstellt haben.
4. Klicken Sie oben auf der Seite auf Test .
5. Geben Sie Werte für jeden bezahlten Schlüsselwert ein, den Sie testen möchten.
6. Klicken Sie auf Aktion testen.

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

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

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.

1. Navigieren Sie in Gainsight zu Administration.
2. Wählen Sie Rules Engine.
3. 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.
4. Klicken Sie im Abschnitt “Action Setup” der Regel auf das Pluszeichen(+).
5. Klicken Sie auf dem Bildschirm “Kriterien hinzufügen” auf “Diesen Schritt überspringen “.
6. Klicken Sie auf Aktion erstellen und wählen Sie Externe API aufrufen.
7. Wählen Sie den Qualtrics-Anschluss, den Sie zuvor erstellt haben.
8. Wählen Sie die externe Aktion, die Sie zuvor erstellt haben.
9. 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.
10. Klicken Sie auf Aktionen speichern.