Twilio Segment-Ereignis

Informationen zu Twilio-Segmentereignissen

Mit dem Ereignis „Twilio Segment“ können Sie Qualtrics mit Twilio Segment integrieren, um Daten basierend auf Ereignissen im Twilio-Segment an Qualtrics zu senden. Das Ereignis „Twilio Segment“ unterstützt drei Hauptanwendungsfälle:

1. Starten eines Workflows basierend auf Datenereignissen im Twilio-Segment.
2. Aktualisieren von Kontaktinformationen in XM Directory basierend auf Ereignissen im Twilio-Segment.
3. Hinzufügen von Transaktionsdaten zu einem Kontakt basierend auf Ereignissen im Twilio-Segment.

Einrichten eines Twilio-Segmentereignisses

Um das Twilio-Segment-Ereignis verwenden zu können, müssen Sie sowohl im Twilio-Segment als auch in Qualtrics eine Einrichtung vornehmen. Sie müssen Qualtrics als Webhook-Destination in Ihrer Twilio-Segment-Instanz hinzufügen. In diesem Abschnitt wird das Einrichten der ersten Integration mit dem Twilio-Segment behandelt.

Zum Einrichten der Verbindung benötigen Sie die folgenden Qualtrics-IDs:

• Ihr API-Token (wenn Sie bereits ein Token haben, generieren Sie kein neues Token)
• Ihre Rechenzentrums-ID
• Beim Hinzufügen oder Aktualisieren von Kontakten in XM Directory die Verzeichnis-ID des Verzeichnisses, in dem Ihre Kontakte gesichert werden sollen.

Verbindung zum Twilio-Segment wird hergestellt

1. Klicken Sie auf der Registerkarte Workflows auf Workflow erstellen.
   
2. Wählen Sie Gestartet, wenn ein Ereignis empfangen wird.
3. Wählen Sie das Ereignis Twilio Segment aus.
   
4. Melden Sie sich auf einer separaten Browserregisterkarte bei Twilio Segment an. Schließen Sie Qualtrics nicht.
5. Wechseln Sie zur Registerkarte Verbindungen.
   
6. Klicken Sie auf Ziel hinzufügen.
7. Suchen Sie nach der Qualtrics-Verbindung, und fügen Sie sie Ihrem Arbeitsbereich hinzu. Klicken Sie darauf, um mit dem Einrichten der Verbindung zu beginnen.
8. Geben Sie der Verbindung einen Namen. Dieser Name ist für eigene organisatorische Zwecke vorgesehen.
9. Geben Sie Ihr Qualtrics-API-Token ein. Siehe API-Token generieren, wenn Sie Hilfe bei der Suche nach Ihrem Token benötigen.
10. Geben Sie Ihre Qualtrics-Rechenzentrums-ID ein. Weitere Informationen zum Auffinden des Rechenzentrums finden Sie unter Suchen der Rechenzentrums-ID.
11. Stellen Sie sicher, dass Destination aktivieren aktiviert ist.
12. Klicken Sie auf Änderungen sichern.
13. Klicken Sie auf der Registerkarte Zuordnungen auf Neue Zuordnung.
14. Wählen Sie aus, was Sie tun möchten:
    
    • Kontakt in XM Directory anlegen und/oder aktualisieren: Fügen Sie einen Kontakt in XM Directory basierend auf Datenereignissen im Twilio-Segment hinzu, oder aktualisieren Sie ihn. Alle Kontakte, die von diesem Ereignis verarbeitet werden, werden entsprechend den Einstellungen Ihres Verzeichnisses dedupliziert. Weitere Informationen zur Einrichtung dieser Option finden Sie unter Hinzufügen oder Aktualisieren von Kontakten in XM Directory.
    • Upsert-Kontakttransaktion: Transaktionsdaten zu einem Kontakt hinzufügen. Wenn der Ansprechpartner nicht vorhanden ist, wird er angelegt. Anschließend werden diesem Ansprechpartner Vorgangsdaten hinzugefügt. Weitere Informationen zur Einrichtung dieser Option finden Sie unter Hinzufügen von Transaktionen zu Kontakten.
    • Workflow in Qualtrics starten: Starten Sie einen Qualtrics-Workflow basierend auf Datenereignissen im Twilio-Segment. Weitere Informationen zur Einrichtung dieser Option finden Sie unter Qualtrics-Workflow auslösen.
      Tipp: Sie können alle diese Optionen nutzen, wenn Sie möchten! Sie müssen lediglich zusätzliche Zuordnungen anlegen, nachdem Sie die erste eingerichtet haben.

