Zum Inhalt springen
OmniChannels.ai

Kostenloses Tool

WhatsApp Flows Vorlagen als JSON, mit Vorschau

Zwölf kopierfertige WhatsApp-Flow-Vorlagen in sechs Sprachen, darunter Deutsch, Englisch und Arabisch, von Lead-Erfassung und Terminbuchung über NPS-Umfragen und KYC-Checklisten bis zur Anmeldung für Ramadan-Angebote. Sehen Sie jeden Screen im Smartphone-Rahmen, kopieren oder laden Sie das Flow JSON herunter und prüfen Sie Ihr eigenes JSON gegen die von Meta dokumentierten Regeln.

Kostenlos · ohne Anmeldung · im Browser

Vorlagen anzeigen für

Lead-Erfassung

Sprache der Vorlage

Flow JSON (Version 7.3)

{
  "version": "7.3",
  "screens": [
    {
      "id": "CONTACT",
      "title": "Ihre Angaben",
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Erzählen Sie uns von sich"
          },
          {
            "type": "TextBody",
            "text": "Das dauert weniger als eine Minute. Wir verwenden Ihre Angaben nur, um auf Ihre Anfrage zu antworten."
          },
          {
            "type": "TextInput",
            "name": "full_name",
            "label": "Vollständiger Name",
            "input-type": "text",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "company",
            "label": "Unternehmen",
            "input-type": "text",
            "required": false
          },
          {
            "type": "TextInput",
            "name": "email",
            "label": "E-Mail",
            "input-type": "email",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "phone",
            "label": "Mobilnummer",
            "input-type": "phone",
            "required": true,
            "helper-text": "Mit Ländervorwahl, zum Beispiel +49"
          },
          {
            "type": "Footer",
            "label": "Weiter",
            "on-click-action": {
              "name": "navigate",
              "next": {
                "type": "screen",
                "name": "NEEDS"
              },
              "payload": {}
            }
          }
        ]
      }
    },
    {
      "id": "NEEDS",
      "title": "Ihre Anfrage",
      "terminal": true,
      "success": true,
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "RadioButtonsGroup",
            "name": "interest",
            "label": "Wofür interessieren Sie sich?",
            "required": true,
            "data-source": [
              {
                "id": "demo",
                "title": "Eine Produktdemo"
              },
              {
                "id": "pricing",
                "title": "Preise"
              },
              {
                "id": "partnership",
                "title": "Partnerschaft"
              },
              {
                "id": "other",
                "title": "Etwas anderes"
              }
            ]
          },
          {
            "type": "Dropdown",
            "name": "timeline",
            "label": "Wann starten Sie?",
            "required": true,
            "data-source": [
              {
                "id": "now",
                "title": "Sofort"
              },
              {
                "id": "one_three",
                "title": "In 1 bis 3 Monaten"
              },
              {
                "id": "later",
                "title": "Später in diesem Jahr"
              },
              {
                "id": "exploring",
                "title": "Ich informiere mich nur"
              }
            ]
          },
          {
            "type": "RadioButtonsGroup",
            "name": "call_time",
            "label": "Beste Zeit für einen Anruf",
            "required": false,
            "data-source": [
              {
                "id": "morning",
                "title": "Vormittags"
              },
              {
                "id": "afternoon",
                "title": "Nachmittags"
              },
              {
                "id": "evening",
                "title": "Abends"
              }
            ]
          },
          {
            "type": "TextArea",
            "name": "message",
            "label": "Nachricht",
            "required": false,
            "helper-text": "Was sollten wir vor unserem Anruf wissen?"
          },
          {
            "type": "OptIn",
            "name": "marketing_opt_in",
            "label": "Senden Sie mir Produktneuigkeiten und Angebote per WhatsApp. Ich kann jederzeit mit STOP abbestellen.",
            "required": false
          },
          {
            "type": "Footer",
            "label": "Anfrage senden",
            "on-click-action": {
              "name": "complete",
              "payload": {
                "full_name": "${screen.CONTACT.form.full_name}",
                "company": "${screen.CONTACT.form.company}",
                "email": "${screen.CONTACT.form.email}",
                "phone": "${screen.CONTACT.form.phone}",
                "interest": "${form.interest}",
                "timeline": "${form.timeline}",
                "call_time": "${form.call_time}",
                "message": "${form.message}",
                "marketing_opt_in": "${form.marketing_opt_in}"
              }
            }
          }
        ]
      }
    }
  ]
}

