Salesforce Inbound Connector

Informationen zum Salesforce Inbound Connector

Sie können den Salesforce-Eingangskonnektor verwenden, um operative Reporting-Daten aus Ihrem Benutzerkonto in XM Discover zu laden.

Erforderliche Einrichtung in Salesforce

Um XM Discover mit Salesforce zu verbinden, benötigen Sie die folgenden Informationen über Ihr Benutzerkonto:

• Ihr Salesforce-Consumer-Schlüssel (Client-ID)
• Ihr Geheimer Kundenschlüssel für Salesforce (geheimer Client-Schlüssel)
• Benutzername und Kennwort für Salesforce
• URL Ihrer Organisation
• Eine gültige SOQL-Abfrage (Salesforce Object Query Language) zum Abrufen von Feedback oder Chat-Interaktionen
  Tipp: Mit SOQL können Sie die Salesforce-Daten Ihrer Organisation nach bestimmten Informationen durchsuchen. SOQL ähnelt der SELECT-Anweisung in der weit verbreiteten Structured Query Language (SQL), ist jedoch speziell für Salesforce-Daten konzipiert. Eine Einführung in SOQL finden Sie unter. Diese Salesforce-Hilfeseite.

Darüber hinaus müssen Sie in Ihrem Benutzerkonto folgende Schritte ausführen:

1. Wählen Sie in Ihrer verbundenen App OAuth-Einstellungen aktivieren. Siehe Diese Salesforce-Hilfeseite für weitere Informationen.
2. Setzen Sie das Kennzeichen URL bis: qualtrics token_type=salesforce
3. Wählen Sie Folgendes aus: OAuth-Scopes:
   • Zugriff auf benutzerdefinierte Berechtigungen (custom_authorization)
   • Zugriff auf eindeutige Benutzerkennungen (openid)
   • Vollzugriff (voll)
   • Benutzerdaten über APIs verwalten (api)
   • Anforderungen jederzeit ausführen (refresh_token, offline_access)
   • Stellen Sie sicher, dass PKCE nicht aktiviert ist.
4. Wählen Sie in derselben verbundenen Karte OAuth-Zugriffsrichtlinien verwalten. Siehe Diese Salesforce-Hilfeseite für weitere Informationen.
5. Wählen Sie folgende Optionen:
   • Zulässiger Benutzer: Alle Benutzer dürfen sich selbst autorisieren.
   • Erneuerungstoken-Richtlinie: Erneuerungstoken ist bis zum Widerruf gültig.

Einrichten eines Salesforce-Eingangsjobs

1. Klicken Sie auf der Seite Aufträge auf Neuer Job.
   
2. Wählen Sie Salesforce.
   
3. Geben Sie Ihrem Job einen Namen, damit Sie ihn identifizieren können.
   
4. Wählen Sie das Projekt aus, in das Daten geladen werden sollen.
5. Geben Sie Ihrer Stelle eine Beschreibung, damit Sie ihren Zweck kennen.
6. Klicken Sie auf Weiter.
7. Wählen Sie ein Benutzerkonto aus, das Sie verwenden möchten, oder wählen Sie Neu hinzufügen um eine neue hinzuzufügen.
8. Wenn Sie ein neues Benutzerkonto hinzufügen, geben Sie die folgenden Informationen zu Ihrem Benutzerkonto:
   • Verbindungsname: Geben Sie der Verbindung einen Namen, damit Sie sie identifizieren können.
   • Salesforce-Client-ID: Ihr Salesforce-Consumer-Schlüssel.
   • Geheimer Client-Schlüssel für Salesforce: Ihr Geheimer Kundengeheimnis für Salesforce
   • Salesforce-Umgebung: URL Ihrer Organisation
   • Testumgebung: Wenn Sie eine Verbindung zu einer Testumgebung herstellen, aktivieren Sie diese Option.
