How to test a chatbot in the mobile simulator
Test on Mobile opens a mock WhatsApp panel beside the builder. The conversation is named Flow Test. Type a start keyword (or any matching message), tap reply buttons, then click Close Simulation to reset.
Prerequisites
- A chatbot open in the builder. See How to build a WhatsApp chatbot.
- Start keywords or another trigger configured. See How to set chatbot keyword triggers.
- Agents need permission to run simulation. Without it, the toast is You don't have permission to run chatbot simulation.
Step-by-step
Open the builder
Go to Automation → Chatbots. Click Create Chatbot or row-menu Edit.Click Test on Mobile
In the builder header, click Test on Mobile. A mock inbox opens beside the canvas. The first message is a mock greeting. If saved chatbots have keywords, it lists Available triggers. Otherwise it says Type any message to test the flow.Send a trigger message
Type a Start Keywords value (Exact: the whole message; Part of: the keyword anywhere). Send it. The simulator runs the matching chatbot path, including media placeholders such as[IMAGE].Use buttons and close
If a step has buttons, click them in the panel. When finished, click Close Simulation. The conversation resets. Click Save when the canvas is ready (first save: Save Flow / Chatbot Name).
TIP
Fix validation first if the header shows Save (N issues). You can still open the simulator, but you cannot save until issues are cleared.
WARNING
The mock panel is not a live WhatsApp chat. Payment, catalogue, and API side effects on real providers may not match production. Confirm live behavior on a test number after save.
FAQ
What is the mock conversation called?
Flow Test. The greeting explains it is a mock conversation for testing flows.
Does Close Simulation delete the chatbot?
No. It only hides the panel and resets the mock thread. Your canvas stays until you Save or go Back.
Why are no triggers listed?
The greeting lists keywords from saved chatbots that have start keywords. A new unsaved chatbot may not appear there yet. Save, or type the keyword you configured on Start.