Artikelvorlage

Informationen zum Salesforce-Eingangskonnektor

Sie können den Salesforce-Eingangskonnektor verwenden, um operative Berichtsdaten 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 zu Ihrem Benutzerkonto:

• Ihr Salesforce-Kundenschlüssel (Client-ID)
• Ihr geheimer Salesforce-Kundenschlüssel (geheimer Client-Schlüssel)
• Ihr Salesforce-Benutzername und -Kennwort
• Die URL Ihrer Organisation
• Eine gültige Salesforce-Object-Query-Language-Abfrage (SOQL-Abfrage) 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 Folgendes tun:

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=Vertriebsmitarbeiter
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)
   • Anfragen jederzeit ausführen (refresh_token, offline_access)
   • Stellen Sie sicher, dass PKCE nicht aktiviert ist.
4. Wählen Sie auf 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 können sich selbst autorisieren.
   • Token-Richtlinie aktualisieren: Erneuerungstoken ist gültig, bis er widerrufen wird.

Salesforce-Eingangsauftrag einrichten

1. Klicken Sie auf der Seite Jobs auf Neuer Job.
   
2. Auswählen Salesforce.
   
3. Geben Sie Ihrem Job einen Namen, damit Sie ihn identifizieren können.
   
4. Wählen Sie das Projekt aus, in das die 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 zu verwendendes Benutzerkonto aus, 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-Kundenschlüssel.
   • Geheimer Salesforce-Client-Schlüssel: Ihr Salesforce-Kundengeheimnis
   • Salesforce-Umgebung: Die 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 an, wie viele Tage vor dem Ablauf benachrichtigt werden sollen. 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 zu öffnen und das Datum auszuwählen.
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: Laden Sie Agent-/Client-Interaktionen aus dem Salesforce-Chat hoch.
    • Salesforce-SMS-Textt: Agent-/Client-Interaktionen aus Salesforce LiveMessage hochladen.
13. Beim Hochladen Salesforce-ChatWählen Sie aus, wie Agents und Clients identifiziert werden:
    • Automatische Erkennung: Agents, Chat-Assistenten und Besucher automatisch ermitteln.
    • 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 die Sie verwenden möchten.
15. Geben Sie ein Benutzerdefinierte SOQL-Anweisung um die aus Salesforce abgerufenen Daten einzuschränken.
    
    Tipp: Um Chat-Daten abzurufen, verwenden Sie das LiveChatTranscript-Objekt 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 die Datumsfeld wird verwendet, um abzurufende 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. Siehe Supportseite für die Datenzuordnung für detaillierte Informationen zu Zuordnungsfeldern in XM Discover. Die Abschnitt Standarddatenzuordnung enthält Informationen zu den Feldern, die für diesen Konnektor spezifisch sind, und Konversationsfelder zuordnen Im Abschnitt wird erläutert, wie Daten für dialogorientierte Daten zugeordnet werden.
    
20. Klicken Sie auf Weiter.
21. Bei Bedarf können Sie Folgendes hinzufügen: Regeln für Datensubstitution und Unkenntlichmachung um sensible Daten auszublenden oder bestimmte Wörter und Phrasen in Feedback und -interaktionen automatisch zu ersetzen. Siehe Supportseite für Datenersetzung und Redaktion.
    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 eine Konnektorfilter um die eingehenden Daten zu filtern, um einzuschränken, welche Daten importiert werden.
    
24. Sie können auch Anzahl der Datensätze begrenzen in einen einzelnen Job importiert, indem Sie eine Nummer in das Feld Datensatzlimit angeben Kasten. Geben Sie „Alle“ ein, wenn Sie alle Datensätze importieren möchten.
    Tipp: Für dialogorientierte Daten wird das Limit auf Basis von Konversationen und nicht von Zeilen angewendet.
25. Klicken Sie auf Weiter.
26. Wählen Sie aus, wann Sie benachrichtigt werden möchten. Siehe Jobbenachrichtigungen für weitere Informationen.
    
27. Klicken Sie auf Weiter.
28. Legen Sie fest, wie duplizieren Belege behandelt werden. Siehe Handhabung Duplizieren für weitere Informationen.
    
29. Auswählen Inkrementelle Läufe Plan wenn Sie möchten, dass Ihr Job periodisch nach einem Plan ausgeführt wird, oder Einmaligen Pull einrichten wenn Sie möchten, dass der Job nur einmal ausgeführt wird. Siehe Jobeinplanung für weitere Informationen.
30. Klicken Sie auf Weiter.
31. Überprüfen Sie Ihre Einrichtung. Wenn Sie eine bestimmte Einstellung ändern müssen, klicken Sie auf das Symbol Bearbeiten Drucktaste, die zu diesem Schritt in der Verbindungseinrichtung weitergeleitet werden soll.
32. Klicken Sie auf Fertigstellen , um den Job zu sichern.

Standarddatenzuordnung

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

• natural_id: Eine eindeutige ID eines Dokuments. Es wird dringend empfohlen, eine eindeutige ID für jedes Dokument zu haben, um Duplikate korrekt zu verarbeiten. Für Natürliche ID können Sie einen beliebigen Text oder ein 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, 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 Anbieter 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. Dabei kann es sich um alles handeln, was 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. Verwendung benutzerdefinierte Transformationen um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• feedback_type: Identifiziert Daten basierend auf ihrem Typ. Dies ist nützlich für das Reporting, wenn Ihr Projekt verschiedene Arten von Daten enthält (z.B. Umfragen und Feedback). Standardmäßig ist der Wert dieses Attribut auf „Operatives Reporting“ gesetzt. Verwendung benutzerdefinierte Transformationen um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• Jobname: Identifiziert Daten basierend auf dem Namen des Jobs, der zum Hochladen verwendet wurde. Sie können den Wert dieses Attribut während der Einrichtung über das Jobname Feld, das während der Einrichtung oben auf jeder Seite angezeigt wird.
• loadDate: Gibt an, wann ein Dokument in XM Discover hochgeladen wurde. Dieses Feld wird automatisch gesetzt und kann nicht geändert werden.