Flow node types and WhatsApp limits
Reference for all 10 flow nodes — messages, buttons, lists, media, input capture, conditions, tags, handoff and end — with WhatsApp's character limits.
Messaging nodes
| Node | What it does | Key settings |
|---|---|---|
| Start | Entry point of the flow | Next node |
| Send message | Sends a text message | Text, next node |
| Send buttons | Sends quick-reply buttons | Body, optional footer, 1–3 buttons, each with its own next node |
| Send list | Sends a tappable list | Body, button label, 1–10 rows across sections, each row with its own next node |
| Send media | Sends an image, video or document | File (max 16 MB), caption, file name for documents, next node |
Logic and data nodes
| Node | What it does | Key settings |
|---|---|---|
| Collect input | Asks a question and saves the reply | Prompt, variable key (e.g. email), next node |
| If / else | Branches on a rule | Subject, operator, value, If true and If false nodes |
| Tag contact | Adds or removes a tag | Add/Remove, tag, next node |
Flow control nodes
| Node | What it does | Key settings |
|---|---|---|
| Handoff to agent | Hands the conversation to a human | Assign to (optional), internal note |
| End | Ends the flow. No settings. | — |
WhatsApp limits
| Item | Limit |
|---|---|
| Buttons per message | 3 |
| Button title | 20 characters |
| List rows (all sections together) | 10 |
| List button label | 20 characters |
| List row title | 24 characters |
| List row description | 72 characters |
| Message body | 1,024 characters |
| Footer | 60 characters |
| Media file | 16 MB — images PNG/JPEG/WebP, videos MP4/3GP, documents PDF/Word/Excel/PowerPoint/TXT |
The validation bar warns you when something is over a limit, before you activate.
Using captured answers
Collect input stores the reply under the variable key you choose (letters, numbers and underscores). Use it later in prompts and handoff notes, for example New lead: {{email}}.
If / else conditions
| Subject | Operators |
|---|---|
| Captured variable | is present, is absent, equals, contains |
| Contact has tag | is present, is absent |
| Contact field (name, email, phone, company) | is present, is absent, equals, contains |
Example: If contact has tag customer → existing-customer menu, else → new-customer menu.
Handoff
When the flow reaches Handoff to agent, the conversation is set to Pending, assigned to the chosen agent if you picked one, and the internal note is saved so the agent knows what the customer already said. The flow run ends as Handed off.
Button and list ids are created for you and shown above each option. WhatsApp sends the id back when a customer taps. You usually don’t need to change them — but if you use them in a Button / List Reply automation, keep them stable.