Zum Hauptinhalt springen
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

1

Öffnen Sie Einstellungen → HubSpot

Gehen Sie in der Flowella-App zu Einstellungen → HubSpot.
2

Lesen Sie die Statusplakette

Ein grünes Verbunden-Badge bedeutet, dass der OAuth-Token gültig ist. Ein rotes Reconnect-Banner bedeutet, dass der Token widerrufen wurde oder abgelaufen ist.
3

Bei Bedarf neu verbinden

Klicken Sie auf Wiederverbinden und führen Sie HubSpot OAuth erneut durch. Versuchen Sie dann erneut, die fehlgeschlagene Aktion auszuführen.
Häufige Ursachen für das Scheitern einer HubSpot-Verbindung:
  • Der Benutzer HubSpot, der Flowella autorisiert hat, wurde aus dem Portal entfernt.
  • HubSpot hat den Token gedreht, weil er in letzter Zeit nicht verwendet wurde.
  • Ein Super Admin hat die Integration von Flowella in den App-Einstellungen von HubSpot deaktiviert.

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

FehlerWas ist zu tun
Channel not foundDer Arbeitsablauf verweist auf einen Kanal, der nicht mehr existiert. Bearbeiten Sie die Aktion und wählen Sie einen aktuellen Kanal. Siehe Multi-Channel.
Template not approvedDie Vorlage, auf die verwiesen wird, hat ihren Status in REJECTED, PAUSED oder DISABLED geändert. Siehe Vorlage abgelehnt.
Contact opted outDer Kontakt hat sich für diesen Kanal abgemeldet. Respektieren Sie die Abmeldung - umgehen Sie sie nicht.
Phone number invalidDas Telefon des Kontakts ist nicht in E.164. Siehe Rufnummernformat.
Subscription requiredIhr Flowella-Tarif umfasst diese Aktion nicht, oder Ihr Abonnement ist abgelaufen. Siehe Abrechnung.

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?

Erfassen Sie das Folgende, bevor Sie sich an support wenden:
  • Den Zeitstempel der letzten Synchronisierung aus Einstellungen → HubSpot.
  • Die genaue Fehlermeldung (oder Screenshot), die Flowella oder HubSpot zurückgegeben hat
  • Die betroffene Kontakt-ID und Workflow-ID