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 Fehler-Eintrag enthält:
Fehlercode – ein eindeutiger Bezeichner 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, welches Salesforce-Datenobjekt oder welcher Endpunkt betroffen ist.
So greifen Sie auf die Fehlerprotokolle zu
Gehen Sie zu Einstellungen > Fehlerprotokolle.
Wählen Sie einen beliebigen 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 beim Wissensimport
Objekt: Knowledge__kav
Fehlercode: INVALID_QUERY_FILTER_OPERATOR
Meldung: Ungültiger Filter in der Wissensartikelabfrage, höchstwahrscheinlich aufgrund eines Datentypsfehlers.
So beheben Sie diesen Fehler:
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.
So beheben Sie diesen Fehler:
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.
So beheben Sie diesen Fehler: Beim Auslösen eines Wissensimports erfassen wir eine Momentaufnahme der zu synchronisierenden Artikel und starten dann die Synchronisierung. Zwischen dem Erfassen und Synchronisieren der Artikel scheint ein Artikel gelöscht worden zu sein 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.
So beheben Sie diesen Fehler:
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 den Berechtigungen oder der Sichtbarkeit der in Ihren Filtern verwendeten Salesforce-Felder verursacht werden. Prüfen Sie, ob Updates an diesen vorgenommen wurden.
Objekt: Knowledge__kav
Fehlercode: UNKNOWN
Meldung: Es gab Probleme beim Erstellen der Wissensartikelabfrage.
So beheben Sie diesen Fehler: 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-Fällen
Objekt: Case
Fehlercode: INVALID_FIELD_FOR_INSERT_UPDATE
Meldung: Der Integrationsuser hat keine Berechtigung, die Audit-Felder des Objekts zu aktualisieren.
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: Case
Fehlercode: FIELD_CUSTOM_VALIDATION_EXCEPTION
So beheben Sie diesen Fehler:
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 auf den korrekten Wert zu setzen oder standardmäßig zu belegen.
Objekt: Case
Fehlercode: CANNOT_EXECUTE_FLOW_TRIGGER
So beheben Sie diesen Fehler: Ein Flow oder Prozess in Ihrer Salesforce-Organisation löst einen Fehler aus, wenn Fin einen Case aktualisiert oder erstellt.
Teilen Sie die Systemfehlermeldungen 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 bei der eingeschränkten Auswahlliste verursacht, korrekt gesetzt wird.
Wenn der Workflow dieses Feld nicht setzen soll, konfigurieren Sie einen Salesforce Flow, um das Auswahllistenfeld auf den korrekten Wert zu setzen oder standardmäßig zu belegen.
Objekt: Case
Fehlercode: UNABLE_TO_LOCK_ROW
Wie dieser Fehler behoben wird: Fin konnte den Salesforce Case nicht aktualisieren, da ein anderer Prozess ihn gleichzeitig aktualisierte. Einige Aktualisierungen des Case wurden möglicherweise nicht gespeichert.
Wenn Fin noch dem Case zugewiesen ist, wird der nächste Update-Versuch automatisch wiederholt.
Wenn Fin nicht mehr zugewiesen ist, müssen Sie möglicherweise manuell alle Aktualisierungen aus dem Fin-Gespräch in den Salesforce Case kopieren.
Objekt: EmailMessage
Fehlercode: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Wie dieser Fehler behoben wird: Das Salesforce EmailMessage-Objekt verweist über ParentId auf den 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 User die Berechtigung hat, auf Tasks zuzugreifen, falls der erste Schritt das Problem nicht löst.
Objekt: EmailMessage
Fehlercode: UNABLE_TO_LOCK_ROW
Wie dieser Fehler behoben wird: Fin konnte keine EmailMessage für den Salesforce Case erstellen, da ein anderer Prozess den Case gleichzeitig aktualisierte.
Wenn Fin noch dem Case zugewiesen ist, wird der nächste Update-Versuch automatisch die EmailMessage erstellen und die E-Mail erneut senden.
Objekt: EmailMessage
Fehlercode: INVALID_FIELD_FOR_INSERT_UPDATE
Wie dieser Fehler behoben wird: 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 zur Hilfe.
Objekt: FeedItem
Fehlercode: UNKNOWN_EXCEPTION
Nachricht: Der Kontextbenutzer hat keine Berechtigung, Rich-Text im Feed zu erstellen
Wie dieser Fehler behoben wird: Fin benötigt die Fähigkeit, 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 zur Hilfe.
Fehler mit Fin Messenger
Objekt: Case
Fehlercode: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Nachricht: Ungültiger Wert für eingeschränktes Auswahllistenfeld ausgewählt.
Wie dieser Fehler behoben wird:
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 bei der eingeschränkten Auswahlliste verursacht, korrekt gesetzt ist.
Wenn Sie nicht möchten, dass der Workflow dieses Feld setzt, konfigurieren Sie einen Salesforce Flow, um das Auswahllistenfeld auf den korrekten Wert zu setzen oder standardmäßig zu belegen.
Objekt: Case
Fehlercode: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
Wie dieser Fehler behoben wird: Fin kann während des Schritts "Create Salesforce Case" im Fin Messenger Workflow keinen Case erstellen. Stellen Sie sicher, dass der Salesforce User, 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.
Wie dieser Fehler behoben wird:
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 gesetzt ist.
Wenn Sie nicht möchten, dass der Workflow dieses Feld setzt, konfigurieren Sie einen Salesforce Flow, um das Feld auf den korrekten Wert zu setzen oder standardmäßig zu belegen.
Objekt: Case
Fehlercode: REQUIRED_FIELD_MISSING
Wie dieser Fehler behoben wird:
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 gesetzt ist.
Wenn Sie nicht möchten, dass der Workflow dieses Feld setzt, konfigurieren Sie einen Salesforce Flow, um das Feld auf den korrekten Wert zu setzen oder standardmäßig zu belegen.
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
Wie dieser Fehler behoben wird: Fin kann bestimmte Felder im Salesforce Case-Objekt nicht setzen. Stellen Sie sicher, dass der Salesforce User, 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
Wie dieser Fehler behoben wird: 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 dieser Fehler behoben wird: 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 dieser das Problem beheben kann.
Objekt: FeedItem
Fehlercode: UNKNOWN_EXCEPTION
Nachricht: Der Kontextbenutzer hat keine Berechtigung, Rich-Text im Feed zu erstellen
Wie dieser Fehler behoben wird: Fin benötigt die Fähigkeit, 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 zur Hilfe.
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 dieser Fehler behoben wird: 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 die Synchronisierung des Gesprächsverlaufs. 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.
So beheben Sie diesen Fehler: 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 besitzt.
Das Visibility-Feld ist nur verfügbar, wenn Digital Experiences in Salesforce aktiviert sind. Dieses Feld ist erforderlich, um zu bestimmen, ob ein Kommentar intern oder öffentlich ist. Siehe Digital Experiences in Salesforce aktivieren für die Aktivierung.
Wenn das Problem nach der Aktivierung weiterhin besteht, teilen Sie die Fehlerdetails Ihrem Salesforce-Administrator mit oder kontaktieren Sie unser Support-Team.
Objekt: Case
Fehlercode: INVALID_FIELD
So beheben Sie diesen Fehler: 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 Ihrem Salesforce-Administrator mit oder kontaktieren Sie 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 Copy all details 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 Error logs entfernt, sobald Fin erfolgreich die Verbindung wiederherstellt oder die fehlgeschlagene Anfrage erneut versucht.