9. Klicken Sie auf Autorisieren.
10. Wenn Ihre Anmeldeinformationen ablaufen sollen, konfigurieren Sie die folgenden Optionen:
    
    • Ablaufbenachrichtigungen senden: Wählen Sie diese Option, damit Ihre Anmeldeinformationen ablaufen.
    • Tage vor Ablauf: Wenn Sie Ablaufbenachrichtigungen aktivieren, geben Sie ein, wie viele Tage Sie vor dem Ablauf benachrichtigt werden möchten. Sie können einen Wert zwischen 1 und 100 Tagen eingeben.
    • Ablaufdatum: Legen Sie das Datum fest, an dem die Anmeldeinformationen ablaufen. Klicken Sie auf das Feld, um einen Kalender zum Auswählen des Datums zu öffnen.
11. Klicken Sie auf Weiter.
12. Wählen Sie die Art des Feedback aus, das von Salesforce hochgeladen werden soll:
    
    • Feedback: Regelmäßiges Feedback hochladen.
    • Salesforce-Chat: Agent-/Client-Interaktionen aus Salesforce Chat hochladen.
    • Salesforce-SMS-Textt: Agenten-/Client-Interaktionen aus Salesforce LiveMessage hochladen.
13. Beim Hochladen Salesforce-ChatWählen Sie aus, wie Agents und Clients identifiziert werden:
    • Automatische Erkennung: Automatische Erkennung von Agents, Chat-Assistenten und Besuchern.
    • Der erste Teilnehmer:in ist ein Agent.: Der erste Teilnehmer:in wird als Agent zugeordnet.
    • Der erste Teilnehmer:in ist ein Mandant.: Der zweite Teilnehmer:in wird als Agent zugeordnet.
14. Wählen Sie die API möchten Sie verwenden.
15. Geben Sie eine Benutzerdefinierte SOQL-Anweisung um die von Salesforce abgerufenen Daten einzuschränken.
    
    Tipp: Um Chat-Daten abzurufen, verwenden Sie das Objekt LiveChatTranscript in der Abfrage.
    Achtung: GROUP BY wird nicht unterstützt.
    Beispiel: SELECT-ID, CreatedDate, Body, ChatDuration FROM LiveChatTranscript
16. Klicken Sie auf Validieren Abfrage um Ihre SOQL-Anweisung zu testen.
17. Wenn die Validierung erfolgreich war, wählen Sie Datumsfeld , um die abzurufenden Daten zu identifizieren.
    Tipp: Diese Liste enthält nur Felder, die in Ihrer SOQL-Abfrage vorhanden sind.
18. Klicken Sie auf Weiter
19. Passen Sie bei Bedarf Ihre Datenzuordnungen an. Detaillierte Informationen zur Zuordnung von Feldern in XM Discover finden Sie auf der Supportseite Datenzuordnung. Die Abschnitt Standarddatenzuordnung enthält Informationen zu den für diesen Konnektor spezifischen Feldern und der Zuordnen von Dialogfeldern Im Abschnitt wird beschrieben, wie Daten für dialogorientierte Daten zugeordnet werden.
    
20. Klicken Sie auf Weiter.
21. Bei Bedarf können Sie Regeln für die Ersetzung und Unkenntlichmachung von Daten hinzufügen, um sensible Daten auszublenden oder bestimmte Wörter und Phrasen in Kundenfeedback und Interaktionen automatisch zu ersetzen. Siehe Supportseite für Datenersetzung und -redundanz.
    Tipp: Klicken Sie auf Stichprobe herunterladen , um eine Excel-Datei mit Stichprobe auf Ihren Computer herunterzuladen.
22. Klicken Sie auf Weiter.
23. Bei Bedarf können Sie einen Konnektorfilter hinzufügen, um die eingehenden Daten zu filtern und so einzuschränken, welche Daten importiert werden.
    
24. Sie können auch die Anzahl der in einem einzelnen Job importierten Datensätze begrenzen, indem Sie eine Zahl in das Feld Datensatzlimit angeben eingeben. Geben Sie „Alle“ ein, wenn Sie alle Datensätze importieren möchten.
    Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
