Wenn Fin ein Problem bei der Verbindung mit Salesforce feststellt, erscheinen die Details in den Fehlerprotokollen. Diese Anleitung hilft Ihnen, schnell zu verstehen, was jeder Fehler bedeutet und wie Sie ihn beheben können.
Jeder Fehlereintrag enthält:
Fehlercode – eine eindeutige Kennung für den Fehler.
Systemfehler – die von Salesforce zurückgegebene Meldung.
Anfragepfad – Der spezifische Salesforce API-Endpunkt, der den Fehler ausgelöst hat.
Anfragemethode – Die verwendete HTTP-Methode (zum Beispiel GET, POST oder PATCH).
Statuscode – Der von Salesforce zurückgegebene HTTP-Antwortcode (zum Beispiel 400 oder 403).
Produktfunktion – wo das Problem aufgetreten ist (zum Beispiel Historical Conversations Import).
API-Typ und Objekttyp – technische Details zur Identifizierung des betroffenen Salesforce-Datenobjekts oder Endpunkts.
So greifen Sie auf die Fehlerprotokolle zu
Gehen Sie zu Einstellungen > Fehlerprotokolle.
Wählen Sie einen Salesforce-bezogenen Fehler aus, um das Fehlerdetails-Panel zu öffnen.
Tipp: Sie können auf Setup überprüfen klicken, um die relevanten Salesforce-Verbindungs- oder Berechtigungseinstellungen direkt aus den Fehlerprotokollen zu öffnen.
So beheben Sie häufige Integrationsfehler
Fehler bei der Verbindung zu Salesforce
Fehlercode: OAUTH_EC_APP_NOT_FOUND
Wann er auftritt: wenn Sie Fin mit Salesforce verbinden.
Wie Sie diesen Fehler beheben: Das Fin for Salesforce-Paket ist in der verbundenen Organisation nicht installiert oder nicht auf der neuesten Version.
Installieren oder aktualisieren Sie das Fin for Salesforce-Paket in genau dieser Salesforce-Organisation.
Verbinden Sie Fin erneut mit Salesforce.
Die Neuinstallation des Pakets wirkt sich nicht auf andere Fin-Workspaces aus.
Fehler beim Wissensimport
Objekt: Knowledge__kav
Fehlercode: INVALID_QUERY_FILTER_OPERATOR
Meldung: Ungültiger Filter in der Wissensartikelabfrage, höchstwahrscheinlich aufgrund eines Datentypsfehlers.
Wie Sie diesen Fehler beheben:
Gehen Sie zu Train > Content > Sync Salesforce knowledge articles.
Überprüfen Sie Ihre Filter und versuchen Sie erneut, Ihre Artikel zu synchronisieren.
Wenn die Synchronisierung zuvor funktionierte, kann der Fehler durch Änderungen an Salesforce-Wissensartikelfeldern verursacht werden. Prüfen Sie, ob Felder, die in Ihren Filtern verwendet werden, in Salesforce aktualisiert wurden.
Objekt: Knowledge__kav
Fehlercode: MALFORMED_QUERY
Meldung: Ungültige Filterwerte in der Wissensartikelabfrage.
Wie Sie diesen Fehler beheben:
Gehen Sie zu Train > Content > Sync Salesforce knowledge articles.
Überprüfen Sie Ihre Filter und versuchen Sie erneut, Ihre Artikel zu synchronisieren.
Wenn die Synchronisierung zuvor funktionierte, kann der Fehler durch Änderungen an Salesforce-Wissensartikelfeldern verursacht werden. Prüfen Sie, ob Felder, die in Ihren Filtern verwendet werden, in Salesforce aktualisiert wurden.
Objekt: Knowledge__kav
Fehlercode: NOT_FOUND
Meldung: Der angeforderte Wissensartikel wurde nicht gefunden.
Wie Sie diesen Fehler beheben: Beim Auslösen eines Wissensimports erfassen wir eine Momentaufnahme der zu synchronisierenden Artikel und starten dann die Synchronisierung. Zwischen dem Erfassen und der Synchronisierung wurde offenbar ein Artikel gelöscht und ist nicht mehr abfragbar. Es sind keine weiteren Maßnahmen erforderlich, außer eventuell den gelöschten Artikel wiederherzustellen.
Objekt: Knowledge__kav
Fehlercode: INVALID_FIELD
Meldung: Es gab Probleme beim Erstellen der Wissensartikelabfrage.
Wie Sie diesen Fehler beheben:
Gehen Sie zu Train > Content > Sync Salesforce knowledge articles.
Überprüfen und aktualisieren Sie Ihre Filter und versuchen Sie erneut, Ihre Auswahl an Artikeln zu synchronisieren.
Wenn die Synchronisierung zuvor funktionierte, kann der Fehler durch Änderungen an Salesforce-Wissensartikelfeldern verursacht werden. Prüfen Sie, ob Berechtigungen oder Sichtbarkeit der in Ihren Filtern verwendeten Felder aktualisiert wurden.
Objekt: Knowledge__kav
Fehlercode: UNKNOWN
Meldung: Es gab Probleme beim Erstellen der Wissensartikelabfrage.
Wie Sie diesen Fehler beheben: Wir unterstützen derzeit nur den Import von Knowledge__kav-Objekten als Salesforce-Artikel. Wenn Ihre Salesforce-Organisation ein anderes Objekt verwendet, wenden Sie sich bitte an unser Support-Team.
Fehler bei Salesforce Cases
Objekt: Case
Fehlercode: INVALID_FIELD_FOR_INSERT_UPDATE
Meldung: Der Integrationsbenutzer hat keine Berechtigung, die Audit-Felder des Objekts zu aktualisieren.
Wie Sie diesen Fehler beheben:
Wenn der Fehler darauf hinweist, dass Fin CreatedById oder LastModifiedById nicht setzen kann:
Gehen Sie zu Salesforce Setup → Benutzeroberfläche.
Aktivieren Sie die Berechtigungen „Audit-Felder bei der Datensatzanlage setzen“ und „Datensätze mit inaktiven Besitzern aktualisieren“.
(Siehe Aktivieren der Berechtigung 'Audit-Felder erstellen' in Salesforce)
Wenn der Fehler ein anderes Feld betrifft:
Teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
Objekt: Case
Fehlercode: FIELD_CUSTOM_VALIDATION_EXCEPTION
Wie Sie diesen Fehler beheben:
Gehen Sie zu Deploy > Salesforce Cases > Workflow.
Führen Sie eine der folgenden Aktionen aus:
Überprüfen Sie, ob das Feld, das den benutzerdefinierten Validierungsfehler verursacht, im Workflow korrekt gesetzt wird.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Feld korrekt zu setzen oder mit einem Standardwert zu versehen.
Objekt: Case
Fehlercode: CANNOT_EXECUTE_FLOW_TRIGGER
Wie Sie diesen Fehler beheben: Ein Flow oder Prozess in Ihrer Salesforce-Organisation löst einen Fehler aus, wenn Fin einen Case aktualisiert oder erstellt.
Teilen Sie die Systemfehlermeldung mit Ihrem Salesforce-Administrator, damit dieser das Problem im Salesforce-Flow oder -Prozess beheben kann.
Objekt: Case
Fehlercode: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
So beheben Sie diesen Fehler:
Gehen Sie zu Deploy > Salesforce Cases > Workflow.
Führen Sie eine der folgenden Aktionen aus:
Aktualisieren Sie den Workflow, um sicherzustellen, dass das Auswahllistenfeld, das den Fehler der eingeschränkten Auswahlliste verursacht, korrekt eingestellt ist.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Auswahllistenfeld auf den richtigen Wert zu setzen oder standardmäßig festzulegen.
Objekt: Case
Fehlercode: UNABLE_TO_LOCK_ROW
So beheben Sie diesen Fehler: Fin konnte das Salesforce Case nicht aktualisieren, da ein anderer Prozess es gleichzeitig aktualisierte. Einige Änderungen am Case wurden möglicherweise nicht gespeichert.
Wenn Fin noch dem Case zugewiesen ist, wird der nächste Aktualisierungsversuch automatisch wiederholt.
Wenn Fin nicht mehr zugewiesen ist, müssen Sie möglicherweise manuell alle Aktualisierungen aus der Fin-Konversation in das Salesforce Case kopieren.
Objekt: Case
Symptom: Kundenantworten auf einen bestehenden Fall erzeugen neue Konversationen in Ihrem Fin-Arbeitsbereich, anstatt an den ursprünglichen Fall angehängt zu werden.
So beheben Sie diesen Fehler: Dies tritt auf, wenn Lightning Threading in Salesforce nicht aktiviert ist. Ohne diese Funktion bewahrt Salesforce die E-Mail-Thread-Header nicht auf, auf die Fin angewiesen ist, um eingehende Antworten dem ursprünglichen Fall zuzuordnen.
Gehen Sie zu Salesforce Setup → Email → Email-to-Case.
Aktivieren Sie Lightning Threading und speichern Sie Ihre Änderungen.
Hinweis: Lightning Threading gilt für Ihre gesamte Salesforce-Organisation — es betrifft alle Fälle und E-Mails, nicht nur die von Fin bearbeiteten. Wenn Ihr Team darauf angewiesen ist, dass Threading für andere workflows deaktiviert bleibt, prüfen Sie die Auswirkungen auf Ihre Salesforce-Konfiguration, bevor Sie es aktivieren.
Objekt: EmailMessage
Fehlercode: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
So beheben Sie diesen Fehler: Das Salesforce EmailMessage-Objekt verweist über ParentId auf das Case und über CreatedById und LastModifiedById auf einen User. Stellen Sie sicher, dass der Salesforce User, der Fin verbunden hat, die Berechtigung hat, sowohl auf das Case- als auch auf das User-Objekt zuzugreifen.
Wenn Ihre Salesforce-Organisation Enhanced Email verwendet, erstellt Salesforce auch Tasks aus EmailMessage-Datensätzen. Stellen Sie in diesem Fall sicher, dass derselbe Benutzer die Berechtigung hat, auf Tasks zuzugreifen, falls der erste Schritt das Problem nicht löst.
Objekt: EmailMessage
Fehlercode: UNABLE_TO_LOCK_ROW
So beheben Sie diesen Fehler: Fin konnte keine EmailMessage für das Salesforce Case erstellen, da ein anderer Prozess das Case gleichzeitig aktualisierte.
Wenn Fin noch dem Case zugewiesen ist, wird die nächste Aktualisierung automatisch die EmailMessage erstellen und die E-Mail erneut senden.
Objekt: EmailMessage
Fehlercode: INVALID_FIELD_FOR_INSERT_UPDATE
So beheben Sie diesen Fehler: Wenn der Fehler darauf hinweist, dass Fin CreatedById oder LastModifiedById nicht setzen kann:
Gehen Sie zu Salesforce Setup → Benutzeroberfläche.
Aktivieren Sie die Berechtigungen „Set Audit Fields upon Record Creation“ und „Update Records with Inactive Owners“.
(Siehe Aktivieren der Berechtigung 'Create Audit Fields' in Salesforce)
Wenn der Fehler ein anderes Feld betrifft:
Teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
Objekt: FeedItem
Fehlercode: UNKNOWN_EXCEPTION
Nachricht: Der Kontextbenutzer hat keine Berechtigung, Rich Text im Feed zu erstellen
So beheben Sie diesen Fehler: Fin benötigt die Möglichkeit, Case-Feed-Elemente mit Rich Text zu erstellen.
Gehen Sie zu Salesforce Setup → Chatter-Einstellungen
Klicken Sie auf Bearbeiten
Aktivieren Sie unter Rich Text Posts „Benutzern erlauben, Rich-Text-Beiträge zu verfassen“
Klicken Sie auf Speichern.
Wenn der Fehler ein anderes Feld betrifft:
Teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
Fehler mit Fin Messenger
Objekt: Case
Fehlercode: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Nachricht: Ungültiger Wert für eingeschränktes Auswahllistenfeld ausgewählt.
So beheben Sie diesen Fehler:
Gehen Sie zu Deploy > Fin Messenger > Workflow.
Führen Sie eine der folgenden Aktionen aus:
Aktualisieren Sie den Workflow, um sicherzustellen, dass das Auswahllistenfeld, das den Fehler der eingeschränkten Auswahlliste verursacht, korrekt eingestellt ist.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Auswahllistenfeld auf den richtigen Wert zu setzen oder standardmäßig festzulegen.
Objekt: Case
Fehlercode: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
So beheben Sie diesen Fehler: Fin kann während des Schritts "Create Salesforce Case" im Fin Messenger Workflow kein Case erstellen. Stellen Sie sicher, dass der Salesforce-Benutzer, der Fin mit Salesforce verbunden hat, die Berechtigung hat, auf das Case-Objekt zuzugreifen.
Objekt: Case
Fehlercode: FIELD_CUSTOM_VALIDATION_EXCEPTION
Nachricht: Ungültiger Wert für eingeschränktes Auswahllistenfeld ausgewählt.
So beheben Sie diesen Fehler:
Gehen Sie zu Deploy > Fin Messenger > Workflow.
Führen Sie eine der folgenden Aktionen aus:
Aktualisieren Sie den Workflow, um sicherzustellen, dass das Feld, das den Validierungsfehler verursacht, korrekt eingestellt ist.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Feld auf den richtigen Wert zu setzen oder standardmäßig festzulegen.
Objekt: Case
Fehlercode: REQUIRED_FIELD_MISSING
So beheben Sie diesen Fehler:
Gehen Sie zu Deploy > Fin Messenger > Workflow.
Führen Sie eine der folgenden Aktionen aus:
Aktualisieren Sie den Workflow, um sicherzustellen, dass das Feld, das den Validierungsfehler verursacht, korrekt eingestellt ist.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Feld auf den richtigen Wert zu setzen oder standardmäßig festzulegen.
Hinweis: Wenn das Feld nicht als Set-Daten-Schritt sichtbar ist, gehen Sie zu Deploy > Fin Messenger > Data und wählen Sie das Case-Feld im Abschnitt Daten von Salesforce abrufen aus.
Objekt: Case
Fehlercode: INVALID_FIELD_FOR_INSERT_UPDATE
So beheben Sie diesen Fehler: Fin kann bestimmte Felder im Salesforce Case-Objekt nicht setzen. Stellen Sie sicher, dass der Salesforce-Benutzer, der Fin verbunden hat, die richtigen Berechtigungen für das Case-Objekt hat.
Wenn das Problem weiterhin besteht, teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team zur Unterstützung.
Objekt: Case
Fehlercode: INVALID_EMAIL_ADDRESS
So beheben Sie diesen Fehler: Fin konnte kein Salesforce Case-Objekt erstellen. Bitte überprüfen Sie, ob die an Fin übermittelte E-Mail-Adresse gültig ist.
Objekt: Case
Fehlercode: CANNOT_EXECUTE_FLOW_TRIGGER
Wie Sie diesen Fehler beheben: Ein Flow oder Prozess in Ihrer Salesforce-Organisation verursacht einen Fehler, wenn Fin einen Case aktualisiert oder erstellt. Teilen Sie die Systemfehlermeldung mit Ihrem Salesforce-Administrator, damit er das Problem beheben kann.
Objekt: FeedItem
Fehlercode: UNKNOWN_EXCEPTION
Nachricht: Der Kontextbenutzer hat keine Berechtigung, Rich Text im Feed zu erstellen
Wie Sie diesen Fehler beheben: Fin benötigt die Möglichkeit, Case-Feed-Elemente mit Rich Text zu erstellen.
Gehen Sie zu Salesforce Setup → Chatter-Einstellungen
Klicken Sie auf Bearbeiten
Aktivieren Sie unter Rich Text Posts „Benutzern erlauben, Rich-Text-Beiträge zu verfassen“
Klicken Sie auf Speichern.
Wenn der Fehler ein anderes Feld betrifft:
Teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
Fehler: Authentifizierungsmodus stimmt im Fin Messenger mit Salesforce Messaging nicht überein
Wie Sie diesen Fehler beheben: Angemeldete Besucher senden immer authentifizierte Tokens, daher muss der Salesforce-Messaging-Kanal diese akzeptieren.
Gehen Sie in Salesforce zu Setup → Messaging-Einstellungen und wählen Sie den Kanal aus.
Aktivieren Sie Benutzerverifizierung für den Messaging-Kanal.
Richten Sie die Identitätsprüfung für Fin Messenger ein.
Fehler beim Synchronisieren der Case-Historie
Objekt: Emails
Fehlercode: INVALID_TYPE
Nachricht: Der Integrationsbenutzer kann nicht auf die an den Case angehängten E-Mail-Nachrichten zugreifen.
Wie Sie diesen Fehler beheben: Fin kann nicht auf die Emails-Beziehung im Salesforce Case-Objekt zugreifen. Dies liegt höchstwahrscheinlich daran, dass Enhanced Email in Ihrer Salesforce-Organisation nicht aktiviert ist.
Um dies zu beheben, führen Sie eine der folgenden Aktionen aus:
Gehen Sie zu Salesforce Setup → Enhanced Email und aktivieren Sie Enhanced Email.
Deaktivieren Sie das Synchronisieren der Gesprächshistorie. Gehen Sie zu Fin Workspace → Einstellungen → Salesforce-Integration und schalten Sie „Sync case history from Salesforce“ aus.
Wir arbeiten aktiv daran, Salesforce-Organisationen ohne Enhanced Email zu unterstützen. Kontaktieren Sie unser Support-Team für die neuesten Updates.
Objekt: CaseFeed
Fehlercode: INVALID_FIELD
Nachricht: Der Workspace benötigt aktivierte Digital Experiences.
Wie Sie diesen Fehler beheben: Fin kann das Visibility-Feld im Salesforce CaseFeed-Objekt nicht abfragen. Stellen Sie sicher, dass der Salesforce-Benutzer, der Fin verbunden hat, die Berechtigung zum Zugriff auf dieses Feld hat.
Das Visibility-Feld ist nur verfügbar, wenn Digital Experiences in Salesforce aktiviert ist. Dieses Feld ist erforderlich, um zu bestimmen, ob ein Kommentar intern oder öffentlich ist. Siehe Digital Experiences in Salesforce aktivieren, um es zu aktivieren.
Wenn das Problem nach der Aktivierung weiterhin besteht, teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
Objekt: Case
Fehlercode: INVALID_FIELD
Wie Sie diesen Fehler beheben: Fin kann bestimmte Felder im Salesforce Case-Objekt nicht abfragen. Überprüfen Sie, ob der Salesforce-Benutzer, der Fin verbunden hat, die Berechtigung zum Zugriff auf diese Felder besitzt.
Wenn das Problem weiterhin besteht, teilen Sie die Fehlerdetails mit Ihrem Salesforce-Administrator oder wenden Sie sich an unser Support-Team.
FAQs
Wie erkenne ich, ob ein Fehler Salesforce-bezogen ist?
Salesforce-bezogene Fehler zeigen API type: Salesforce REST API in den Fehlerdetails an.
Kann ich Salesforce-Fehlerprotokolle exportieren?
Noch nicht – aber Sie können in jedem Fehlerfenster auf Alle Details kopieren klicken, um das vollständige Protokoll zum Melden oder Teilen zu kopieren.
Wo kann ich gelöste Fehler sehen?
Gelöste Probleme werden automatisch aus der Ansicht Fehlerprotokolle entfernt, sobald Fin die Verbindung erfolgreich wiederherstellt oder die fehlgeschlagene Anfrage erneut versucht.