Free. No sign-up. Runs in your browser.

WhatsApp Flow examples and previewer

Pick a WhatsApp Flow example or paste your own Flow JSON, then tap through it as a customer.

Example Flow

Component gallery. You are learning Flow JSON and want to see every component WhatsApp renders, across seven screens.

Edit it, or paste your own. It is checked and run here; nothing leaves your browser.

7 screens · 20 component types · no errors

What your business receives

Finish the Flow on the phone to see the data it sends back: the complete payload, which reaches your webhook as response_json.

Publish this Flow and send it to your customers

Cloodot publishes the Flow to your WhatsApp number and puts it on a template button you can send to a list or in a chat.

WhatsApp Flow examples to copy

Eight Flows for the jobs businesses use WhatsApp Flows for most. Each one is valid Flow JSON at version7.3, needs no server, and runs to its last screen. Open one in the previewer to tap through it, or copy the JSON and paste it into Meta’s Flow Builder.

Return request Flow

A customer wants to send something back: collect the order, the reason and refund or exchange in one go.

Screens (2)
Start a return → Refund or exchange
Components
TextHeadingTextBodyTextInputRadioButtonsGroupFooterDropdownPhotoPicker
Show the Flow JSON (191 lines)
{
  "version": "7.3",
  "routing_model": {
    "ORDER": [
      "RESOLUTION"
    ],
    "RESOLUTION": []
  },
  "screens": [
    {
      "id": "ORDER",
      "title": "Start a return",
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Return or exchange an order"
          },
          {
            "type": "TextBody",
            "text": "Unworn gear can come back within 60 days. This takes about a minute."
          },
          {
            "type": "Form",
            "name": "order_form",
            "children": [
              {
                "type": "TextInput",
                "name": "order_number",
                "label": "Order number",
                "input-type": "text",
                "helper-text": "On your receipt or order email, like NB-10482",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "email",
                "label": "Email on the order",
                "input-type": "email",
                "required": true
              },
              {
                "type": "RadioButtonsGroup",
                "name": "reason",
                "label": "Why is it coming back?",
                "required": true,
                "data-source": [
                  {
                    "id": "too_small",
                    "title": "Too small"
                  },
                  {
                    "id": "too_big",
                    "title": "Too big"
                  },
                  {
                    "id": "not_expected",
                    "title": "Not what I expected"
                  },
                  {
                    "id": "damaged",
                    "title": "Arrived damaged"
                  },
                  {
                    "id": "other",
                    "title": "Something else"
                  }
                ]
              },
              {
                "type": "Footer",
                "label": "Continue",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "RESOLUTION"
                  },
                  "payload": {
                    "order_number": "${form.order_number}",
                    "email": "${form.email}",
                    "reason": "${form.reason}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "RESOLUTION",
      "title": "Refund or exchange",
      "terminal": true,
      "data": {
        "order_number": {
          "type": "string",
          "__example__": "NB-10482"
        },
        "email": {
          "type": "string",
          "__example__": "megan.whitaker@example.com"
        },
        "reason": {
          "type": "string",
          "__example__": "too_small"
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "resolution_form",
            "children": [
              {
                "type": "RadioButtonsGroup",
                "name": "resolution",
                "label": "What would you like?",
                "required": true,
                "data-source": [
                  {
                    "id": "exchange",
                    "title": "Exchange for another size",
                    "description": "We ship the new pair as soon as yours is on its way"
                  },
                  {
                    "id": "refund",
                    "title": "Refund to my card",
                    "description": "Within 5 business days of the return arriving"
                  },
                  {
                    "id": "credit",
                    "title": "Store credit",
                    "description": "Issued right away, with $10 added"
                  }
                ]
              },
              {
                "type": "Dropdown",
                "name": "return_method",
                "label": "Send it back by",
                "required": true,
                "data-source": [
                  {
                    "id": "sellwood",
                    "title": "Drop off in Sellwood"
                  },
                  {
                    "id": "pearl",
                    "title": "Drop off in the Pearl District"
                  },
                  {
                    "id": "mail",
                    "title": "Mail it with a free label"
                  }
                ]
              },
              {
                "type": "PhotoPicker",
                "name": "photos",
                "label": "Photos (optional)",
                "description": "For damaged items, a photo or two speeds things up.",
                "photo-source": "camera_gallery",
                "min-uploaded-photos": 0,
                "max-uploaded-photos": 3
              },
              {
                "type": "Footer",
                "label": "Submit return",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "order_number": "${data.order_number}",
                    "email": "${data.email}",
                    "reason": "${data.reason}",
                    "resolution": "${form.resolution}",
                    "return_method": "${form.return_method}",
                    "photos": "${form.photos}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Appointment booking Flow

People book a service with you: they pick the service, a date and a time, then confirm.

Screens (3)
Book an appointment → Pick a time → Confirm booking
Components
RadioButtonsGroupFooterTextSubheadingDatePickerDropdownTextInputTextHeadingTextBodyTextCaptionOptIn
Show the Flow JSON (232 lines)
{
  "version": "7.3",
  "routing_model": {
    "SERVICE": [
      "DETAILS"
    ],
    "DETAILS": [
      "SUMMARY"
    ],
    "SUMMARY": []
  },
  "screens": [
    {
      "id": "SERVICE",
      "title": "Book an appointment",
      "data": {
        "services": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "__example__": [
            {
              "id": "consultation",
              "title": "Consultation",
              "description": "30 min · Free"
            },
            {
              "id": "full_service",
              "title": "Full service",
              "description": "2 hours · $120"
            },
            {
              "id": "follow_up",
              "title": "Follow-up visit",
              "description": "45 min · $40"
            }
          ]
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "service_form",
            "children": [
              {
                "type": "RadioButtonsGroup",
                "name": "service",
                "label": "Choose a service",
                "data-source": "${data.services}",
                "required": true
              },
              {
                "type": "Footer",
                "label": "Continue",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "DETAILS"
                  },
                  "payload": {
                    "service": "${form.service}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "DETAILS",
      "title": "Pick a time",
      "data": {
        "service": {
          "type": "string",
          "__example__": "consultation"
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "details_form",
            "children": [
              {
                "type": "TextSubheading",
                "text": "When works for you?"
              },
              {
                "type": "DatePicker",
                "name": "date",
                "label": "Preferred date",
                "min-date": "2026-07-12",
                "required": true
              },
              {
                "type": "Dropdown",
                "name": "time",
                "label": "Preferred time",
                "required": true,
                "data-source": [
                  {
                    "id": "morning",
                    "title": "Morning (9:00–12:00)"
                  },
                  {
                    "id": "afternoon",
                    "title": "Afternoon (12:00–17:00)"
                  },
                  {
                    "id": "evening",
                    "title": "Evening (17:00–20:00)"
                  }
                ]
              },
              {
                "type": "TextInput",
                "name": "phone",
                "label": "Phone number",
                "input-type": "phone",
                "helper-text": "We confirm by WhatsApp",
                "required": true
              },
              {
                "type": "Footer",
                "label": "Review booking",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "SUMMARY"
                  },
                  "payload": {
                    "service": "${data.service}",
                    "date": "${form.date}",
                    "time": "${form.time}",
                    "phone": "${form.phone}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "SUMMARY",
      "title": "Confirm booking",
      "terminal": true,
      "data": {
        "service": {
          "type": "string",
          "__example__": "consultation"
        },
        "date": {
          "type": "string",
          "__example__": "2026-07-15"
        },
        "time": {
          "type": "string",
          "__example__": "morning"
        },
        "phone": {
          "type": "string",
          "__example__": "+1 555 010 3344"
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Almost done"
          },
          {
            "type": "TextBody",
            "text": "`'Service: ' ${data.service}`"
          },
          {
            "type": "TextBody",
            "text": "`'Time slot: ' ${data.time} ' on ' ${data.date}`"
          },
          {
            "type": "TextCaption",
            "text": "`'We will confirm on ' ${data.phone}`"
          },
          {
            "type": "Form",
            "name": "confirm_form",
            "children": [
              {
                "type": "OptIn",
                "name": "terms",
                "label": "I accept the cancellation policy",
                "required": true
              },
              {
                "type": "Footer",
                "label": "Confirm booking",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "service": "${data.service}",
                    "date": "${data.date}",
                    "time": "${data.time}",
                    "phone": "${data.phone}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Lead capture Flow

Someone asks for a price or a callback from an ad or your website and you want their details in one screen.

Screens (1)
Get a quote
Components
TextHeadingTextBodyTextInputTextAreaOptInFooter
Show the Flow JSON (76 lines)
{
  "version": "7.3",
  "screens": [
    {
      "id": "CONTACT",
      "title": "Get a quote",
      "terminal": true,
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Tell us about your project"
          },
          {
            "type": "TextBody",
            "text": "We reply within one business day — usually much faster."
          },
          {
            "type": "Form",
            "name": "contact_form",
            "children": [
              {
                "type": "TextInput",
                "name": "full_name",
                "label": "Full name",
                "input-type": "text",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "email",
                "label": "Work email",
                "input-type": "email",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "company",
                "label": "Company",
                "helper-text": "Optional"
              },
              {
                "type": "TextArea",
                "name": "details",
                "label": "What do you need?",
                "helper-text": "A sentence or two is plenty",
                "required": true
              },
              {
                "type": "OptIn",
                "name": "marketing_opt_in",
                "label": "Send me occasional product updates"
              },
              {
                "type": "Footer",
                "label": "Request quote",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "full_name": "${form.full_name}",
                    "email": "${form.email}",
                    "company": "${form.company}",
                    "details": "${form.details}",
                    "marketing_opt_in": "${form.marketing_opt_in}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Event registration Flow

You run a class, a clinic or a store event and need sign-ups with a session, contact details and a waiver.

Screens (2)
Trail running clinic → Your details
Components
TextHeadingTextBodyRadioButtonsGroupDropdownFooterTextInputCheckboxGroupOptIn
Show the Flow JSON (190 lines)
{
  "version": "7.3",
  "routing_model": {
    "SESSION": [
      "ATTENDEE"
    ],
    "ATTENDEE": []
  },
  "screens": [
    {
      "id": "SESSION",
      "title": "Trail running clinic",
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Free trail running clinic"
          },
          {
            "type": "TextBody",
            "text": "A gait check, a shoe fitting and a 3-mile group run from our Sellwood store. Twenty spots per session."
          },
          {
            "type": "Form",
            "name": "session_form",
            "children": [
              {
                "type": "RadioButtonsGroup",
                "name": "session",
                "label": "Pick a session",
                "required": true,
                "data-source": [
                  {
                    "id": "sat_am",
                    "title": "Saturday, 8:00 a.m.",
                    "description": "Sellwood store, then Oaks Bottom"
                  },
                  {
                    "id": "sun_am",
                    "title": "Sunday, 9:00 a.m.",
                    "description": "Sellwood store, then Oaks Bottom"
                  },
                  {
                    "id": "wed_pm",
                    "title": "Wednesday, 6:00 p.m.",
                    "description": "Headlamps provided"
                  }
                ]
              },
              {
                "type": "Dropdown",
                "name": "pace",
                "label": "Your usual pace",
                "required": true,
                "data-source": [
                  {
                    "id": "new",
                    "title": "Just starting out"
                  },
                  {
                    "id": "over_11",
                    "title": "Slower than 11 min/mile"
                  },
                  {
                    "id": "9_to_11",
                    "title": "9 to 11 min/mile"
                  },
                  {
                    "id": "under_9",
                    "title": "Faster than 9 min/mile"
                  }
                ]
              },
              {
                "type": "Footer",
                "label": "Next",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "ATTENDEE"
                  },
                  "payload": {
                    "session": "${form.session}",
                    "pace": "${form.pace}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "ATTENDEE",
      "title": "Your details",
      "terminal": true,
      "data": {
        "session": {
          "type": "string",
          "__example__": "sat_am"
        },
        "pace": {
          "type": "string",
          "__example__": "9_to_11"
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "attendee_form",
            "children": [
              {
                "type": "TextInput",
                "name": "first_name",
                "label": "First name",
                "input-type": "text",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "last_name",
                "label": "Last name",
                "input-type": "text",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "email",
                "label": "Email",
                "input-type": "email",
                "helper-text": "For the confirmation and a reminder the day before",
                "required": true
              },
              {
                "type": "CheckboxGroup",
                "name": "extras",
                "label": "Want us to set anything aside?",
                "data-source": [
                  {
                    "id": "demo_shoes",
                    "title": "Demo shoes in my size"
                  },
                  {
                    "id": "vest",
                    "title": "A hydration vest to try"
                  },
                  {
                    "id": "headlamp",
                    "title": "A headlamp"
                  }
                ]
              },
              {
                "type": "OptIn",
                "name": "waiver",
                "label": "I have read and agree to the clinic waiver",
                "required": true,
                "on-click-action": {
                  "name": "open_url",
                  "url": "https://northbeamsupply.com/clinic-waiver"
                }
              },
              {
                "type": "Footer",
                "label": "Save my spot",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "session": "${data.session}",
                    "pace": "${data.pace}",
                    "first_name": "${form.first_name}",
                    "last_name": "${form.last_name}",
                    "email": "${form.email}",
                    "extras": "${form.extras}",
                    "waiver": "${form.waiver}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Quote request Flow

A team, school or company wants a bulk or custom order priced before they commit.

Screens (2)
Group order quote → Where to send it
Components
TextHeadingTextBodyChipsSelectorTextInputDatePickerFooterTextArea
Show the Flow JSON (174 lines)
{
  "version": "7.3",
  "routing_model": {
    "NEEDS": [
      "CONTACT"
    ],
    "CONTACT": []
  },
  "screens": [
    {
      "id": "NEEDS",
      "title": "Group order quote",
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Outfitting a team or a group?"
          },
          {
            "type": "TextBody",
            "text": "Tell us what you need. We send a quote with group pricing within one business day."
          },
          {
            "type": "Form",
            "name": "needs_form",
            "children": [
              {
                "type": "ChipsSelector",
                "name": "products",
                "label": "What do you need?",
                "required": true,
                "max-selected-items": 5,
                "data-source": [
                  {
                    "id": "rain_jackets",
                    "title": "Rain jackets"
                  },
                  {
                    "id": "hiking_boots",
                    "title": "Hiking boots"
                  },
                  {
                    "id": "daypacks",
                    "title": "Daypacks"
                  },
                  {
                    "id": "base_layers",
                    "title": "Base layers"
                  },
                  {
                    "id": "logo_gear",
                    "title": "Gear with our logo"
                  }
                ]
              },
              {
                "type": "TextInput",
                "name": "quantity",
                "label": "How many people?",
                "input-type": "number",
                "required": true
              },
              {
                "type": "DatePicker",
                "name": "needed_by",
                "label": "Needed by",
                "helper-text": "Logo gear takes about three weeks",
                "required": true
              },
              {
                "type": "Footer",
                "label": "Next",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "CONTACT"
                  },
                  "payload": {
                    "products": "${form.products}",
                    "quantity": "${form.quantity}",
                    "needed_by": "${form.needed_by}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "CONTACT",
      "title": "Where to send it",
      "terminal": true,
      "data": {
        "products": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "__example__": [
            "rain_jackets",
            "daypacks"
          ]
        },
        "quantity": {
          "type": "string",
          "__example__": "24"
        },
        "needed_by": {
          "type": "string",
          "__example__": "2027-03-01"
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "contact_form",
            "children": [
              {
                "type": "TextInput",
                "name": "name",
                "label": "Your name",
                "input-type": "text",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "organization",
                "label": "Organization",
                "input-type": "text",
                "helper-text": "School, club or company",
                "required": true
              },
              {
                "type": "TextInput",
                "name": "email",
                "label": "Email for the quote",
                "input-type": "email",
                "required": true
              },
              {
                "type": "TextArea",
                "name": "notes",
                "label": "Anything else?",
                "helper-text": "Sizes, colors, or where to ship"
              },
              {
                "type": "Footer",
                "label": "Request quote",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "products": "${data.products}",
                    "quantity": "${data.quantity}",
                    "needed_by": "${data.needed_by}",
                    "name": "${form.name}",
                    "organization": "${form.organization}",
                    "email": "${form.email}",
                    "notes": "${form.notes}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Feedback survey Flow

A conversation or an order has just wrapped up and you want a rating, with a follow-up only for low scores.

Screens (2)
How did we do? → One last thing
Components
TextHeadingRadioButtonsGroupChipsSelectorFooterIfTextSubheadingTextBodyTextAreaOptIn
Show the Flow JSON (177 lines)
{
  "version": "7.3",
  "routing_model": {
    "RATING": [
      "FOLLOW_UP"
    ],
    "FOLLOW_UP": []
  },
  "screens": [
    {
      "id": "RATING",
      "title": "How did we do?",
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "rating_form",
            "children": [
              {
                "type": "TextHeading",
                "text": "Rate your support experience"
              },
              {
                "type": "RadioButtonsGroup",
                "name": "rating",
                "label": "Overall experience",
                "required": true,
                "data-source": [
                  {
                    "id": "5",
                    "title": "Excellent"
                  },
                  {
                    "id": "4",
                    "title": "Good"
                  },
                  {
                    "id": "3",
                    "title": "Okay"
                  },
                  {
                    "id": "2",
                    "title": "Poor"
                  },
                  {
                    "id": "1",
                    "title": "Very poor"
                  }
                ]
              },
              {
                "type": "ChipsSelector",
                "name": "topics",
                "label": "What should we improve?",
                "max-selected-items": 3,
                "data-source": [
                  {
                    "id": "speed",
                    "title": "Response speed"
                  },
                  {
                    "id": "clarity",
                    "title": "Clarity"
                  },
                  {
                    "id": "tone",
                    "title": "Friendliness"
                  },
                  {
                    "id": "resolution",
                    "title": "Resolution quality"
                  },
                  {
                    "id": "availability",
                    "title": "Availability"
                  }
                ]
              },
              {
                "type": "Footer",
                "label": "Continue",
                "on-click-action": {
                  "name": "navigate",
                  "next": {
                    "type": "screen",
                    "name": "FOLLOW_UP"
                  },
                  "payload": {
                    "rating": "${form.rating}",
                    "topics": "${form.topics}"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "FOLLOW_UP",
      "title": "One last thing",
      "terminal": true,
      "data": {
        "rating": {
          "type": "string",
          "__example__": "4"
        },
        "topics": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "__example__": [
            "speed"
          ]
        }
      },
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "follow_up_form",
            "children": [
              {
                "type": "If",
                "condition": "${data.rating} <= 2",
                "then": [
                  {
                    "type": "TextSubheading",
                    "text": "We are sorry we let you down"
                  },
                  {
                    "type": "TextBody",
                    "text": "Tell us what happened and a team lead will follow up personally."
                  }
                ],
                "else": [
                  {
                    "type": "TextSubheading",
                    "text": "Anything else to share?"
                  }
                ]
              },
              {
                "type": "TextArea",
                "name": "comments",
                "label": "Comments",
                "helper-text": "Optional"
              },
              {
                "type": "OptIn",
                "name": "contact_ok",
                "label": "You can contact me about this feedback"
              },
              {
                "type": "Footer",
                "label": "Send feedback",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "rating": "${data.rating}",
                    "topics": "${data.topics}",
                    "comments": "${form.comments}",
                    "contact_ok": "${form.contact_ok}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Newsletter opt-in Flow

You want customers to opt in to marketing messages on WhatsApp, with their interests and clear consent.

Screens (1)
Trail notes
Components
TextHeadingTextBodyTextInputCheckboxGroupDropdownOptInEmbeddedLinkFooter
Show the Flow JSON (106 lines)
{
  "version": "7.3",
  "screens": [
    {
      "id": "SIGN_UP",
      "title": "Trail notes",
      "terminal": true,
      "data": {},
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Get trail notes from Northbeam"
          },
          {
            "type": "TextBody",
            "text": "One message a month: new gear, store events around Portland, and member-only sales."
          },
          {
            "type": "Form",
            "name": "sign_up_form",
            "children": [
              {
                "type": "TextInput",
                "name": "first_name",
                "label": "First name",
                "input-type": "text",
                "required": true
              },
              {
                "type": "CheckboxGroup",
                "name": "interests",
                "label": "What are you into?",
                "data-source": [
                  {
                    "id": "hiking",
                    "title": "Hiking"
                  },
                  {
                    "id": "trail_running",
                    "title": "Trail running"
                  },
                  {
                    "id": "camping",
                    "title": "Camping"
                  },
                  {
                    "id": "climbing",
                    "title": "Climbing"
                  }
                ]
              },
              {
                "type": "Dropdown",
                "name": "store",
                "label": "Nearest store",
                "data-source": [
                  {
                    "id": "sellwood",
                    "title": "Sellwood"
                  },
                  {
                    "id": "pearl",
                    "title": "Pearl District"
                  },
                  {
                    "id": "beaverton",
                    "title": "Beaverton"
                  }
                ]
              },
              {
                "type": "OptIn",
                "name": "consent",
                "label": "Yes, send me Northbeam updates on WhatsApp. I can reply STOP at any time.",
                "required": true
              },
              {
                "type": "EmbeddedLink",
                "text": "Read our privacy policy",
                "on-click-action": {
                  "name": "open_url",
                  "url": "https://northbeamsupply.com/privacy"
                }
              },
              {
                "type": "Footer",
                "label": "Subscribe",
                "on-click-action": {
                  "name": "complete",
                  "payload": {
                    "first_name": "${form.first_name}",
                    "interests": "${form.interests}",
                    "store": "${form.store}",
                    "consent": "${form.consent}"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

What to know about WhatsApp Flows

What a WhatsApp Flow is

A WhatsApp Flow is a form that opens inside a WhatsApp chat: one or more screens of questions, choices and dates a customer fills in without leaving the conversation. You describe it in Flow JSON, publish it through Meta, and the answers come back to your business as a message.

Meta calls Flows “a way to build structured interactions for business messaging” (WhatsApp Flows docs). In practice they replace the back-and-forth of asking for an order number, then an email, then a reason, one message at a time.

What Flow JSON looks like

A Flow is one JSON document: a version, then a list of screens. Each screen has anid, a title and a layout of components, and one screen is marked"terminal": true, which is where the Flow ends. This is the smallest useful one:

{
  "version": "7.3",
  "screens": [
    {
      "id": "SIGN_UP",
      "title": "Trail notes",
      "terminal": true,
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "Form",
            "name": "sign_up_form",
            "children": [
              { "type": "TextInput", "name": "first_name", "label": "First name", "required": true },
              {
                "type": "Footer",
                "label": "Subscribe",
                "on-click-action": {
                  "name": "complete",
                  "payload": { "first_name": "${form.first_name}" }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
  • navigate moves to the next screen and carries a payload with it; that screen reads it as ${data.field}, and must declare each field (with an __example__value) in its data.
  • complete ends the Flow; its payload is what your business receives.
  • ${form.field} is whatever the customer entered in the field of that name on the current screen.
  • data_exchange calls your own server between screens, for live data such as open time slots. None of the examples here need one.

Meta’s full reference: Flow JSON.

The components these examples use

ComponentWhat it doesSee it in
TextHeadingA screen’s main heading.Return request, Appointment booking
TextSubheadingA smaller section heading.Appointment booking, Feedback survey
TextBodyA paragraph of text.Return request, Appointment booking
TextCaptionSmall print under a field or a section.Appointment booking
RichTextLonger formatted text in Markdown: lists, tables, links.Component gallery
ImageA picture, embedded as base64.Component gallery
ImageCarouselUp to three pictures the customer swipes through.Component gallery
TextInputA one-line answer: a name, an email, an order number, a phone number.Return request, Appointment booking
TextAreaA longer, free-text answer.Lead capture, Quote request
RadioButtonsGroupPick exactly one option.Return request, Appointment booking
CheckboxGroupPick any number of options.Event registration, Newsletter opt-in
DropdownPick one option from a longer list.Return request, Appointment booking
ChipsSelectorTap one or more tags.Quote request, Feedback survey
OptInA checkbox for consent or terms, with an optional “Read more” link.Appointment booking, Lead capture
DatePickerPick a single date.Appointment booking, Quote request
CalendarPickerPick a date, or a range, on a month calendar.Component gallery
PhotoPickerAttach photos from the camera or gallery.Return request
EmbeddedLinkA text link to another screen or a web page.Newsletter opt-in
NavigationListA list of rows that each open a different screen.Component gallery
FooterThe button at the bottom that moves on or finishes the Flow.Return request, Appointment booking
IfShows different components depending on an earlier answer.Feedback survey

How a Flow is published and sent

  1. Get on the WhatsApp Business Platform. Flows go out through the Cloud API, from a verified business with good message quality (Meta: get started).
  2. Create the Flow. Paste the JSON into the Flow Builder in WhatsApp Manager, or upload it with the Flows API. Every validation error has to be fixed before Meta will publish it.
  3. Test the draft. A draft can only be sent for testing, and WhatsApp shows a banner on it. Send it to your own phone with mode set to draft.
  4. Publish. Publishing (POST /{flow-id}/publish) lets you send it to customers. Editing a published Flow sends it back to Draft until you publish again (Meta: lifecycle).
  5. Send it. Either attach it to a message template as a Flow button (the template must be approved; button text up to 25 characters) to message customers first, or send it as an interactive message while a conversation is open (call-to-action text of 30 characters or fewer is advised) (Meta: sending a Flow).
  6. Collect the answers. Each finished Flow arrives on your webhook as an nfm_reply message with the payload in response_json (Meta: Flows webhooks).

Limits worth knowing

  • Up to 50 components on a screen, and one Footer button per screen.
  • Per screen: at most 5 OptIn, 2 EmbeddedLink and 3 Image components, and onePhotoPicker or DocumentPicker, never both.
  • Labels are short: 20 characters for a TextInput or Dropdown, 30 for a radio or checkbox group, 35 for the Footer button. The checker above flags anything longer.
  • The whole Flow JSON can be up to 10 MB (Meta: Flows API).
  • Meta can throttle a Flow whose health drops to 10 messages an hour, or block it so nobody can open it (Meta: lifecycle).
  • Meta’s own Flows playground is for building a basic Flow by hand; this page runs any Flow JSON you paste, including If, Switch and data passed between screens.

Rules checked against Meta’s developer documentation in November 2026.

Frequently asked questions

What is a WhatsApp Flow?
A WhatsApp Flow is a form that opens inside a WhatsApp chat: one or more screens of questions, choices and dates a customer fills in without leaving the conversation. You describe it in Flow JSON, publish it through Meta, and the answers come back to your business as a message.
Which Flow JSON version do these examples use?
All of them declare version 7.3, and each passes the same checks the Cloodot Flow editor runs before it lets you publish. If you paste an older Flow, the previewer still runs it; check Meta's versioning page before you rely on a component added in a later version.
Do these Flows need an endpoint or a server?
No. Every example moves between screens with navigate and finishes with complete, so the whole Flow lives in its JSON and needs no server. You only need an endpoint (a data_exchange action) when a screen has to fetch live data, such as open appointment slots. This previewer logs a data_exchange step instead of calling anything.
How do I import Flow JSON into Meta?
In WhatsApp Manager, create a Flow in the Flow Builder and paste the JSON into its code editor, or upload it with the Flows API as a FLOW_JSON asset. Meta will not publish a Flow until every validation error is fixed.
Can I edit a WhatsApp Flow after it is published?
Yes, within limits. Changing a published Flow sends it back to Draft, and only messages sent after you publish it again use the new version. A published Flow cannot be deleted; you deprecate it instead, and Meta suggests cloning it for big changes.
Do WhatsApp Flows work with the free WhatsApp Business app?
No. Sending Flows needs the WhatsApp Business Platform with the Cloud API, a verified business and good message quality. The free app on your phone cannot send them.
How much does it cost to send a WhatsApp Flow?
There is no separate charge for the Flow. Sent on a template, it costs what that template category costs in the customer’s country. Sent as an interactive message while a conversation is open, it is a service message: since October 1, 2026 each number gets 1,000 of those free a month, then Meta charges its published rate.
How do I get the answers a customer submits?
When a customer finishes, WhatsApp sends your webhook a message of type nfm_reply whose response_json holds the complete action’s payload plus the flow_token you sent with the Flow. The response does not include the Flow’s ID, so use the flow_token or a payload field to tell your Flows apart. Finish any example here to see that payload.
Does this preview look exactly like WhatsApp?
It is very close: it is the same interpreter the Cloodot app uses, built against Meta’s Flow JSON reference, and it runs your bindings, conditions and validation. Fonts and spacing still differ a little between iPhone and Android, so send yourself the draft (Meta’s mode=draft) for a final check on a real phone.
Can I make a WhatsApp Flow without writing JSON?
Yes. Meta’s Flow Builder in WhatsApp Manager has a drag-and-drop side, and Cloodot can draft a Flow from a sentence describing what you need. Starting from one of these examples and changing the labels is often the quickest route.
Does anything I paste get sent anywhere?
No. The JSON is checked and run on this page, in your browser. Nothing you paste or type into the phone is uploaded.