Flow Builder for Mesvilo

Build WhatsApp conversation flows on a visual canvas: drag steps, connect them, and let customers move through menus, questions and branches until a teammate takes over.

Install

1. Copy the flow-builder folder into addons/ of your Mesvilo installation.

2. Platform admin → Add-ons → activate Flow Builder with your purchase code (this runs the add-on migrations).

3. A Flows item appears in the workspace sidebar for members with the *Manage auto replies* permission.

Requires Mesvilo 1.0.0 or newer and the usual cron (php artisan mesvilo:work every minute), which expires waiting flows.

Steps

| Step | What it does |

|---|---|

| Trigger | Starts on keywords (whole word / contains) or on the first message of a new conversation |

| Send message | Bot text, supports {{first_name}}, {{name}}, {{last_reply}}, {{field.key}} |

| Buttons | Up to 3 reply buttons, each with its own path |

| List menu | Up to 10 rows, each with its own path |

| Ask question | Waits for a text reply and saves it to the contact name, email or a custom field |

| Condition | Last reply / contact field / tag — equals, contains, is empty → Yes / No |

| Add tag | Tags the contact (creates the tag if needed) |

| Team handoff | Optional customer message, assigns a teammate or leaves the chat in the team queue, adds an internal note with the collected answers, ends the flow |

| End | Optional closing message |

How it runs

• Flows answer inbound messages before core keyword auto replies (hook priority 20; Surveys & NPS run first at 10, AI agents after at 30).
• The editor auto-saves. Changes to a live flow go live only when you click Publish changes; activation checks the graph (single trigger, every required output connected, no orphan steps).
• An unrecognised reply to buttons/lists resends the step once, then hands the chat to the team.
• Flows never start while a human has taken over the chat; a handoff keeps all bots quiet until the conversation is resolved.
• A waiting flow expires after 24 hours. Every run is logged with its steps and outcome (Flows → Run log).
• Messages are only sent inside the 24-hour service window (an inbound message always opens it).

Demo data

Addons\FlowBuilder\DemoSeeder::run($workspace) creates "Order status", "Lead qualification" and "Appointment booking" flows plus a run history.

Mesvilo core documentation: mesvilo.com/docs · Support: mesvilo.com/contact