Das Modul wurde in v2.6.31 von Formulare in Flows umbenannt. HubSpot-Quellobjekte werden weiterhin Formulare genannt — die Umbenennung wirkt sich nur auf den Flowella-Seitenleisten-Eintrag, die Seitenüberschrift und die URL aus. Lesezeichen auf
/{org}/forms funktionieren weiterhin: Flowella führt eine permanente 308-Weiterleitung auf /{org}/flows durch.So öffnen Sie sie
Gehen Sie in der linken Navigation zu Flows, oder:/{org}/{waba}/{phone}/flows. Die Liste ist dieselbe. Die Kanalzuordnung wird verwendet, wenn Sie einen Flow mit Meta synchronisieren.
Was die Liste zeigt
Jede Zeile stellt ein HubSpot-Formular dar. Zu den Spalten gehören:- Formularname und eine gekürzte HubSpot-Formular-ID mit einer Ein-Klick-Kopierschaltfläche.
- Feldanzahl — wie viele Felder das Formular hat, mit einer Markierung, wenn einige nicht unterstützt werden.
- Zuletzt in HubSpot geändert — aus HubSpots eigenem
updatedAtgezogen, damit Sie sehen können, wann sich die Formulardefinition selbst geändert hat. - WhatsApp Flow-Status — synchronisiert, Entwurf oder veraltet (HubSpot hat sich seit der letzten Synchronisierung geändert).
- Drift-Indikator — wenn das HubSpot-Formular seit dem letzten Bau des Flows bearbeitet wurde, zeigt die Zeile ein bernsteinfarbenes Label HubSpot-Formular seit Bau dieses Flows geändert — erneut synchronisieren, um es zu übernehmen. Lösen Sie eine neue Synchronisierung aus, um es zu löschen.
- WhatsApp Flow erstellen / WhatsApp Flow synchronisieren — die primäre Aktion. Das Label wechselt zu Synchronisieren, wenn bereits ein Flow existiert, und zu Veraltet — Synchronisierung erforderlich, wenn das HubSpot-Formular seit der letzten Synchronisierung bearbeitet wurde.
Hintergrund-Katalog-Synchronisierung
Flowella hält die Flows-Liste automatisch aktuell, sodass neu hinzugefügte oder umbenannte HubSpot-Formulare erscheinen, ohne dass Sie etwas anklicken müssen:- Wenn Sie die Seite öffnen, liefert Flowella den zwischengespeicherten Katalog sofort und stellt eine neue Synchronisierung im Hintergrund in die Warteschlange, wenn der Katalog älter als 5 Minuten ist.
- Alle 20 Minuten synchronisiert ein Hintergrund-Sweep den Katalog für jede Organisation neu, deren HubSpot-Integration VERBUNDEN ist, sodass die Listen auch für Tabs aktuell bleiben, die niemand geöffnet hat.
- Während eine Hintergrund-Synchronisierung läuft, zeigt der Header Wird aktualisiert… neben dem Aktualisierungssymbol. Wenn sie abgeschlossen ist, wechselt das Label zu Zuletzt vor 2 Minuten synchronisiert (oder die entsprechende relative Zeit). Die Liste wird an Ort und Stelle aktualisiert.
Formulardetails
Klicken Sie auf eine Zeile, um ihre Detailseite zu öffnen. Der Detail-Header zeigt dieselbe primäre Aktion WhatsApp Flow erstellen / synchronisieren wie die Listenzeile, sodass Sie nicht zurückgehen müssen, um Änderungen vorzunehmen. Von der Detailseite aus können Sie:- Die feldweise Zuordnung zwischen dem HubSpot-Formular und dem WhatsApp Flow überprüfen.
- Vergangene Sync-Läufe sehen — wann jeder gestartet wurde, Status (in Warteschlange, läuft, erfolgreich, fehlgeschlagen) und alle von Meta zurückgegebenen Fehler.
- Eine neue Synchronisierung auslösen, einen fehlgeschlagenen Lauf wiederholen oder eine noch laufende Synchronisierung abbrechen.
- Den entsprechenden Flow in der Meta Business Suite öffnen.
- Prüfen, aus welcher Version des HubSpot-Formulars der veröffentlichte Flow gebaut wurde. Wenn ein Flow synchronisiert wurde, zeigt der Header Flow gebaut aus HubSpot-Formular vom 12. Sep, 14:03. Vergleichen Sie dies mit dem aktuellen Wert Zuletzt in HubSpot geändert, um zu entscheiden, ob Sie erneut synchronisieren müssen.
Ein Formular mit einem WhatsApp Flow synchronisieren
Wenn Sie auf WhatsApp Flow erstellen oder WhatsApp Flow synchronisieren klicken, führt Flowella Folgendes aus:- Führt eine Vorabprüfung 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.
- Liest die neueste Formulardefinition aus HubSpot.
- Generiert das entsprechende WhatsApp Flow-JSON.
- Lädt es auf Meta auf dem von Ihnen ausgewählten Kanal hoch (kanalspezifisch).
- Zeichnet den Sync-Lauf auf der Detailseite auf und stempelt den Zeitstempel Flow gebaut aus HubSpot-Formular vom, sodass Drift bei späteren Änderungen erkannt werden kann.
Kanalzuordnungs-Gating
Flows sind organisationsweit in der Liste, aber kanalspezifisch beim Synchronisieren — ein Flow muss gegen eine bestimmte WABA + Telefonnummer-Kombination hochgeladen werden.
Wenn Sie Synchronisieren von der organisationsweiten URL klicken und Flowella nicht entscheiden kann, welchen Kanal es verwenden soll (keine Kanäle verbunden, mehrere Kanäle ohne festgelegten Bereich oder eine veraltete organisationsübergreifende Sitzung), bleibt die Schaltfläche mit einem Tooltip vordeaktiviert, der erklärt, was fehlt. Wechseln Sie über den Kanalwechsler in den richtigen Kanal, oder öffnen Sie
/{org}/{waba}/{phone}/flows direkt.
Sync-Fehler-UX
Wenn eine Synchronisierung fehlschlägt, verwandelt Flowella die Laufzeile in eine einzelne umrissene Aktionsschaltfläche, sodass Sie aus derselben Zeile heraus vorwärts korrigieren können:
Die Zeile trägt außerdem ein benutzerfreundliches Fehler-Badge:
FLOW_SYNC_PREFLIGHT+ Meta-Fehler#133010(Telefon nicht registriert) — das Badge zeigt die gespeicherte Meta-Nachricht und einen Hinweis zur Telefonregistrierung, nicht ein generisches „nicht bereit”. Schließen Sie die Telefonregistrierung unter Einstellungen → Meta ab und versuchen Sie es erneut.QUEUE_FAILED— die Sync-Warteschlange konnte den Job nicht aufnehmen. Meist vorübergehend; erneut versuchen. Wenn es weiter besteht, ist die Plattform-Statusseite der nächste Ort zum Prüfen (siehe Status & Vorfälle).- Meta
validation_errors— das Badge fasst zusammen, welche Felder Meta abgelehnt hat, sodass Sie das HubSpot-Formular (oder die Feldzuordnung) anpassen und wiederholen können, ohne die Zeile zu verlassen.
Flow-Übermittlungen werden an den eingeschriebenen HubSpot-Kontakt angehängt
Wenn ein WhatsApp Flow aus einem HubSpot-Workflow gesendet wird, gibt Flowella jetzt die eingeschriebene HubSpot-Kontakt-ID durch den Flow weiter und fügt sie alshs_object_id ein, wenn die Übermittlung an HubSpot zurückgeschrieben wird. Dadurch wird die Übermittlung an den genau eingeschriebenen Kontakt angehängt — nicht an einen Doppelgänger-Datensatz — auch wenn die Telefonnummer mit mehreren Kontakten übereinstimmt, und es beseitigt den letzten Fall, in dem die HubSpot-Telefonsuche auf den falschen Datensatz zurückfallen konnte.
Wenn Ihre Organisation bereits veröffentlichte Flows hat, synchronisieren Sie jeden Flow einmal neu, damit das neue verborgene Feld in das Flow-JSON aufgenommen wird, das auf Meta hochgeladen wird:
1
Flows-Seite öffnen
Gehen Sie zu Flows und öffnen Sie jedes Formular, dessen WhatsApp Flow vor dieser Änderung erstellt wurde.
2
Frische Synchronisierung auslösen
Klicken Sie auf WhatsApp Flow synchronisieren in der Zeile (oder die primäre Aktion auf der Detailseite). Flowella lädt das Flow-JSON mit dem versteckten Kontakt-ID-Feld erneut auf Meta hoch.
3
Für jedes aktive Formular wiederholen
Nur Formulare, die aus HubSpot-Workflows gesendet werden, benötigen dies. Formulare, die außerhalb eines Workflow-Kontexts gesendet werden, sind nicht betroffen.
Fragetext in Rich-Text-Blöcken
Mit HubSpot können Sie ein Rich-Text-Element über einer Feldgruppe platzieren, sodass der Fragetext über der Eingabe und nicht innerhalb des Feldlabels steht. Flowella ordnet diese Blöcke im WhatsApp Flow neben den Eingaben ein:
Der Rich-Text erscheint vor den Eingaben in der Feldgruppe, sodass Kunden die Frage sehen und sie dann beantworten. Feldlabels werden in der App weiterhin angezeigt, halten Sie sie also kurz — siehe Best Practices für Formulardesign.
Wenn Sie bereits HubSpot-Formulare haben, die Rich-Text über Feldgruppen verwenden, synchronisieren Sie sie von der Formulardetailseite neu. Ältere Sync-Läufe erfassten nur Feldlabels, sodass der Rich-Text-Fragetext im veröffentlichten Flow fehlte, bis Sie erneut synchronisieren.
Formatierung des Dankeschön-Bildschirms
Dieselbe HTML → Flow-Komponenten-Zuordnung gilt jetzt für den Dankeschön-Text auf einem HubSpot-Formular. Überschriften, fetter Text, geschützte Leerzeichen und Aufzählungslisten überstehen die Synchronisierung, anstatt zu reinem Text reduziert zu werden, und die Fertig-Fußzeile bleibt erhalten.
Jeder Aufzählungspunkt wird als einzelne Zeile gerendert, sodass hübsch formatiertes HubSpot-Markup (ein
<p>, das in jedem <li> verschachtelt ist) keine verwaisten Aufzählungszeilen mehr in WhatsApp produziert. Überschriften über 80 Zeichen fallen weiterhin auf Fließtext zurück, wie an anderer Stelle im Flow.
Wenn ein Formular vor dieser Änderung synchronisiert wurde, trägt sein Flow immer noch den Klartext-Dankeschön-Text. Öffnen Sie die Formulardetailseite und synchronisieren Sie erneut, um die neue Formatierung zu übernehmen.
Beispieldaten
Wenn Sie noch keine HubSpot-Verbindung haben, rendert die Flows-Seite mit illustrativen Zeilen hinter einem „Beispieldaten”-Hinweis. Verbinden Sie HubSpot, um zu Ihren echten Formularen zu wechseln.Ein Formular kann perfekt synchronisieren und sich auf einem Telefon dennoch schlecht lesen. Lange Feldlabels werden auf dem Bildschirm gekürzt, am auffälligsten auf dem iPhone, und der falsche Fragetyp verschlimmert es. Siehe Best Practices für Formulardesign, bevor Sie ein Formular erstellen.
Verwandt
HubSpot-Einrichtung
Verbinden Sie das Portal, aus dem Flowella Formulare liest.
Formulardesign
Erstellen Sie HubSpot-Formulare, die auf jedem Gerät sauber gerendert werden.
Workflow-Aktionen
Flows aus einem HubSpot-Workflow auslösen.
Workflow-Anleitungen
End-to-End-Rezepte, die Formulare, Vorlagen und Workflows kombinieren.
HubSpot-Sync-Fehler
Diagnostizieren Sie Formularsynchronisierungsprobleme und fehlende Übermittlungen.
Multi-Channel
Flows werden pro Kanal synchronisiert — verstehen Sie die Zuordnung.
Datensicherheit
Wie Formularübermittlungen bei Übertragung und im Ruhezustand verschlüsselt werden.