Fügen Sie es in den Flow-Editor im WhatsApp Manager ein oder laden Sie es über die Flows API hoch. Ersetzen Sie die Beispiel-URL für den Datenschutz durch Ihre eigene. Diese Vorlagen laufen ohne Daten-Endpoint und brauchen daher weder data_api_version noch routing_model.

Nachricht, die den Flow öffnet (Cloud API)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "interactive",
  "interactive": {
    "type": "flow",
    "header": {
      "type": "text",
      "text": "Sprechen Sie mit uns"
    },
    "body": {
      "text": "Teilen Sie uns ein paar Angaben mit, und die richtige Ansprechperson meldet sich innerhalb eines Werktags bei Ihnen."
    },
    "action": {
      "name": "flow",
      "parameters": {
        "flow_message_version": "3",
        "flow_token": "<UNIQUE_FLOW_TOKEN>",
        "flow_id": "<FLOW_ID>",
        "flow_cta": "Kontakt aufnehmen",
        "flow_action": "navigate",
        "flow_action_payload": {
          "screen": "CONTACT"
        }
      }
    }
  }
}

Eine interaktive Nachricht kann nur innerhalb des 24-Stunden-Kundenservice-Fensters gesendet werden. Wenn Sie das Gespräch selbst beginnen möchten, hängen Sie den Flow an eine genehmigte Nachrichtenvorlage mit Flow-Button.

Diese WhatsApp-Flows-Regeln befolgen die Vorlagen

  • Flow JSON 7.3 ist die Version, die Meta für das Veröffentlichen neuer Flows empfiehlt.
  • Ein Flow ohne Daten-Endpoint braucht nur version und screens; das Routing-Modell erzeugt Meta selbst.
  • Jeder Flow endet auf einem terminalen Screen mit einem Footer, der die Aktion complete ausführt.
  • Limits pro Screen: 50 Komponenten, 1 Footer, 2 eingebettete Links, 3 Bilder und 5 Einwilligungen (OptIn).
  • Labels sind kurz: 20 Zeichen für Textfelder und Dropdowns, 30 für Radio- und Checkbox-Gruppen, 35 für den Footer-Button.
  • Screen-ids bestehen nur aus Buchstaben und Unterstrichen, und SUCCESS ist reserviert.

Regeln am 2026-10-10 mit der WhatsApp-Flows-Dokumentation von Meta abgeglichen.

Wir bauen und hosten Flows mit Ihrem Daten-Endpoint

Sie brauchen freie Termine, Preise oder Kontodaten live im Flow? Unser Team gestaltet die Screens, entwickelt und hostet den verschlüsselten Daten-Endpoint und verbindet die Antworten mit Ihrem CRM. Kontaktieren Sie den Vertrieb für ein Angebot.

Ihre Eingaben werden nicht an unsere Server gesendet.

Kurze Antwort

Ein WhatsApp Flow ist eine Folge von Screens im Chat, die in Flow JSON beschrieben wird. Der einfachste gültige Flow hat eine Version, etwa 7.3, und ein Array screens. Jeder Screen hat eine id aus Buchstaben und Unterstrichen, ein SingleColumnLayout mit Komponenten und einen Footer-Button. Mit navigate geht es zum nächsten Screen; der letzte ist als terminal markiert und führt complete aus, das die Antworten an Ihren Webhook sendet.

