Skip to main content
Flowella forms synced from HubSpot
Auf der Seite Formulare sehen Sie jedes HubSpot-Formular, das Flowella für Ihr Unternehmen verfolgt, die WhatsApp Flow, die Flowella daraus erstellt hat, und ob dieser Flow mit Meta synchronisiert ist. Wie Sie die HubSpot-Integration überhaupt erst einrichten, erfahren Sie unter HubSpot-Einrichtung. Diese Seite befasst sich mit dem In-App-Bildschirm Formulare, nicht mit der Einrichtung der Integration.

Wie man sie öffnet

Gehen Sie zu Formulare in der linken Navigation, oder:
Sie können unter /{org}/{waba}/{phone}/forms auch Formulare öffnen, die einem bestimmten Kanal zugeordnet sind. Die Liste ist die gleiche - die Kanalzuordnung wird verwendet, wenn Sie einen Fluss mit Meta synchronisieren.

Was die Liste zeigt

Jede Zeile steht für ein HubSpot-Formular. Die Spalten enthalten:
  • Formularname und eine verkürzte HubSpot-Formular-ID mit einer Schaltfläche zum Kopieren mit einem Klick.
  • Feldanzahl - wie viele Felder das Formular hat, mit einer Markierung, wenn einige nicht unterstützt werden.
  • Letzte Änderung in HubSpot - wird aus HubSpots eigenem updatedAt gezogen, damit Sie erkennen können, wann die Formulardefinition selbst geändert wurde.
  • Katalog aktualisiert - wann Flowella die Formulardefinition aus HubSpot zuletzt aktualisiert hat.
  • Status von WhatsApp Flow - synchronisiert, Entwurf oder veraltet (HubSpot hat sich seit der letzten Synchronisierung geändert).
  • Erstellen WhatsApp Flow / Synchronisieren WhatsApp Flow - die primäre Aktion. Die Beschriftung wechselt zu Sync, wenn bereits ein Flow existiert und zu Stale - Sync needed, wenn das HubSpot-Formular seit der letzten Synchronisierung bearbeitet wurde.
Die Schaltfläche ist vordeaktiviert mit einem Tooltip, wenn sie nicht ausgeführt werden kann - zum Beispiel: HubSpot nicht verbunden, kein aktiver WhatsApp Kanal, Abrechnung inaktiv oder das Formular enthält nicht unterstützte Feldtypen. Der Tooltip erklärt genau, welche Voraussetzung fehlt. Wenn Ihr HubSpot-Konto noch keine Formulare synchronisiert hat, wird der Katalog beim ersten Besuch von Flowella automatisch gestartet, so dass Sie keinen initialen Pull auslösen müssen. Sie können die Liste filtern und durchsuchen, um schnell ein bestimmtes Formular zu finden.

Formular-Detail

Klicken Sie auf eine Zeile, um die Detailseite zu öffnen. Die Kopfzeile der Detailseite zeigt die gleiche Erstellen / Synchronisieren WhatsApp Flow Primäraktion wie die Listenzeile, so dass Sie nicht zurückgehen müssen, um Änderungen vorzunehmen. Von der Detailseite aus können Sie:
  • die Feld-für-Feld-Zuordnung zwischen dem HubSpot-Formular und dem WhatsApp Flow überprüfen.
  • Frühere Synchronisationsläufe einsehen - wann jeder gestartet wurde, den Status (in der Warteschlange, laufend, erfolgreich, fehlgeschlagen) und alle Fehler, die Meta zurückgegeben hat.
  • Lösen Sie eine neue Synchronisierung aus, wiederholen Sie einen fehlgeschlagenen Lauf oder brechen Sie eine noch laufende Synchronisierung.
  • Öffnen Sie den entsprechenden Flow in Meta Business Suite.

Synchronisierung eines Formulars mit einem WhatsApp Flow

Wenn Sie auf WhatsApp Flow erstellen oder WhatsApp Flow synchronisieren klicken, wird Flowella:
  1. Führt einen Vorabcheck durch - bestätigt, dass HubSpot verbunden ist, der aktive Kanal verifiziert ist, das Formular mindestens ein unterstütztes Feld hat und die Abrechnung aktiv ist.
  2. Liest die neueste Formulardefinition aus HubSpot.
  3. Erzeugt das entsprechende WhatsApp Flow JSON.
  4. Lädt es in Meta auf dem von Ihnen gewählten Kanal hoch (kanalübergreifend).
  5. Zeichnet den Sync-Lauf auf der Detailseite auf.
