API-Aufrufe und Synchronisierungsfehler der Salesforce-Integration verwalten
Zuletzt aktualisiert am: 27 Mai 2025
Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):
|
|
|
|
|
Bei der HubSpot-Salesforce-Integration können Synchronisierungsfehler auftreten, die eine Synchronisierung der Daten verhindern. Sie können diese Synchronisierungsfehler in Ihren Salesforce-Integrationseinstellungen identifizieren und beheben.
Limit für API-Aufrufe anpassen
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol settings, um die Einstellungen aufzurufen. Gehen Sie in der linken Seitenleiste zu Integrationen > Verknüpfte Apps.
- Klicke in der Liste der verknüpften Apps auf "Salesforce".
- Zeigen Sie auf der Registerkarte "Synchronisierungszustand " im Abschnitt "API-Aufruf Nutzung" an, wie viele API Anrufe Sie in den letzten 24 Stunden verbraucht haben. Die Zahl unter „Beschränkt durch Salesforce“ steht für die Anzahl an API-Aufrufen, die Sie basierend auf Ihren Salesforce-Einstellungen vornehmen können. Um festzulegen, wie viele Anrufe HubSpot zugewiesen werden können, bearbeiten Sie das Feld HubSpot zugewiesen .
Salesforce-Synchronisierungsfehler anzeigen
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol settings, um die Einstellungen aufzurufen. Gehen Sie in der linken Seitenleiste zu Integrationen > Verknüpfte Apps.
- Klicke in der Liste der verknüpften Apps auf "Salesforce".
- Zeigen Sie auf der Registerkarte "Synchronisierungszustand " unter "Synchronisierungsfehler" Karten für jeden Fehlertyp mit der Anzahl der aktuellen Fehler und der betroffenen Datensätze an. Klicken Sie auf eine Fehlertyp-Karte, um Details der Fehler im rechten Bereich anzuzeigen. Erfahren Sie mehr über die einzelnen Fehlertypen und Lösungsempfehlungen.
- Um weitere Details zu einem Fehler anzuzeigen, klicken Sie auf das info info Symbol in der Spalte Error Type .
- Um Maßnahmen für einzelne Datensätze zu ergreifen, klicken Sie auf [#] Datensätze in der Spalte " Betroffene Datensätze " und dann auf "Aktionen > " Erstellen Sie eine temporäre Ansicht von HubSpot-Datensätzen, um eine gefilterte Ansicht der betroffenen Datensätze zu erstellen.
- Sobald Sie die Fehler behoben haben, kehren Sie zur Fehlerliste zurück. Aktivieren Sie das Kontrollkästchen links neben allen nicht behobenen Problemen und klicken Sie auf „Erneut synchronisieren“.
- Um Ihre Fehler zu exportieren, klicken Sie oben links in der Fehlerliste auf Fehler exportieren (CSV).

Salesforce-Synchronisierungsfehlertypen
Zuordnungen
Beispiele für Fehler bei Zuordnungen
- Zuordnung Limit erreicht
- Warten auf Synchronisierung des Accounts
Was bedeuten die Fehler?
Datensätze werden nicht synchronisiert, weil sie mit Salesforce-Konten verknüpft sind, die noch nicht mit HubSpot-Unternehmen synchronisiert wurden, oder weil sie mit Datensätzen verknüpft sind, die das HubSpot-Limit für die Datensatzzuordnung erreicht haben.
So beheben Sie die Fehler
Um den Fehler beim Erreichen des Zuordnungslimits zu beheben, können Sie entweder einige der zugeordneten Datensätze entfernen oder sie einem anderen Salesforce-Eintrag zuordnen und dann mit der Synchronisierung fortfahren.
Um den Fehler "Warten auf die Synchronisierung Account" zu beheben, wird empfohlen, einen Import von Salesforce-Konten durchzuführen.
Benutzerdefinierter Code
Beispiele für Fehler mit benutzerdefiniertem Code
- Salesforce-Automatisierung
- Fehlende Kontakt-ID
- Validierungsregel für benutzerdefiniertes Salesforce-Feld
- Salesforce-Ablauf
Was bedeuten die Fehler?
Die Datensätze werden aufgrund eines Problems, das durch Automatisierung, Abläufe oder Validierungsregeln in Ihrem Salesforce-Account verursacht wird, nicht synchronisiert.
So beheben Sie die Fehler
Da diese Fehler ihren Ursprung in Salesforce haben, empfiehlt es sich, mit Ihrem Salesforce-Admin zusammenzuarbeiten, um das Problem in Ihrem benutzerdefinierten Code in Salesforce zu beheben.
Duplikate
Beispiele für Fehler mit Duplikaten
- E-Mail wird bereits verwendet
- Salesforce-Duplikatregel
Was bedeuten die Fehler?
Ein Salesforce-Lead oder -Kontakt kann nicht mit HubSpot synchronisiert werden, da die E-Mail-Adresse bereits in einem HubSpot-Kontaktdatensatz vorhanden ist oder aufgrund einer Deduplizierungsregel in Salesforce.
So beheben Sie die Fehler
Um den Fehler zu beheben, dass E-Mail bereits verwendet wird, entfernen Sie die E-Mail-Adresse aus dem vorhandenen HubSpot-Kontakt.
Um den Salesforce-Duplikatregelfehler zu beheben, sollten Sie die in Salesforce eingerichteten Übereinstimmungsregeln für die Deduplizierung überprüfen.
Berechtigungen
Beispiele für Fehler im Zusammenhang mit Berechtigungen
- Unzureichender Zugriff oder fehlender Salesforce-Eintrag
- Salesforce-Feldberechtigung
- Unzureichender Zugriff auf Salesforce
Was bedeuten die Fehler?
Änderungen in HubSpot können nicht mit Salesforce synchronisiert werden, da der verknüpfte Benutzer keinen Zugriff auf das erforderliche Feld oder Objekt in Salesforce hat.
So beheben Sie die Fehler
In den meisten Fällen tritt der Fehler " Unzureichender Zugriff oder fehlender Salesforce-Eintrag" auf, wenn die Integration versucht, ein Salesforce-Feld mit einem falschen Wert zu aktualisieren oder eine falsche Zuordnung zu erstellen.
Um den Salesforce-Feldberechtigungsfehler zu beheben, stellen Sie sicher, dass der Benutzer der Salesforce-Integration über Lese- und Bearbeitungsberechtigungen für das Feld in Salesforce verfügt.
Der Fehler "Unzureichender Zugriff auf Salesforce " tritt auf, wenn der Benutzer der Salesforce-Integration die Aktion in Salesforce aufgrund seiner Benutzerberechtigungen in Salesforce nicht durchführen kann. Es wird empfohlen, die Benutzerberechtigungen für die Salesforce-Integration in Salesforce zu überprüfen.
Auswahllisten
Beispiele für Fehler bei der Auswahlliste
- Fehlende Salesforce-Auswahllistenoption
- Ungültiger Wert für Bundesland oder Land
- Nicht übereinstimmende Optionen
- Inaktiver Salesforce-Mitarbeiter
- Eingeschränkter Auswahllistenwert
- Phase der inaktiven Opportunity
- Salesforce-Inhaber wurden nicht synchronisiert
- Optionslimit überschritten
- Standard-Vertriebsprozess nicht verfügbar
- Fehlende oder ungültige Opportunity-Phase
Was bedeuten die Fehler?
Datensätze werden aufgrund einer Diskrepanz zwischen Feldwerten in den Auswahllisten in HubSpot und Salesforce nicht synchronisiert. Dies kann der Fall sein, wenn ein Auswahllistenwert in einem System nicht mit aktuellen Werten im anderen übereinstimmt, wenn die Auswahlliste ein Limt von Werten erreicht hat oder wenn der Wert nicht gültig ist,
So beheben Sie die Fehler
Um den Fehler mit dem nicht übereinstimmenden Bundesland- oder Länderwert zu beheben, sollten Sie überprüfen, ob die folgenden Anforderungen erfüllt sind:
- Der interne Wert der " Land "-Eigenschaft in HubSpot muss mit einer vorhandenen "Land "-Option in Ihren Einstellungen für Bundesland und Land/Region in Salesforce übereinstimmen.
- Der Wert "Bundesland " muss als Option "Verfügbares Bundesland/Provinz" für den Wert "Land " des Eintrags in Salesforce vorhanden sein. Darüber hinaus muss der interne Wert der Eigenschaft " Status " in HubSpot mit einer vorhandenen Option in Salesforce übereinstimmen.
Um den Fehler " Nicht übereinstimmende Optionen " zu beheben, wird empfohlen, den internen /API-Namen der Salesforce-Feldoptionen zu aktualisieren, damit er mit dem internen Wert der Eigenschaftenoptionen in HubSpot übereinstimmt.
Um den Fehler " Inaktiver Salesforce-Mitarbeiter" zu beheben, weisen Sie den HubSpot-Eintrag einem Benutzer zu, der ein aktiver Benutzer in Salesforce ist.
Der Fehler mit dem eingeschränkten Auswahllistenwert tritt auf, wenn Sie die Einstellung Auswahlliste auf die im Wertesatz definierten Werte einschränken für das Feld in Salesforce aktiviert haben. Wenn diese Option in Salesforce aktiviert ist, muss der Wert, den Sie von HubSpot mit Salesforce synchronisieren möchten, als Option in der Salesforce-Auswahlliste vorhanden sein. Es wird empfohlen, die Auswahlliste auf die in der Einstellung "Wertesatz" definierten Werte in Salesforce zu deaktivieren, damit alle Werte von HubSpot mit Salesforce synchronisiert werden können.
Der Fehler "Inaktive Opportunity-Phase" tritt auf, wenn eine Salesforce-Opportunity mit einer inaktiven Opportunity-Phase versucht, mit HubSpot synchronisiert zu werden. Um diesen Fehler zu beheben, ändern Sie die Opportunity-Phase in Salesforce in "Aktiv" oder verschieben Sie die Opportunity in eine aktive Phase.
Um den Fehler " Salesforce-Inhaber nicht synchronisiert" zu beheben, stellen Sie sicher, dass der Benutzertyp der Salesforce-Benutzer in Salesforce auf "Standard", "Power Partner" oder "Gast" festgelegt ist.
Um den Fehler " Überschreitung des Optionslimits " zu beheben, sollten Sie zusätzliche Eigenschaftsoptionen in HubSpot und Salesforce löschen, die Ihr Team nicht verwendet. Stellen Sie außerdem sicher, dass alle zugeordneten Eigenschaften über entsprechende Feldtypen verfügen.
In den meisten Fällen tritt der Fehler "Standardvertriebsprozess nicht verfügbar" auf, wenn Salesforce-Opportunitys versuchen, mit einem fehlenden Eintrag-Typ mit HubSpot synchronisiert zu werden. Wenn Sie Eintrag-Typen in Salesforce aktiviert haben, sie jedoch nicht verwenden oder Salesforce-Opportunitys ohne Eintrag-Typ haben, empfiehlt es sich, mit Salesforce zusammenzuarbeiten, um alle Eintrag-Typen zu deaktivieren oder einen neuen Eintrag-Typ zu erstellen.
Um den Fehler " Fehlende oder ungültige Opportunity-Phase " zu beheben, stellen Sie sicher, dass der Salesforce-Wert für die Opportunity-Phase in der HubSpot-Pipeline vorhanden ist.
Eigenschaftszuordnungen
Beispiele für Fehler bei der Zuordnung von Eigenschaften
- Nicht übereinstimmender Typ
- Fehlende Salesforce-ID
- Ungültige Salesforce-ID
Was bedeuten die Fehler?
Datensätze werden aufgrund einer Diskrepanz in der Zuordnung zwischen der HubSpot-Eigenschaft und dem Salesforce-Feld nicht synchronisiert. Dies kann bedeuten, dass die Eigenschaft und Feldtypen nicht kompatibel sind, dass die Eigenschaft oder das Feld nicht mehr vorhanden ist oder dass eine Salesforce-Referenzfeldzuordnung erstellt werden muss.
So beheben Sie die Fehler
Um den Fehler zu beheben , stellen Sie sicher, dass der Eigenschaftentyp in HubSpot und der Feldtyp in Salesforce kompatibel sind. Erfahren Sie mehr über die HubSpot-Eigenschaftenfeldtypen, die mit Salesforce synchronisiert werden können.
Der Fehler "Fehlende Salesforce-ID" tritt auf, wenn HubSpot versucht hat, einen anderen Wert als eine vorhandene Salesforce-ID mit einem Referenz-/Nachschlagefeld in Salesforce zu synchronisieren.
Um den Fehler " Ungültige Salesforce-ID" zu beheben, sollten Sie die benutzerdefinierte Validierungsregel überprüfen, die Sie in Salesforce eingerichtet haben.
Eigenschaftswerte
Beispiele für Fehler mit Eigenschaftenwerten
- Zeichenfolge zu lang
- Ungültige E-Mail-Adresse
- Erforderliches Land fehlt
- Ungültiger Wert
- Zuweisung des zuständigen Mitarbeiters
- Eingeschränkter eindeutiger Wert
- Erforderlicher Wert fehlt
Was bedeuten die Fehler?
Datensätze werden nicht zwischen HubSpot und Salesforce synchronisiert, da sie Eigenschaftswerte enthalten, die nicht gültig sind. Bei diesen Fehlern müssen in der Regel die einzelnen betroffenen Datensätze aktualisiert werden, damit der Fehler behoben wird.
So beheben Sie die Fehler
Um den Fehler "Zu lange Zeichenfolge " zu beheben, kürzen Sie den Feldwert in Salesforce oder HubSpot oder erhöhen Sie die Zeichenbeschränkung des Feldes in Salesforce.
Um den Fehler mit der ungültigen E-Mail zu beheben, aktualisieren Sie die E-Mail-Adressformatierung im Salesforce-Eintrag, der mit HubSpot synchronisiert werden soll.
Um den Fehler " Fehlendes erforderliches Land" zu beheben, sollten Sie überprüfen, ob die folgenden Anforderungen erfüllt sind:
- Der interne Wert der "Land"-Eigenschaft in HubSpot muss mit einer vorhandenen "Land"-Option in Ihren Einstellungen für Bundesland und Land/Region in Salesforce übereinstimmen.
- Der Wert "Bundesland" muss als Option "Verfügbares Bundesland/Provinz" für den Wert "Land" des Eintrags in Salesforce vorhanden sein. Darüber hinaus muss der interne Wert der Eigenschaft "Status" in HubSpot mit einer vorhandenen Option in Salesforce übereinstimmen.
Um den Fehler mit dem ungültigen Wert zu beheben, wird empfohlen, den Eigenschaftenwert im Salesforce-Eintrag zu aktualisieren, um die Anforderungen von HubSpot für den Eigenschaftwert zu erfüllen.
In den meisten Fällen tritt der Fehler bei der Mitarbeiterzuweisung auf, wenn eine HubSpot-Aktivität als Salesforce-Aufgabe mit Salesforce synchronisiert wird und HubSpot versucht, die Aufgabe einem zuständigen Salesforce-Warteschlangenmitarbeiter zuzuweisen.
Um den Fehler mit dem eingeschränkten eindeutigen Wert zu beheben, sollten Sie die in Salesforce eingerichteten Übereinstimmungsregeln für die Deduplizierung überprüfen.
Um den Fehler mit dem fehlenden erforderlichen Wert zu beheben, fügen Sie dem Salesforce-Eintrag einen Wert für jede Eigenschaft hinzu, die in HubSpot als erforderlich markiert ist.
Sonstiges
Datensätze werden aufgrund eines unbekannten Fehlers nicht synchronisiert. Bitte kontaktieren Sie den HubSpot-Support, um weitere Hilfe bei diesen Fehlern zu erhalten.
Bitte beachten: Es ist möglich, 100 Salesforce-Fehler gleichzeitig erneut zu synchronisieren. Um mehr als 100 Fehler zu synchronisieren, importieren Sie die Datensätze aus Salesforce oder aktualisieren Sie eine zugeordnete Eigenschaft .
Benachrichtigungen zu Synchronisierungsfehlern einrichten
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol settings, um die Einstellungen aufzurufen. Gehen Sie in der linken Seitenleiste zu Integrationen > Verknüpfte Apps.
- Klicke in der Liste der verknüpften Apps auf "Salesforce".
- Klicken Sie auf die Registerkarte Synchronisierungszustand .
- Klicken Sie unter „Synchronisierungsfehler“ auf „Benachrichtigungen verwalten“.
- Schalten Sie im Dialogfeld den Schalter Benachrichtigungen aktivieren ein.
- Wählen Sie das Optionsfeld neben „Sofort“, „Täglich“ oder „Wöchentlich“ aus, um die Häufigkeit Ihrer Benachrichtigungen festzulegen.
- Klicken Sie auf „Speichern“.