So nutzen Sie eine WhatsApp-Flow-Vorlage

  1. 1

    Vorlage auswählen

    Wählen Sie einen Anwendungsfall wie Lead-Erfassung, Tischreservierung oder Support-Ticket und wechseln Sie zwischen den Sprachfassungen.

  2. 2

    Screens ansehen

    Tippen Sie in der Vorschau auf den Button und gehen Sie die Screens in genau der Reihenfolge durch, in der Ihre Kunden sie sehen.

  3. 3

    JSON kopieren oder herunterladen

    Fügen Sie das Flow JSON in den Flow-Editor im WhatsApp Manager ein oder laden Sie es über die Flows API hoch und veröffentlichen Sie es.

  4. 4

    Änderungen prüfen

    Fügen Sie Ihr geändertes JSON in den Validator ein, um fehlerhafte Routen, fehlende Felder und zu lange Labels zu finden.

Was in einer Flow-JSON-Datei steht

Flow JSON hat zwei Pflichteigenschaften: version und screens. Jeder Screen hat eine id, einen optionalen title für die obere Leiste und ein layout vom Typ SingleColumnLayout, dessen children Komponenten sind: Texte, Eingabefelder, Auswahllisten, Datumsauswahl, Einwilligungen und genau ein Footer-Button.

Die Navigation steckt in Aktionen. Ein Footer mit navigate öffnet den nächsten Screen; auf dem letzten, als terminal markierten Screen schließt ein Footer mit complete den Flow und sendet den Payload zusammen mit dem Flow-Token an das Unternehmen. Seit Flow JSON 4.0 kann jeder Screen Felder früherer Screens mit ${screen.SCREEN_ID.form.field} lesen. Deshalb bleiben die navigate-Payloads in den Vorlagen leer, und alle Antworten landen im abschließenden complete-Payload.

  • version: die Flow-JSON-Version, in allen Vorlagen „7.3“.
  • screens: die geordnete Liste der Screens; der erste ohne eingehende Route ist der Einstiegsscreen.
  • routing_model und data_api_version: nur für Flows, die Ihren Daten-Endpoint aufrufen.
  • terminal und success: markieren den letzten Screen und ob ein Abschluss dort als Erfolg zählt.

Flows mit oder ohne Daten-Endpoint

Alle zwölf Vorlagen kommen ohne Endpoint aus. Sie brauchen keinen Server: Die Optionen stehen im JSON, Meta erzeugt das Routing-Modell, und Sie erhalten die Antworten an Ihrem Webhook, sobald der Kunde den Flow abschließt. Meta empfiehlt Flows ohne Endpoint immer dann, wenn keine Live-Daten nötig sind, weil sie schneller öffnen und schneller gebaut sind.

Ein Endpoint lohnt sich, wenn ein Screen Live-Daten braucht: freie Termine, wechselnde Preise, Lagerbestand oder eine Prüfung gegen das Kundenkonto. Dann nutzen die Screens data_exchange, der Flow braucht data_api_version und ein routing_model, und Ihr Endpoint muss jede Anfrage entschlüsseln und innerhalb des Zeitlimits von Meta antworten. Genau diesen Teil bauen und hosten wir für unsere Kunden.

Zeichenlimits und Regeln für Komponenten

Die meisten abgelehnten Flows scheitern an kleinen Regeln. Labels sind kurz: 20 Zeichen für Textfeld, Textbereich oder Dropdown, 30 für Radio- und Checkbox-Gruppen, 40 für die Datumsauswahl und 35 für den Footer-Button. Optionstitel dürfen 30 Zeichen haben, Beschreibungen 300. Überschriften fassen 80 Zeichen, Fließtext 4.096.

Pro Screen sind bis zu 50 Komponenten, ein Footer, zwei eingebettete Links, drei Bilder und fünf Einwilligungen erlaubt. Screen-ids bestehen nur aus Buchstaben und Unterstrichen, und SUCCESS ist reserviert. Arabische Labels zählen Zeichen, nicht Bytes. Der Validator prüft all das und nennt den Screen, den Sie korrigieren müssen.

Arabische Flows von rechts nach links für Kunden am Golf

Jede Vorlage gibt es in einer muttersprachlichen arabischen Fassung mit denselben Screens und Feldnamen. Ihr Webhook-Code verarbeitet so beide Sprachen ohne Änderungen. WhatsApp zeigt arabische Flows auf dem Smartphone des Kunden von rechts nach links an, und die Vorschau tut das ebenfalls.

