API-Aufrufe und Synchronisierungsfehler der Salesforce-Integration verwalten

Die HubSpot-Salesforce-Integration kann auf Synchronisierungsfehler stoßen, die eine Synchronisierung der Daten verhindern. Sie können diese Synchronisierungsfehler in Ihren Salesforce-Integrationseinstellungen identifizieren und beheben.

Limit für API-Aufrufe anpassen

• Gehen Sie in Ihrem HubSpot-Account zu Datenmanagement > Integrationen.
• Klicken Sie in der Liste der verknüpften Apps auf „Salesforce“. 
• Klicken Sie auf die Registerkarte „Synchronisierungszustand“.
• Im Abschnitt „Nutzung von API-Aufrufen“ sehen Sie, wie viele API-Aufrufe Sie in den letzten 24 Stunden in Anspruch genommen 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 anzupassen, wie viele dieser Anrufe HubSpot zugewiesen werden können, bearbeiten Sie das Feld „Zugewiesen zu HubSpot“. 

Synchronisierungsfehler beheben

• Gehen Sie in Ihrem HubSpot-Account zu Datenmanagement > Integrationen.
• Klicken Sie in der Liste der verknüpften Apps auf „Salesforce“. 
• Klicken Sie auf die Registerkarte „Synchronisierungszustand“.
• Unter „Synchronisierungsfehler“ sehen Sie Karten für jeden Fehlertyp mitsamt der Anzahl der aktuellen Fehler und der jeweils betroffenen Datensätze. Klicken Sie auf eine Fehlertyp-Karte, um Details der Fehler im rechten Bereich anzuzeigen. Weitere Informationen zu den einzelnen Fehlertypen sowie entsprechende Lösungsschritte finden Sie im Folgenden.  

Zuordnungen

Datensätze werden nicht synchronisiert, da sie Datensätzen zugeordnet sind, die noch nicht mit HubSpot synchronisiert wurden, oder weil sie Datensätzen zugeordnet sind, die das Zuordnungslimit für HubSpot-Datensätze erreicht haben. In der Spalte „Betroffene Datensätze“ finden Sie alle Datensätze, die aufgrund einer Zuordnung zum Datensatz in der Spalte „Datensatz“ links nicht synchronisiert wurden.

• Um Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Um Aktionen für einzelne Datensätze durchzuführen, klicken Sie auf „[#] Datensätze“ in der Spalte „Betroffene Datensätze“ und klicken Sie dann auf „Ansicht erstellen“, um eine gefilterte Ansicht der betroffenen Datensätze zu erstellen. 
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Zuordnungen“ 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 rechts auf „Fehler exportieren“.

Benutzerdefinierter Code

Datensätze werden aufgrund eines Problems, das durch Automatisierung, Flows oder Validierungsregeln in Ihrem Salesforce-Konto verursacht wird, nicht synchronisiert. Informationen zur Ursache des Fehlers werden in der Spalte „Fehlerdetails“ angezeigt. 

• Um Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Je nach Details des Fehlers müssen Sie möglicherweise die betroffenen Datensätze aktualisieren oder Änderungen an Ihren Salesforce-Einstellungen vornehmen. Um Aktionen für einzelne Datensätze in HubSpot durchzuführen, klicken Sie auf „[#] Datensätze“ in der Spalte „Betroffene Datensätze“ und klicken Sie dann auf „Ansicht erstellen“, um eine gefilterte Ansicht der betroffenen Datensätze zu erstellen.
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Benutzerdefinierter Code“ 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 rechts auf „Fehler exportieren“.

Duplikate

Datensätze können nicht erstellt werden, da bereits ein doppelter Datensatz oder Wert vorhanden ist. Sie sehen die von dem Fehler betroffenen HubSpot- und Salesforce-Datensätze zusammen mit dem doppelten Wert.

• Um Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Klicken Sie auf „HubSpot“ oder „Salesforce“ in der Spalte „Datensatz anzeigen in“, um auf den Datensatz zuzugreifen und Änderungen vorzunehmen.
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Duplikate“ 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 rechts auf „Fehler exportieren“.

Berechtigungen

Ä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.

• Um spezifische Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Überprüfen und aktualisieren Sie die Berechtigungen für den verknüpften Benutzer in Ihren Salesforce-Einstellungen.
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Berechtigungen“ 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 rechts auf „Fehler exportieren“.

Auswahllisten

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, Sie sehen die HubSpot-Eigenschaft und das Salesforce-Feld, die den Fehler verursachen, zusammen mit der Anzahl der betroffenen Datensätze für jeden Fehler. 

• Um Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Je nach Details des Fehlers müssen Sie möglicherweise Werte für die betroffenen Datensätze aktualisieren oder Änderungen an der Eigenschaft oder dem Feld vornehmen. Um Aktionen für einzelne Datensätze in HubSpot durchzuführen, klicken Sie auf „[#] Datensätze“ in der Spalte „Betroffene Datensätze“ und klicken Sie dann auf „Ansicht erstellen“, um eine gefilterte Ansicht der betroffenen Datensätze zu erstellen.
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Auswahllisten“ 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 rechts auf „Fehler exportieren“.

Eigenschaftszuordnungen

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.

• Um Details und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Aktualisieren Sie Ihre Eigenschaftszuordnungen. 
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Eigenschaftszuordnungen“ 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 rechts auf „Fehler exportieren“.

Eigenschaftswerte

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.

• Um zusätzliche Informationen und Lösungsschritte für einen Fehler anzuzeigen, klicken Sie auf das Info-Symbol info in der Spalte „Fehlertyp“.
• Aktualisieren Sie die ungültigen Werte im Datensatz in HubSpot oder Salesforce. Um eine Liste an betroffenen Datensätzen in HubSpot anzuzeigen, klicken Sie auf „[#] Datensätze“ in der Spalte „Betroffene Datensätze“ und klicken Sie dann auf „Ansicht erstellen“, um eine gefilterte Ansicht zu erstellen. 
• Nachdem Sie die Fehler behoben haben, kehren Sie zur Fehlerliste für „Eigenschaftswerte“ 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 rechts auf „Fehler exportieren“.

Sonstige

Datensätze werden aufgrund eines unbekannten Fehlers nicht synchronisiert. Das Engineering-Team von HubSpot wird benachrichtigt, wenn dieser Typ von Fehler auftritt. Es untersucht dann, wie es den Fehler beheben kann.

Bitte beachten Sie: Es ist möglich, 100 Salesforce-Fehler auf einmal zu resynchronisieren. Um mehr als 100 Fehler zu synchronisieren, importieren Sie die Datensätze aus Salesforce oder aktualisieren Sie eine zugeordnete Eigenschaft 

Benachrichtigungen zu Synchronisierungsfehlern einrichten

• Gehen Sie in Ihrem HubSpot-Account zu Datenmanagement > Integrationen.
• Klicken Sie in der Liste der verknüpften Apps auf „Salesforce“. 
• Klicken Sie auf die Registerkarte „Synchronisierungszustand“.
• Klicken Sie unter „Synchronisierungsfehler“ auf „Benachrichtigungen verwalten“. 
• Klicken Sie im Dialogfeld auf den Schalter „Benachrichtigungen aktivieren“, um ihn zu aktivieren. 
• Wählen Sie das Optionsfeld neben „Sofort“, „Täglich“ oder „Wöchentlich“ aus, um die Häufigkeit Ihrer Benachrichtigungen festzulegen. 
• Klicken Sie auf „Speichern“.