All Products
Search

This Product

    Chat App Message Service:Creating and using WhatsApp Flows in Chat App

    Document Center

    Chat App Message Service:Creating and using WhatsApp Flows in Chat App

    Last Updated:Jun 02, 2026

    WhatsApp Flows let businesses build structured, interactive experiences inside WhatsApp conversations—such as surveys, lead capture forms, and customer support workflows—without directing users to an external website.

    Create a WhatsApp Flow

    Method 1: Use the Chat App API

    Chat App Message Service provides an API to create a WhatsApp Flow. For more information, see WhatsApp Flow.

    Method 2: Use WhatsApp Manager

    Log in to the Meta WhatsApp Manager and follow the steps below to create a Flow.

    1. Open WhatsApp Manager.

    2. In the left navigation pane, click Flows.

      The Flows management page lists existing Flows by name, ID, status, and last updated time. A Create Flow button appears in the upper-right corner.

    3. Click Create Flow in the upper-right corner.

    4. Fill in the Flow details.

      On the Create Flow page, enter a Name (up to 200 characters, for example, Flow Demo) and select a Category (for example, Other). Under the template area, select the Without endpoint or With endpoint tab and choose a template: Default, Collect Shopping Interest, Get Feedback, Send Survey, or Customer Support. The Flow preview panel on the right shows a live mobile preview of the selected template.

    5. Click Create.

    6. Edit the Flow JSON in the editor.

      The editing page has a navigation pane on the left, a JSON editor in the middle, and a mobile preview panel on the right. In the JSON editor, define the Flow's screens structure and form components such as RadioButtonsGroup and TextArea. Error counts appear at the bottom of the editor. The preview panel renders the corresponding mobile interface in real time.

    7. Click Save.

    8. Click Publish to make the Flow available.

    Method 3: Use WhatsApp Playground

    1. Go to the WhatsApp Playground page.

    2. Edit the Flow in the editor and preview it in real time on the right.

      On the left side of the editor, manage multiple pages and add components such as Subtitle, Radio Button, Paragraph, and Button to each page. Click a component to edit its properties. Use the Copy Flow JSON button in the upper-right corner to export the Flow's JSON configuration.

    3. Click Copy Flow JSON.

    4. Follow the steps in Method 2 to create a WhatsApp Flow and open its editing page.

    5. Paste the copied JSON into the editor, replacing the existing content.

    6. Click Run.

      On the Flows editor page, the JSON editor is on the left and a mobile phone simulator on the right previews the Flow.

    7. Click Save.

    8. Click Publish to make the Flow available.

    Use WhatsApp Flows in Chat App

    WhatsApp Flows must be used within a message template.

    Note

    WhatsApp Flows are not supported in authentication message templates.

    Add a WhatsApp Flow to a message template

    1. Go to the Template Design page and create a template.

      Note

      The WABA for the current channel must match the WABA used to create and publish the WhatsApp Flow.

    2. On the Template Design page, click the Flow icon to add a WhatsApp Flow button.

    3. Set the button text.

    4. Click Sync Flow to fetch published Flows from your WABA.

    5. From the drop-down list, select the WhatsApp Flow to use.

      To refresh the list, click the refresh icon or the Sync Flow link. In the Flow home page drop-down list, select the starting page for the Flow. The first page is selected by default.

    6. Review the template and click Save.

    7. Click Submit to send the template to WhatsApp for review.

    8. After WhatsApp approves the template, send the message template containing the WhatsApp Flow to your users.

    To send messages using an API, see Message sending.