25. Klicken Sie auf Weiter.
26. Wählen Sie aus, wann Sie benachrichtigt werden möchten. Weitere Informationen finden Sie unter Jobbenachrichtigungen.
    
27. Klicken Sie auf Weiter.
28. Wählen Sie aus, wie doppelte Belege behandelt werden sollen. Weitere Informationen finden Sie unter Behandlung von Duplikaten.
    
29. Wählen Sie Inkrementelle Läufe einplanen, wenn Ihr Job periodisch nach einem Zeitplan ausgeführt werden soll, oder Einmaligen Pull einrichten, wenn der Job nur einmal ausgeführt werden soll. Weitere Informationen finden Sie unter Jobeinplanung.
30. Klicken Sie auf Weiter.
31. Überprüfen Sie Ihre Einrichtung. Wenn Sie eine bestimmte Einstellung ändern müssen, klicken Sie auf die Schaltfläche Bearbeiten, um zu diesem Schritt in der Verbindungseinrichtung zu gelangen.
32. Wählen Sie Fertigstellen, um den Job zu sichern.

Standarddatenzuordnung

Dieser Abschnitt enthält Informationen zu den Standardfeldern für Salesforce-Eingangsjobs.

• natural_id: Ein eindeutiger Identifikator eines Dokuments. Es wird dringend empfohlen, für jedes Dokument eine eindeutige ID zu haben, um Dubletten korrekt zu verarbeiten. Für Natürliche ID können Sie einen beliebigen Text oder ein beliebiges numerisches Feld aus Ihren Daten auswählen. Alternativ können Sie IDs automatisch generieren, indem Sie ein benutzerdefiniertes Feld hinzufügen.
• document_date: Das primäre Datumsfeld, das mit einem Dokument verknüpft ist. Dieses Datum wird in XM-Discover-Berichten, Trends, Warnungen usw. verwendet. Standardmäßig wird dies dem Datumsfeld zugeordnet, das nach der Angabe der SOQL-Abfrage ausgewählt wurde. Sie können eine der folgenden Optionen wählen:
  • CreatedDate (Standard): Das Datum, an dem das Salesforce-Objekt erstellt wurde.
  • ClosedDate (für Chat-Daten): Das Datum, an dem der Fall geschlossen wurde.
  • Wenn Ihre Quelldaten andere Datumsfelder enthalten, können Sie eines davon auswählen.
  • Sie können auch ein bestimmtes Belegdatum festlegen.
• feedback_provider: Identifiziert Daten, die von einem bestimmten Provider abgerufen wurden. Für Salesforce-Uploads ist der Wert dieses Attribut auf „Salesforce“ gesetzt und kann nicht geändert werden.
• source_value: Identifiziert Daten, die aus einer bestimmten Quelle abgerufen wurden. Dies kann alles sein, das die Herkunft der Daten beschreibt, z.B. der Name einer Umfrage oder einer mobilen Marketingkampagne. Standardmäßig ist der Wert dieses Attribut auf „Salesforce“ gesetzt. Verwenden Sie benutzerdefinierte Transformationen, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• feedback_type: Identifiziert Daten anhand ihres Typs. Dies ist hilfreich für das Reporting, wenn Ihr Projekt verschiedene Arten von Daten enthält (z.B. Umfragen und Social-Media-Feedback). Standardmäßig ist der Wert dieses Attribut auf „Operatives Reporting“ gesetzt. Verwenden Sie benutzerdefinierte Transformationen, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• job_name: Identifiziert Daten basierend auf dem Namen des Jobs, der zum Hochladen verwendet wird. Sie können den Wert dieses Attributs während der Einrichtung über das Feld Jobname ändern, das oben auf jeder Seite während der Einrichtung angezeigt wird.
• loadDate: Gibt an, wann ein Dokument in XM Discover hochgeladen wurde. Dieses Feld wird automatisch gesetzt und kann nicht geändert werden.