> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ihren ersten WhatsApp Flow aus einem HubSpot-Formular senden

> Machen Sie aus einem HubSpot-Formular einen WhatsApp Flow, fügen Sie ihn einer Vorlage hinzu, testen Sie ihn auf Ihrem Telefon und senden Sie ihn dann aus einem HubSpot-Workflow, damit die Antworten in HubSpot ankommen.

In diesem Tutorial machen Sie aus einem HubSpot-Marketingformular einen WhatsApp Flow, senden ihn an Ihr eigenes Telefon und senden ihn dann aus einem HubSpot-Workflow. Am Ende erscheint ein ausgefüllter Flow in HubSpot als Übermittlung des ursprünglichen Formulars.

Der Zeitaufwand beträgt laut den Schätzungen im Einrichtungsleitfaden von Flowella etwa 50 Minuten aktive Arbeit, plus bis zu 24 Stunden, während Meta Ihre Vorlage prüft.

## Bevor Sie beginnen

* Lesen Sie [Bevor Sie beginnen](https://knowledge.flowella.io/de/before-you-start.md) und halten Sie Ihre Zugänge zu Meta und HubSpot bereit.
* Die Unternehmensverifizierung bei Meta muss abgeschlossen sein, bevor Sie in Meilenstein 3 einen Flow erstellen können. Siehe [Unternehmensverifizierung](https://knowledge.flowella.io/de/meta/business-verification.md).
* Halten Sie Ihr eigenes Telefon mit WhatsApp bereit, und zwar mit einer privaten Nummer statt der Unternehmensnummer, die Sie verbinden.
* Wählen oder erstellen Sie ein kurzes HubSpot-Marketingformular zum Testen. Fügen Sie ein E-Mail-Feld hinzu: HubSpot verwendet die E-Mail-Adresse, um eine Formularübermittlung einem Kontakt zuzuordnen.
* Meilenstein 6 benötigt HubSpot-Workflows, die in den Tarifen Professional und Enterprise von HubSpot enthalten sind. Ohne sie endet das Tutorial bei Meilenstein 5.

Wenn WhatsApp und HubSpot bereits verbunden sind, springen Sie zu Meilenstein 3.

## Wie die Teile zusammenpassen

Das Diagramm zeigt die Reihenfolge, in der ein Flow erstellt, genehmigt, gesendet und an HubSpot zurückgegeben wird.

```mermaid theme={null}
sequenceDiagram
    actor M as Marketer
    participant HS as HubSpot
    participant F as Flowella
    participant WA as WhatsApp
    actor C as Kunde
    M->>HS: Marketingformular erstellen
    HS-->>F: Formular erscheint auf der Seite Flows
    M->>F: Create WA Flow
    F->>HS: Formular lesen
    F->>WA: Flow erstellen oder aktualisieren, dann veröffentlichen
    M->>F: Create template with this Flow
    F->>WA: Vorlage zur Genehmigung einreichen
    HS->>F: Workflow führt Send WhatsApp Template aus
    F->>C: Vorlagennachricht mit Flow-Schaltfläche
    C->>WA: Öffnet den Flow und sendet ihn ab
    WA->>F: Antworten
    F->>HS: Formularübermittlung beim zugeordneten Kontakt
    F-->>C: Dankesbildschirm oder ein zu behebender Fehler
    F->>HS: Ereignis Form Completed startet Folge-Workflows
```

## Meilenstein 1: WhatsApp und HubSpot verbinden

Etwa 16 Minuten.

**1. Organisation benennen**

Bei Ihrer ersten Anmeldung fordert Flowella Sie mit **Name your organisation** auf, die Organisation zu benennen. Geben Sie den Namen ein und wählen Sie **Continue**. Sie können WhatsApp erst verbinden, wenn die Organisation einen Namen hat.

**2. WhatsApp verbinden**

Gehen Sie zu **Settings → WhatsApp (Meta)** und wählen Sie **Connect WhatsApp**. Wählen oder erstellen Sie in Metas Registrierungsablauf Ihren WhatsApp Business Account (WABA), also das Konto bei Meta, das Ihre Nummern und Vorlagen enthält, und verifizieren Sie dann Ihre Telefonnummer.

**3. HubSpot verbinden**

Gehen Sie zu **Settings → HubSpot** und wählen Sie **Connect HubSpot**. Wählen Sie Ihr HubSpot-Konto aus und genehmigen Sie die Verbindung in HubSpot.

**Prüfen, ob es funktioniert hat:** Oben in der App zeigen die Status-Chips **WhatsApp** und **HubSpot** beide **Connected** an. Auf einem kleinen Bildschirm prüfen Sie **Settings → WhatsApp (Meta)**, wo Ihre Nummer unter **Connected WhatsApp numbers** aufgeführt ist, und **Settings → HubSpot**, wo **Connected** angezeigt wird.

Weitere Details zu jedem Schritt finden Sie unter [Flowella einrichten](https://knowledge.flowella.io/de/onboarding.md).

## Meilenstein 2: Ihre erste Nachricht senden

Etwa 2 Minuten.

1. Senden Sie von Ihrem Telefon eine beliebige WhatsApp-Nachricht an Ihre Unternehmensnummer. Dadurch öffnet sich das 24-Stunden-Fenster, Metas Kundenservice-Fenster, in dem Sie ohne Vorlage antworten können.
2. Öffnen Sie in Flowella den **Inbox** und wählen Sie die neue Konversation aus.
3. Geben Sie eine Antwort in **Type a message…** ein und drücken Sie die Eingabetaste.

**Prüfen, ob es funktioniert hat:** Die Antwort kommt auf Ihrem Telefon an. Mehr über Konversationen erfahren Sie unter [Inbox](https://knowledge.flowella.io/de/app/inbox.md).

## Meilenstein 3: Den Flow erstellen

Etwa 15 Minuten.

1. Erstellen oder wählen Sie in HubSpot Ihr Test-Marketingformular. Flowella konvertiert einzeilige Textfelder, mehrzeilige Textfelder sowie Felder für E-Mail, Telefon, Zahl, Dropdown, Optionsfeld, Kontrollkästchen und Datum und macht aus Dateifeldern eine Fotoauswahl. Felder, die es nicht konvertieren kann, lässt es weg, und ein nicht konvertierbares Pflichtfeld stoppt die Synchronisierung.
2. Öffnen Sie in Flowella **Flows**. Flowella aktualisiert die Liste der HubSpot-Formulare, wenn Sie die Seite öffnen. Wenn Ihr Formular nicht aufgeführt ist, wählen Sie die Aktualisierungsschaltfläche oben auf der Seite.
3. Suchen Sie Ihr Formular und wählen Sie in der Spalte **WhatsApp Flow** die Option **Create WA Flow**. Die Schaltfläche zeigt **Syncing…** an, während Flowella den Flow erstellt und in Ihrem WABA veröffentlicht.

**Prüfen, ob es funktioniert hat:** Die Zeile zeigt **Created** an, oder **Updated**, wenn Ihr WABA bereits einen Flow mit demselben Namen hatte, und die Schaltfläche ändert sich zu **Sync WA Flow**. Wählen Sie **Open in Meta**, um eine Vorschau des Flows anzuzeigen.

Der Flow hat einen Bildschirm mit den Fragen Ihres Formulars, betitelt mit dem Namen des Formulars, gefolgt von einem Dankesbildschirm. Flowella hat keinen Flow-Editor: Um die Fragen später zu ändern, bearbeiten Sie das Formular in HubSpot und wählen dann **Sync WA Flow**. Siehe [Flows](https://knowledge.flowella.io/de/app/flows.md) und [Best Practices für das Formulardesign](https://knowledge.flowella.io/de/app/form-design-best-practices.md).

## Meilenstein 4: Den Flow einer Vorlage hinzufügen

Etwa 5 Minuten, danach die Prüfung durch Meta.

Kontakte öffnen einen Flow über eine **Flow**-Schaltfläche in einer Vorlagennachricht, daher benötigt der Flow eine Vorlage. Nutzen Sie eine der beiden Optionen und reichen Sie die Vorlage dann ein.

### Option A: auf der Seite Flows beginnen

Nach der ersten erfolgreichen Synchronisierung Ihrer Organisation zeigt Flowella **Your form is now a WhatsApp Flow** an. Wählen Sie **Create template with this Flow**. Wenn Sie den Dialog nicht sehen, wählen Sie stattdessen **Create template** in der Zeile des Formulars.

Der Vorlageneditor öffnet sich mit einer **Flow**-Schaltfläche, die bereits mit Ihrem Flow verbunden ist. Ihr Schaltflächentext lautet **Continue** und kann geändert werden. Schreiben Sie die Nachricht, wählen Sie eine **Category** und geben Sie einen **Template name** aus Kleinbuchstaben, Ziffern und Unterstrichen ein.

### Option B: mit der Flowella-Startervorlage beginnen

1. Wählen Sie unter **Templates** die Option **New template** und dann **View starters** unter **Flowella Templates**.
2. Suchen Sie `flowella_start_flow` und wählen Sie **Use this starter**. Die Nachricht lautet `Hi {{1}}, tap below to complete a short form and we will get back to you.` und die Flow-Schaltfläche lautet **Open form**.
3. Wählen Sie im Feld **WhatsApp Flow** der Schaltfläche Ihren Flow aus. Flows werden unter dem Namen des HubSpot-Formulars aufgeführt, aus dem sie stammen.
4. Ändern Sie unter **Body variables** den **Fallback value** für `{{1}}` von `Alex` in etwas, das für alle passt, zum Beispiel `there`. Flowella sendet diesen Wert, wenn ein Kontakt keinen Vornamen hat.

Die Startervorlage verwendet die Kategorie **Marketing**. Wählen Sie vor dem Einreichen die Kategorie, die zu Ihrer Nachricht passt. Siehe [Preise und WhatsApp-Nachrichtenkategorien](https://knowledge.flowella.io/de/account/pricing-and-conversation-categories.md).

### Die Vorlage bei Meta einreichen

1. Wählen Sie **Save draft**.
2. Wählen Sie **Publish Template**, prüfen Sie die Kategorie und wählen Sie dann erneut **Publish Template**, um die Vorlage bei Meta einzureichen. Wenn die Nachricht Variablen wie `{{1}}` enthält, geben Sie zuerst für jede einen **Fallback value** an. Meta prüft ihn als Beispielwert der Variable. Siehe [Vorlagenvariablen](https://knowledge.flowella.io/de/app/template-variables.md#fallback-werte).
3. Warten Sie, bis sich der Status von **Pending** zu **Approved** ändert. Laut Meta kann eine Entscheidung bis zu 24 Stunden dauern.

**Prüfen, ob es funktioniert hat:** Der Status der Vorlage ist **Approved**. Wenn Meta sie ablehnt, siehe [Vorlage abgelehnt](https://knowledge.flowella.io/de/troubleshooting/template-rejected.md).

## Meilenstein 5: Den Flow auf Ihrem Telefon testen

Etwa 3 Minuten.

1. Öffnen Sie Ihre genehmigte Vorlage und wechseln Sie zum Tab **Send**.
2. Wählen Sie unter **Test Template** Ihr **Country**, geben Sie Ihre **WhatsApp Number** ein und füllen Sie eventuelle Vorlagenvariablen aus.
3. Wählen Sie **Send Test**.
4. Öffnen Sie auf Ihrem Telefon die Nachricht und tippen Sie auf die Flow-Schaltfläche. Füllen Sie das Formular mit Ihrer eigenen E-Mail-Adresse aus und senden Sie es ab.

**Prüfen, ob es funktioniert hat:**

* WhatsApp zeigt den Dankesbildschirm mit der Dankesnachricht Ihres HubSpot-Formulars an.
* Im **Inbox** von Flowella zeigt die Konversation eine Karte mit Ihren Antworten, markiert mit **Response sent**. Der Titel der Karte ist der Text der Flow-Schaltfläche oder **Flow response**.
* In HubSpot hat das Formular eine neue Übermittlung von einer Seite, die nach dem Formular benannt ist, zum Beispiel `WhatsApp Flow · Contact us`. HubSpot aktualisiert die Kontakteigenschaften, denen das Formular zugeordnet ist.
* Die Timeline des Kontakts zeigt ein Ereignis **Form Completed** mit einem Link **View submission**.

Flowella übermittelt die Antworten an das ursprüngliche HubSpot-Formular. Die Übermittlung und die Kontakteigenschaften erscheinen in HubSpot so, als wäre das Formular auf Ihrer Website ausgefüllt worden.

> [!NOTE]
>
> Dieser Test hakt im Einrichtungsleitfaden auch **Send a Flow from HubSpot** ab, weil dieser Schritt jeden ausgefüllten Flow zählt.

## Meilenstein 6: Den Flow aus einem HubSpot-Workflow senden

Etwa 10 Minuten.

> [!NOTE]
>
> Dieser Meilenstein benötigt HubSpot-Workflow-Aktionen und damit einen HubSpot-Tarif mit Workflows (Professional oder Enterprise). Öffnen Sie in Flowella **Settings → HubSpot** und prüfen Sie, ob **Custom workflow actions** unter **Unlocked** steht. Falls nicht, endet das Tutorial für Sie bei Meilenstein 5: Senden Sie Flows aus Flowella mit einem Testversand oder einem [Bulk-Versand](https://knowledge.flowella.io/de/app/bulk-send.md).

**1. Einen Testkontakt vorbereiten**

Verwenden Sie in HubSpot einen Kontakt mit Ihrer eigenen WhatsApp-Nummer im internationalen Format, zum Beispiel `+447700900123`, und Ihrer E-Mail-Adresse. Die Nachricht aus Meilenstein 2 hat möglicherweise bereits einen Kontakt für Ihre Nummer erstellt oder verknüpft. Siehe [Telefonnummernformat](https://knowledge.flowella.io/de/hubspot/phone-number-format.md).

**2. Einen kontaktbasierten Workflow erstellen**

Die Aktionen von Flowella laufen nur auf Kontakten. Legen Sie einen Registrierungsauslöser fest, den vorerst nur Ihr Testkontakt erfüllt, zum Beispiel einen Eigenschaftswert oder eine Liste.

**3. Send WhatsApp Template hinzufügen**

Fügen Sie die Flowella-Aktion **Send WhatsApp Template** hinzu. Wählen Sie unter **Template Name** Ihre Flow-Vorlage. Nur genehmigte Vorlagen erscheinen in der Liste. Wählen Sie unter **Contact Phone Number** die Kontakteigenschaft, die die WhatsApp-Nummer enthält. Wenn Ihre Vorlage eine Variable hat, ordnen Sie **Template Variable 1** eine Eigenschaft wie den Vornamen zu. Siehe [Send WhatsApp Template](https://knowledge.flowella.io/de/hubspot/workflow-actions.md#send-whatsapp-template).

**4. Auf den Flow warten**

Fügen Sie einen Schritt **Delay until event** für das Flowella-Ereignis **Form Completed** hinzu. Filtern Sie ihn nach **Form Name**, sodass er dem Namen Ihres HubSpot-Formulars entspricht, und legen Sie fest, wie lange gewartet werden soll, zum Beispiel einen Tag.

**5. Festlegen, was als Nächstes passiert**

Verzweigen Sie für Kontakte, die den Flow ausfüllen, anhand der Kontakteigenschaften, die das Formular geschrieben hat, oder erstellen Sie eine Aufgabe. Das Ereignis **Form Completed** erfasst den Formularnamen und die Quelle, nicht die Antworten. Senden Sie Kontakten, die den Flow nicht rechtzeitig ausfüllen, eine Erinnerungsvorlage oder erstellen Sie eine Aufgabe.

**6. Den Workflow aktivieren**

Aktivieren Sie den Workflow und registrieren Sie Ihren Testkontakt.

**Prüfen, ob es funktioniert hat:**

* Die Vorlage kommt auf Ihrem Telefon an, und der Workflow-Verlauf des Kontakts zeigt die Aktion **Send WhatsApp Template** als abgeschlossen an. Flowella schließt die Aktion ab, wenn WhatsApp den ersten Status der Nachricht meldet, normalerweise "gesendet".
* Nachdem Sie den Flow ausgefüllt haben, geht der Kontakt über den Schritt **Delay until event** hinaus weiter, und die Übermittlung erscheint wie in Meilenstein 5 beim HubSpot-Formular.
* Im Einrichtungsleitfaden ist **Send a template from HubSpot** abgehakt.

**Form Completed** wird nur ausgelöst, wenn jemand einen WhatsApp Flow über Flowella absendet, niemals bei Website-Übermittlungen desselben Formulars. Vollständige Workflows nach diesem Muster finden Sie in den [Workflow-Leitfäden](https://knowledge.flowella.io/de/hubspot/workflows/overview.md).

## Fehlerbehebung

> **Create WA Flow ist ausgegraut**
>
> Bewegen Sie den Mauszeiger über die Schaltfläche, um den Grund zu sehen. Die häufigste Meldung ist "Meta business verification is required before publishing flows." Die Schaltfläche ist auch nicht verfügbar, wenn WhatsApp nicht verbunden ist, wenn das Formular keine Felder enthält, die WhatsApp Flows unterstützen, oder wenn Ihr Tarif keine Synchronisierung erlaubt. Siehe [Flows](https://knowledge.flowella.io/de/app/flows.md) und [Probleme beim Onboarding](https://knowledge.flowella.io/de/troubleshooting/onboarding.md).

> **Die Synchronisierung schlägt fehl**
>
> Die Zeile zeigt eine Bezeichnung wie **Not ready** an. Bewegen Sie den Mauszeiger über das Informationssymbol daneben, um den Grund zu sehen. Wenn ein Pflichtfeld aus HubSpot nicht in einem WhatsApp Flow erfasst werden kann, machen Sie das Feld optional oder ändern Sie seinen Typ in HubSpot und wählen Sie dann **Try again**. Siehe [Flows](https://knowledge.flowella.io/de/app/flows.md).

> **Mein Formular ist nicht auf der Seite Flows**
>
> Wählen Sie die Aktualisierungsschaltfläche oben auf **Flows**. Es erscheinen nur HubSpot-Marketingformulare. Wenn die Seite **Sample forms** anzeigt, kann Flowella Ihre HubSpot-Formulare noch nicht lesen: Prüfen Sie die Verbindung unter **Settings → HubSpot**. Siehe [Flows](https://knowledge.flowella.io/de/app/flows.md).

> **Die Vorlage ist nicht in der Liste der HubSpot-Aktion**
>
> Es erscheinen nur Vorlagen mit dem Status **Approved**. Warten Sie die Entscheidung von Meta ab und öffnen Sie die Aktion dann erneut. Siehe [HubSpot-Workflow-Aktionen](https://knowledge.flowella.io/de/hubspot/workflow-actions.md).

> **Der Flow zeigt beim Absenden einen Fehler an**
>
> "Missing required field" bedeutet meist, dass dem HubSpot-Formular nach der letzten Synchronisierung ein Pflichtfeld hinzugefügt wurde. Wählen Sie auf der Seite **Flows** die Option **Sync WA Flow** und senden Sie den Flow dann erneut. "Could not submit to HubSpot. Try again." bedeutet, dass HubSpot die Übermittlung nicht angenommen hat: Versuchen Sie es erneut und prüfen Sie, ob **Settings → HubSpot** **Connected** anzeigt.

> **Die Übermittlung ist keinem Kontakt zugeordnet**
>
> HubSpot ordnet Formularübermittlungen Kontakten anhand der E-Mail-Adresse zu. Fügen Sie dem Formular ein E-Mail-Feld hinzu oder stellen Sie sicher, dass der Kontakt in HubSpot eine E-Mail-Adresse hat.

> **Die Aktion Send WhatsApp Template schlägt fehl**
>
> Öffnen Sie den Workflow-Verlauf des Kontakts, um den Grund von Flowella zu sehen. Eine fehlende oder falsch formatierte Nummer schlägt mit `CONTACT_PHONE_MISSING` oder `CONTACT_PHONE_INVALID` fehl. Siehe [Telefonnummernformat](https://knowledge.flowella.io/de/hubspot/phone-number-format.md) und [HubSpot-Workflow-Aktionen](https://knowledge.flowella.io/de/hubspot/workflow-actions.md).

## Verwandt

> **[Flows](https://knowledge.flowella.io/de/app/flows.md)**
>
> Synchronisierungsstatus, Feldkonvertierung und Limits für WhatsApp Flows.

> **[Vorlagen](https://knowledge.flowella.io/de/app/templates.md)**
>
> WhatsApp-Vorlagen erstellen, testen und einreichen.

> **[HubSpot-Workflow-Aktionen](https://knowledge.flowella.io/de/hubspot/workflow-actions.md)**
>
> Jede Flowella-Aktion und jedes Ereignis, das in HubSpot-Workflows verfügbar ist.

> **[Workflow-Leitfäden](https://knowledge.flowella.io/de/hubspot/workflows/overview.md)**
>
> Fertige HubSpot-Workflow-Rezepte, die Flows verwenden.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.