Hinzufügen oder Aktualisieren von Kontakten in XM Directory

Mit dem Ereignis „Twilio Segment“ können Sie Kontakte in XM Directory basierend auf Änderungen an Ihren Daten im Twilio-Segment aktualisieren.

1. Folgen Sie den Anweisungen unter Setting up a Twilio Segment Event, um Qualtrics mit Twilio Segment zu integrieren. Wählen Sie beim Einrichten der Integration die Option Kontakt in XM Directory anlegen und/oder aktualisieren.
2. Fügen Sie beliebige Filterbedingungen hinzu. Diese Bedingungen bestimmen, wann Daten an Qualtrics gesendet werden.
   
   Tipp: Standardmäßig enthält diese Integration automatisch eine Bedingung für „Ereignistyp“ ist „Identifizieren“. Sie können diesen Filter nach Bedarf ändern oder neue hinzufügen. Wir empfehlen Ihnen, mindestens einen Filter einzuschließen, um die Daten einzuschränken, die an Qualtrics gesendet werden.
3. Verwenden Sie bei Bedarf den Abschnitt Testereignis hinzufügen, um zu testen, welche Felder in Ihren Zuordnungen enthalten sein können.
4. Ordnen Sie im Abschnitt Zuordnungen auswählen Ihre Qualtrics-Verzeichnis-ID zu. Wenn Sie mehrere Verzeichnisse haben, wählen Sie das Verzeichnis aus, dem Sie Kontakte hinzufügen möchten. Weitere Informationen finden Sie unter Ermitteln der Pool-ID. 
5. Passen Sie bei Bedarf die Ereignisfeldzuordnungen an. Weitere Informationen finden Sie auf dieser Twilio-Support-Seite. Häufig müssen Sie keine Anpassungen an den vorkonfigurierten Zuordnungen vornehmen.
6. Klicken Sie auf Speichern.

Hinzufügen von Vorgängen zu Ansprechpartnern

Mit dem Ereignis „Twilio Segment“ können Sie Transaktionsdaten zu vorhandenen Kontakten in Ihrem XM Directory hinzufügen. Wenn der Kontakt noch nicht in Ihrem Verzeichnis vorhanden ist, wird er angelegt. Die Vorgangsdaten werden im neu angelegten Ansprechpartner gesichert.

1. Folgen Sie den Anweisungen unter Setting up a Twilio Segment Event, um Qualtrics mit Twilio Segment zu integrieren. Wählen Sie beim Einrichten der Integration die Option Upsert-Kontakttransaktion.
2. Fügen Sie beliebige Filterbedingungen hinzu. Diese Bedingungen bestimmen, wann Daten an Qualtrics gesendet werden.
   Tipp: Standardmäßig enthält diese Integration automatisch eine Bedingung für „Ereignisart“ ist „Verfolgen“ und „Ereignisname“ ist „Vorgang angelegt“. Sie können diesen Filter nach Bedarf ändern oder neue hinzufügen. Wir empfehlen Ihnen, mindestens einen Filter einzuschließen, um die Daten einzuschränken, die an Qualtrics gesendet werden.
3. Verwenden Sie bei Bedarf den Abschnitt Testereignis hinzufügen, um zu testen, welche Felder in Ihren Zuordnungen enthalten sein können.
4. Ordnen Sie im Abschnitt Zuordnungen auswählen Ihre Qualtrics-Verzeichnis-ID zu. Wenn Sie mehrere Verzeichnisse haben, wählen Sie das Verzeichnis aus, dem Sie Kontakte hinzufügen möchten. Weitere Informationen finden Sie unter Ermitteln der Pool-ID.
5. Passen Sie bei Bedarf die Ereignisfeldzuordnungen an (z.B. wenn Sie zusätzliche Felder an Qualtrics übergeben möchten). Weitere Informationen finden Sie auf dieser Twilio-Support-Seite. Häufig müssen Sie keine Anpassungen an den vorkonfigurierten Zuordnungen vornehmen.
6. Klicken Sie auf Speichern.

Auslösen eines Qualtrics-Workflows

Mit dem Ereignis „Twilio Segment“ können Sie einen Workflow in Qualtrics basierend auf Datenereignissen im Twilio-Segment starten.

