CRM-Sync-Fehler beheben

Warum CRM-Sync fehlschlägt, wo die Symptome auftauchen und was zu tun ist — Token-Ablauf, Schema-Drift, Rate-Limits, fehlende Datensätze und festhängende Initial-Syncs.

Die meisten CRM-Sync-Probleme fallen in eine kleine Reihe von Fehlerklassen. Diese Seite ordnet jedem Symptom die Ursache und die Lösung zu. Sync-Fehler haben in bont keine eigene Seite — sie erscheinen als Status-Badges auf der Integrations-Karte (Einstellungen → Integrationen → CRM), als Toast-Meldungen bei fehlgeschlagenen Operationen und als veraltete Zahlen in Dashboards.

Wo zuerst nachsehen

Die Integrations-Karte unter Einstellungen → Integrationen → CRM. Ein rotes Badge auf der verbundenen Karte heißt: bont stuft die Verbindung als ungesund ein.
Dashboard-Zeitstempel. Viele Sichten zeigen einen „Last synced"-Hinweis. Ist er Stunden alt, obwohl er Minuten sein sollte, ist der Sync beeinträchtigt.
Toasts. Manuell ausgelöste Operationen (z. B. ein Deal öffnen, eine Pipeline aktualisieren) zeigen Toast-Meldungen bei Fehlern.

Häufige Symptome und Lösungen

Karte zeigt Reconnect (oder einen Auth-Fehler)

Token abgelaufen oder widerrufen. Auf der Karte Reconnect klicken und die OAuth-Scopes erneut bestätigen. Siehe Integration neu verbinden oder trennen.

Initial-Sync hängt offenbar fest

Zeit lassen — sehr große CRMs brauchen für den ersten Lauf manchmal mehrere Stunden.
Bei längerer Wartezeit die Integrations-Karte prüfen — ein Auth-Fehler mitten im Sync sieht aus wie „hängt", ist aber tatsächlich „nicht authentifiziert".
Im äußersten Fall trennen und neu verbinden. bont fährt fort, wo er aufgehört hat, falls nur das Token Schuld war; bei geänderter Identität läuft ein voller Re-Sync.

Ein bestimmter Datensatz wurde nicht synchronisiert

Feld-Berechtigungen — bont liest nur das, was das verbindende Admin-Konto sehen darf. Verbirgt ein CRM-Permission-Set bestimmte Felder vor diesem Admin, erscheinen sie in bont leer.
Filter — pure bont und funky bont wenden Segmente / Active-Filter an, die Datensätze ausblenden können; Segment-Definition prüfen.
Custom-Object-Datensätze — bont deckt die Standard-CRM-Objekte ab (Contacts, Accounts, Deals, Activities); vollständig kundenspezifische Objekte werden nicht synchronisiert.

Updates aus bont erscheinen nicht im CRM

Zwei-Wege-Sync schreibt im Namen des verbindenden Admins zurück. Hat dieser Admin keine Schreibrechte auf den Datensatz, scheitert der Write auf CRM-Seite still.
Feld-Validierungs-Regeln im CRM (Pflichtfelder, Picklist-Constraints) können Writes ablehnen. Der Toast in bont zeigt die zugrundeliegende Fehlermeldung — sorgfältig lesen; die Meldung kommt direkt von der CRM-API.

Rate-Limit-Fehler

bont drosselt sich deutlich unter den Provider-Limits, aber Massen-Operationen (z. B. ein großer Segment-Refresh) können kurzfristig in Limits laufen. Das System versucht automatisch mit Backoff erneut; bleibt ein Job über mehrere Retries hinaus fehlerhaft, an support@bont.ai schreiben — mit Workspace-Name und ungefährer Zeit des Fehlers.

Das CRM-Schema hat sich geändert, bont merkt nichts

bont liest das Schema periodisch erneut, aber umbenannte oder gelöschte Felder können einige Stunden brauchen, bis sie sichtbar werden — besonders, wenn sie in einem Field-Mapping benutzt wurden. CRM-Felder auf bont-Felder abbilden öffnen, prüfen, ob die Dropdowns noch die erwarteten CRM-Felder zeigen, und ggf. neu mappen.

Companies-/Contacts-Zähler stimmen nicht mit dem CRM überein

bont zählt, was nach der „aktiv"-Definition Ihres Plans synchronisierbar ist. Inaktive oder archivierte Datensätze fließen ggf. nicht ein.
Salesforce-Sandbox vs. Produktion liefern unterschiedliche Summen — prüfen Sie, welche Org verbunden ist.
Deduplizierung: bonts Company-Entität fasst nach Domain zusammen; das CRM tut das ggf. nicht, weshalb die Summen auseinanderdriften.

Wann eskalieren

Schreiben Sie an support@bont.ai, wenn:

Nach einer frischen OAuth zeigt die Karte weiter einen Fehler.
Ein Sync ist seit Stunden „in Bearbeitung" ohne sichtbaren Fortschritt.
Einzelne Datensätze inkonsistent synchronisieren ohne offensichtliche Berechtigungsursache.
Insights-/Forecasting-Zahlen nach einem Remap erkennbar falsch wirken.

Workspace-Name, CRM-Anbieter, ein paar Beispiel-Record-IDs (CRM-seitig) und ungefährer Fehler-Zeitpunkt — damit kann der Support die Upstream-Logs ziehen.