Die Bibliothek enthält Anwendungsfälle, die am Golf wichtig sind: Anmeldung für Ramadan- und Eid-Angebote mit Versand nach dem Iftar, Tischreservierung im Restaurant, Anfragen zur Immobilienbesichtigung und eine KYC-Checkliste, die Kunden bittet, keine Ausweisfotos in den Chat zu schicken.

So senden Sie einen Flow an Kunden

Nach dem Veröffentlichen senden Sie den Flow als interaktive Nachricht vom Typ flow mit seiner Flow-ID, einem selbst erzeugten Flow-Token, einem kurzen Button-Text und dem ersten Screen. Die Bibliothek liefert den Nachrichten-Payload für jede Vorlage. Interaktive Nachrichten funktionieren nur im 24-Stunden-Kundenservice-Fenster; wenn Sie Kunden zuerst anschreiben möchten, hängen Sie den Flow an eine genehmigte Nachrichtenvorlage mit Flow-Button.

Schließt der Kunde ab, zeigt WhatsApp ihm eine Zusammenfassung seiner Antworten, und Sie erhalten den complete-Payload an Ihrem Webhook. Antworten Sie mit einer Bestätigung, die die nächsten Schritte nennt und erklärt, wie man ändert oder storniert.

WhatsApp Flows als JSON: häufige Fragen

Welche Flow-JSON-Version sollte ich verwenden?

Verwenden Sie 7.3, die Version, die Meta laut Changelog zum Zeitpunkt unserer Prüfung für neue Flows empfahl. Ältere Versionen wie 5.0 sind eingefroren: Flows damit lassen sich noch senden, aber nicht mehr veröffentlichen.

Brauche ich für diese Vorlagen einen Server oder Daten-Endpoint?

Nein. Alle Vorlagen laufen ohne Endpoint. Die Optionen stehen im JSON, und die Antworten kommen an Ihrem Webhook an, wenn der Kunde den letzten Button tippt. Einen Endpoint brauchen Sie nur für Live-Daten wie freie Termine oder Preise.

Wie nutze ich eine Vorlage im WhatsApp Manager?

Legen Sie im WhatsApp Manager einen Flow an, öffnen Sie den JSON-Editor, ersetzen Sie den Inhalt durch die Vorlage, prüfen Sie die Vorschau und veröffentlichen Sie. Alternativ erstellen und veröffentlichen Sie den Flow über die Flows API.

Kann ich Labels und Optionen anpassen?

Ja. Ändern Sie beliebige Texte, fügen Sie Optionen und Felder hinzu oder entfernen Sie sie, und fügen Sie das JSON dann in den Validator ein. Er warnt, wenn ein Label das Zeichenlimit überschreitet oder eine Route auf einen nicht mehr vorhandenen Screen zeigt.

Warum lässt sich mein Flow nicht veröffentlichen?

Häufige Ursachen sind ein zu langes Label, eine Screen-id mit Ziffern oder Bindestrichen, ein terminaler Screen ohne Footer, die Aktion complete auf einem nicht terminalen Screen und data_exchange ohne data_api_version und routing_model.

Laufen die arabischen Vorlagen von rechts nach links?

Ja. Sie sind auf Arabisch geschrieben, und WhatsApp zeigt sie von rechts nach links an. Feldnamen und Options-ids bleiben englisch, sodass derselbe Webhook-Code für beide Sprachen funktioniert.

Kann ein Flow Ausweisdokumente einsammeln?

Flows bieten Komponenten zur Foto- und Dokumentauswahl, aber sensible Uploads erfordern große Sorgfalt. Die KYC-Vorlage fragt nur ab, welche Unterlagen der Kunde hat, und vereinbart eine sichere Übergabe, damit keine Ausweisbilder im Chat landen.

Ist dieser Validator derselbe wie bei Meta?

Nein. Er führt einfache statische Prüfungen auf Basis der von Meta dokumentierten Fehler durch. Metas Validator im WhatsApp Manager prüft zusätzlich Ausdrücke und Datenmodelle. Veröffentlichen Sie erst, wenn er keine Fehler mehr meldet.

Weitere kostenlose Tools