Skip to main content

How to Use WhatsApp Flows

Last updated: 18 September 2026

WhatsApp Flows are interactive forms that open directly in WhatsApp. They allow recipients to select a service, choose an appointment date and time, enter their contact details, or complete a survey without leaving WhatsApp.

Instead of sending several outgoing messages, a business can send a single message with a Flow.

alt

warning

edna Pulse supports sending WhatsApp Flows subject to the following limitations:

  • sending is available only for non-template WhatsApp messages — you can send a message with WhatsApp Flows only within an open 24-hour conversation window with the WhatsApp recipient;

  • sending is available only through the edna Pulse API.

    File IconAPI edna Pulse: Sending Messages through Cascade

Sending WhatsApp Flows in template messages and sending from the edna Pulse personal account are not yet supported.

How to test sending WhatsApp Flows to your device​

  1. Go to the Integration → Testing section in your edna Pulse personal account.

  2. Enter your phone number in international format without the + sign in item 4.

    tip

    A phone number in international format must include the country code, the city or mobile operator code, and the local phone number.

    For example — 19165550101.

  3. Follow the link in item 5 and send any message in WhatsApp.

    info

    You need to send a message first to open the conversation window with the recipient. After that, you can send a non-template message with a WhatsApp Flow.

  4. Edit the request text in item 6.

    • Specify your phone number in the address field.

      For example — "address": "19165550101",.

    • Replace the whatsappContent section for sending a text message:

      "whatsappContent": {
      "contentType": "TEXT",
      "text": "WhatsApp TEXT"
      }

      with the whatsappContent section for sending a WhatsApp Flow:

      "whatsappContent": {
      "contentType": "FLOW",
      "caption": "Go",
      "text": "Tap the button to test WhatsApp Flows",
      "flowId": 1786752042513707,
      "action": "navigate"
      }
      info

      In the flowId field, use one of the following values:

      • 1786752042513707 — promotion sign-up;
      • 1099710146075902 — feedback collection;
      • 1636007551377215 — support request form.
  5. Click Send request.

warning

If you want to send yourself several messages with a WhatsApp Flow, change at least 1 character in the requestId field for each request.

How to use WhatsApp Flows in edna Pulse​

To send your own WhatsApp Flow through edna Pulse, first prepare the Flow content, then create and publish it in WhatsApp Manager.

business.facebook.com

  1. Create a Flow and copy its JSON. To copy the Flow JSON, click Copy Flow JSON in the preview window.

    info

    To generate the JSON, use the Meta Playground* visual builder.

    developers.facebook.com

    Meta Playground* provides the following features:

    • adding the required screens;
    • selecting components: text fields, lists, toggles, date pickers, and other elements;
    • setting texts and element names;
    • configuring transitions between screens;
    • previewing how the Flow will look to the recipient.

    alt

  2. Go to WhatsApp Manager and create a WhatsApp Flow:

    • Specify the Flow name, category, and the Without Endpoint Flow type. alt
    • Click Create and replace the suggested JSON in the Editor window with the JSON copied from Meta Playground*.
    • Click Save. alt
  3. In the Preview window, make sure the Flow looks as expected.

  4. Click Publish. alt

  5. On the page with the list of created Flows, copy the Flow ID. You will need it as the flowId value when sending a message through the edna Pulse API. alt

  6. Make sure the 24-hour conversation window with the recipient is open.

    info

    The Flow is sent as an interactive message within an open 24-hour WhatsApp window.

    Before you send a Flow, the recipient must send a message to the company's WhatsApp number. From the moment of the recipient's last incoming message, you have 24 hours to send the Flow.

  7. Send a request through the edna Pulse API. Make sure to specify "contentType": "FLOW" and the flowId copied from WhatsApp Manager.

    For example:

    "requestId": "flow-test-001",
    "whatsappContent": {
    "contentType": "FLOW",
    "text": "Fill out the form",
    "caption": "Open",
    "flowId": "123456789012345",
    "action": "navigate"
    }

    Where the following parameters are specified:

    • text – message text;
    • caption – text of the button that opens the Flow;
    • flowId – ID of the published Flow;
    • action – action when the Flow is opened.
    File IconAPI edna Pulse: Sending Messages through Cascade
    info

    After the message is sent, the recipient will see a message with a button. Tapping the button opens the Flow directly in WhatsApp.

  8. WhatsApp will pass the submitted data to edna Pulse after the recipient completes the Flow.

    If you have a webhook configured for incoming messages, edna Pulse will send the Flow result to the specified URL of your system together with the incoming message data.

    File IconAPI edna Pulse: Webhook about Receiving Incoming Messages
    info

    You can also view the information entered by the recipient or the selected options in the following sections of your personal account:

    • In the message report download in the Analytics → Messages section.
    • In the Dialogues section.