Die meisten Synchronisierungen dauern ein paar Sekunden. Wenn Meta den Datenfluss ablehnt, wird der Grund für den Fehlschlag in der Laufzeile als Benutzersichere Fehlermeldung (übersetzt aus Meta Graph) angezeigt - in der Regel aufgrund eines nicht unterstützten Feldtyps, eines Verifizierungsproblems im Channel oder einer nicht übereinstimmenden Kategorie. Versuchen Sie es erneut in der gleichen Zeile, sobald Sie die Ursache behoben haben.

Kanal-Scope-Gating

Formulare sind organisationsweit in der Liste, aber kanalspezifisch beim Synchronisieren - ein Flow muss gegen eine bestimmte WABA + Telefonnummer-Kombination hochgeladen werden. Wenn Sie auf Sync über die organisationsweite URL klicken und Flowella nicht entscheiden kann, welchen Kanal es verwenden soll (keine Kanäle verbunden, mehrere Kanäle ohne festgelegten Scope oder eine veraltete organisationsübergreifende Sitzung), bleibt die Schaltfläche vordeaktiviert mit einem Tooltip, der erklärt, was fehlt. Wechseln Sie über den Kanalwechsler in den richtigen Kanal oder öffnen Sie /{org}/{waba}/{phone}/forms direkt.

Sync-Fehler-UX

Wenn eine Synchronisierung fehlschlägt, verwandelt Flowella die Laufzeile in eine einzelne Aktionsschaltfläche im Outline-Stil, damit Sie aus derselben Zeile heraus weitermachen können: Die Zeile trägt außerdem ein benutzersicheres Fehlerabzeichen:
  • FLOW_SYNC_PREFLIGHT + Meta-Fehler #133010 (Telefon nicht registriert) - das Abzeichen zeigt die gespeicherte Meta-Nachricht und einen Hinweis zur Telefonregistrierung an, nicht ein allgemeines “nicht bereit”. Schließen Sie die Telefonregistrierung in Einstellungen → Meta ab und versuchen Sie es erneut.
  • QUEUE_FAILED - die Synchronisierungswarteschlange konnte den Job nicht aufnehmen. Normalerweise vorübergehend; erneut versuchen. Wenn es weiterhin auftritt, ist die Plattform-Statusseite der nächste Anlaufpunkt (siehe Status & Vorfälle).
  • Meta validation_errors - das Abzeichen fasst zusammen, welche Felder Meta abgelehnt hat, sodass Sie das HubSpot-Formular (oder die Feldzuordnung) anpassen und es erneut versuchen können, ohne die Zeile zu verlassen.
Der Lauf-Verlauf bleibt über Wiederholungen hinweg erhalten, sodass Sie sehen können, wie viele Versuche ein Formular benötigt hat und was sich zwischen ihnen geändert hat.

Beispieldaten

Wenn Sie noch keine HubSpot-Verbindung haben, wird die Seite Formulare mit illustrativen Zeilen hinter einem Aufruf “Beispieldaten” angezeigt. Verbinden Sie HubSpot, um zu Ihren echten Formularen zu wechseln.
HubSpot-Formulare mit nicht unterstützten Feldtypen (Datei-Upload, Signatur) können nicht in der aktuellen Form synchronisiert werden. Passen Sie das Formular in HubSpot an oder überspringen Sie diese Felder in WhatsApp Flow.

Verwandt

HubSpot-Einrichtung

Verbinden Sie das Portal, von dem Flowella Formulare liest.

Workflow-Aktionen

Auslösen von Flows aus einem HubSpot-Workflow.

Leitfäden zum Arbeitsablauf

End-to-End-Rezepte, die Formulare, Vorlagen und Workflows kombinieren.

HubSpot Synchronisationsfehler

Diagnostizieren Sie Probleme bei der Formularsynchronisation und fehlende Übermittlungen.

Mehrkanalige

Formulare werden pro Kanal synchronisiert - verstehen Sie das Scoping.

Datensicherheit

Wie Formularübermittlungen bei der Übertragung und im Ruhezustand verschlüsselt werden.
Zuletzt geändert am 5. Juli 2026