Skip to content

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

Step-by-step

  1. Open the builder
    Go to Automation → Chatbots. Click Create Chatbot or row-menu Edit.

  2. 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.

  3. 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].

  4. 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.