1. Folgen Sie den Anweisungen unter Setting up a Twilio Segment Event, um Qualtrics mit Twilio Segment zu integrieren. Wählen Sie beim Einrichten der Integration die Option Workflow in Qualtrics starten.
2. Fügen Sie beliebige Filterbedingungen hinzu. Diese Bedingungen bestimmen, wann Daten an Qualtrics gesendet werden.
   
   Tipp: Wir empfehlen Ihnen, mindestens einen Filter einzufügen, um die Daten einzuschränken, die an Qualtrics gesendet werden.
3. Verwenden Sie den Abschnitt Testereignis hinzufügen, um eine Testfeldzuordnung zu generieren.
   Tipp: Sie benötigen mindestens eine Filterbedingung, um ein Testereignis zu generieren.
4. Kehren Sie in Qualtrics zum Twilio-Segment-Ereignis zurück. Klicken Sie auf URL kopieren.
5. Kehren Sie zum Twilio-Segment zurück. Fügen Sie im Abschnitt Zuordnungen auswählen Ihre kopierte URL in das HTTP-API-Feld ein, um sie Ihrer Workflow-URL zuzuordnen.
6. Passen Sie bei Bedarf die Zuordnungen für die Felder an, die Sie an Qualtrics übergeben möchten. Geben Sie in der linken Spalte den Namen des Felds so ein, wie es in Qualtrics angezeigt werden soll.
7. Wählen Sie in der rechten Spalte die Ereignisvariable aus, die Sie an Qualtrics übergeben möchten, indem Sie auf das Feld klicken und ein Feld auswählen.
8. Aktivieren Sie Testdatensatzvorschau anzeigen.
   Tipp: Sie können diese Option nicht aktivieren, wenn Sie zuvor keine Testzuordnung generiert haben. Blättern Sie nach oben zum Abschnitt Testereignis hinzufügen, um die Testzuordnung zu generieren.
9. Markieren Sie die JSON-Ereignis-Payload, und kopieren Sie sie.
10. Klicken Sie auf Speichern.
11. Kehren Sie zum Twilio-Segment-Ereignis in Qualtrics zurück. Navigieren Sie zum Abschnitt Erweiterte Einstellungen.
12. Fügen Sie die zuvor kopierte JSON-Ereignis-Payload in das JSON-Objektfeld ein.
13. Klicken Sie auf Feldzuordnung hinzufügen. Ihre Felder werden basierend auf der JSON-Payload automatisch für Sie zugeordnet.
14. Navigieren Sie zum Abschnitt Felder zuordnen, und prüfen Sie, ob Ihre Felder korrekt zugeordnet sind. Sie können Ihre Felder nach Bedarf anpassen.
15. Geben Sie im Feld Pfad die Pfadnamen aus dem Twilio-Segment für die Felder ein, die Sie in Qualtrics speichern möchten.
16. Wählen Sie als Typ den Datentyp aus, den das Feld enthält:
    • String: Die Daten sind eine Textzeichenfolge.
    • Zahl: Die Daten sind ein numerischer Wert.
    • Boolesch: Die Daten sind ein boolescher Wert (d.h. wahr oder falsch).
17. Klicken Sie auf Feld hinzufügen, um zusätzliche Felder zuzuordnen.
18. Klicken Sie auf das Minuszeichen ( – ), um ein Feld aus Ihrer Zuordnung zu entfernen.
19. Bei Bedarf können Sie die Integration testen, um zu prüfen, ob die richtigen Daten an Qualtrics übergeben wurden, indem Sie auf Testdaten ausführen klicken und dann ein Ereignis aus dem Twilio-Segment auslösen. Weitere Informationen finden Sie unter Ereignisdaten erfassen.
    Tipp: Weitere Informationen zur Interpretation von JSON finden Sie unter JSONPath-Syntax.
20. Klicken Sie auf Speichern.
21. Vergessen Sie nicht, Ihrem Workflow eine Aufgabe hinzuzufügen. In der Regel ist dies eine XM-Directory-Aufgabe zum Verteilen einer Umfrage.
    Tipp: Wenn Sie Kontaktinformationen sichern oder aktualisieren möchten, finden Sie weitere Informationen unter Hinzufügen oder Aktualisieren von Kontakten in XM Directory.
    Beispiel: Angenommen, ein Kunde schließt seine neue Benutzer-Onboarding-Tour ab, die seinen Datensatz im Twilio-Segment aktualisiert. Diese Datenänderung kann dann einen Qualtrics-Workflow auslösen, mit dem wir eine Umfrage an den Kunden verteilen und ihn bitten können, Feedback zu seiner Onboarding-Erfahrung zu geben.