HubSpot Sync-Fehler

Die meisten HubSpot-Probleme lassen sich in einen von drei Bereichen einordnen: Die Integration wurde getrennt, eine Feldzuordnung ist falsch oder eine Workflow-Aktion ist falsch konfiguriert. Auf dieser Seite gehen wir sie der Reihe nach durch. Für die Ersteinrichtung siehe HubSpot-Einrichtung. Für Workflow-Aktionen, siehe Workflow-Aktionen.

​

1. Prüfen Sie die Verbindung

​

2. Formulareinreichungen erscheinen nicht in HubSpot

Wenn ein Kontakt ein WhatsApp Flow ausfüllt, aber Sie können die Übermittlung nicht in HubSpot sehen:

​

Die Feldzuordnung stimmt nicht überein

Der Flow enthält möglicherweise ein Feld, das nicht mit einer HubSpot-Eigenschaft eines kompatiblen Typs übereinstimmt. Öffnen Sie das Formular auf der Seite Formulare und überprüfen Sie die Zuordnung für jedes Feld.

​

Erforderliches Feld ist leer

Wenn ein HubSpot-Formularfeld als erforderlich gekennzeichnet ist und WhatsApp Flow dem Benutzer erlaubt, es zu überspringen, wird die Übermittlung von HubSpot abgelehnt. Machen Sie das Feld in HubSpot optional oder im Flow erforderlich.

​

Format der Telefonnummer

HubSpot ist streng, was das Format der Telefonnummer angeht. Siehe Telefonnummernformat - die meisten Probleme mit “fehlenden Kontakten” hängen mit dem E.164-Format und dem nationalen Format zusammen.

​

Die Suche erfolgt nach der Ausführung der Workflow-Aktion.

Wenn Ihr HubSpot-Workflow sofort nach dem Absenden des Formulars ausgeführt wird, können Race Conditions dazu führen, dass der Workflow ausgelöst wird, bevor Flowella den Kontakt geschrieben hat. Fügen Sie eine kurze Verzögerung (1-2 Minuten) beim Start des Workflows hinzu, oder lösen Sie die Änderung der Kontakteigenschaft aus, anstatt die Übermittlung des Formulars.

​

3. Workflow-Aktionen werden blockiert oder schlagen fehl

Wenn ein HubSpot-Workflow, der eine Flowella-Aktion enthält, stecken bleibt:

​

Öffnen Sie den Aktionsverlauf des Workflows

Suchen Sie in HubSpot den Kontakt, scrollen Sie zu Workflowverlauf und klicken Sie auf den fehlgeschlagenen Lauf. HubSpot zeigt die Antwort, die Flowella für jede Aktion zurückgegeben hat.

​

Allgemeine Fehlerantworten

​

Template send suppressed as duplicate

Wenn HubSpot eine Aktion WhatsApp-Vorlage senden anzeigt, die mit dem Fehlergrund DUPLICATE_TEMPLATE_SEND_SUPPRESSED abgeschlossen wurde, hat Flowella den Versand absichtlich übersprungen, weil dieselbe Vorlage bereits an dieselbe Telefonnummer innerhalb des Deduplizierungsfensters gesendet wurde. Der häufigste Auslöser sind zwei HubSpot-Kontakte, die sich eine Telefonnummer teilen — zum Beispiel ein privater und ein beruflicher Datensatz oder ein Haushalt mit einer WhatsApp-Nummer — die sich innerhalb weniger Sekunden voneinander in denselben Workflow einschreiben. Nur der erste Versand geht an WhatsApp; der zweite wird unterdrückt, damit der Kontakt dieselbe Nachricht nicht zweimal erhält. Zuvor blieb die zweite Workflow-Aktion etwa eine Stunde lang auf Pending, bis das Callback-Timeout von HubSpot griff. Flowella schließt den Callback jetzt sofort als Fehler ab, sodass der angemeldete Kontakt ohne Wartezeit zum nächsten Schritt (oder in den „action failed”-Zweig) weitergeht. So unterscheiden Sie es von einem echten Fehler:

• Als Duplikat unterdrückt — der Fehlergrund lautet genau DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Die Vorlage wurde an diese Telefonnummer gesendet, nur über einen anderen angemeldeten Kontakt. Keine Aktion erforderlich.
• Echter Sendefehler — der Fehler enthält einen spezifischen Grund wie Template not approved, Phone number invalid, Contact opted out oder einen Meta-Graph-Fehlercode. Folgen Sie der Zeile in der Tabelle oben.

Wenn Sie legitim dieselbe Vorlage zweimal an dieselbe Nummer senden müssen (zum Beispiel eine erneute Bestätigung nach einer langen Verzögerung), verteilen Sie die Anmeldungen über das Deduplizierungsfenster hinaus oder verwenden Sie eine andere Vorlage.

​

Aktion existiert, bewirkt aber nichts

Wenn der Workflow ohne Fehler abläuft, aber keine Nachricht ankommt, überprüfen Sie dies noch einmal:

• Die Aktion ist aktiviert (nicht pausiert).
• Der Empfänger wurde im richtigen Schritt in den Workflow aufgenommen.
• Die Anmeldekriterien von HubSpot stimmen noch mit dem Kontakt überein.

​

4. Verwirrung bei der Synchronisierungsrichtung

Die Synchronisierung von Flowella ist bidirektional, aber teilweise:

• WhatsApp Flow Übermittlungen → schreiben Kontakteigenschaften in HubSpot.
• HubSpot-Workflow-Aktionen → senden WhatsApp-Nachrichten und Vorlagen.
• Eingehende WhatsApp-Antworten → protokollieren in der Zeitleiste des Kontakts (aktualisiert nicht automatisch die Eigenschaften).

Wenn Sie erwarten, dass eine Freiform-WhatsApp-Antwort eine Eigenschaft aktualisiert, ist ein zusätzlicher Schritt auf Ihrer Seite erforderlich - ein HubSpot-Workflow, der auf das Konversationsereignis wartet und die Antwort analysiert, oder eine benutzerdefinierte Integration über die API.

​

Stecken Sie immer noch fest?