> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marro.si/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp chatbots

> Build a chatbot that asks questions with buttons and lists, fills in lead details and hands the chat to your team or the AI receptionist.

A **chatbot** answers customers on WhatsApp by itself, step by step. It can ask a question with up to three buttons or a list of up to ten options, ask for typed words (a name, a number, an email address), branch on what the customer chose, put an answer into a lead field, and hand the chat to a person or the AI receptionist.

> [!NOTE]
>
> Chatbots are part of the Inbox. Building and switching them on needs the **Inbox settings** permission.

## Build a chatbot

**1. Open Chatbots**

Open **Inbox → Settings → Chatbots** and choose **New chatbot**. It starts with a small example you can change.

**2. Choose when it starts**

Type the **keywords** that start it, separated by commas. A keyword matches a whole word in any case: "price" matches "What is the price?". You can also switch on **First message of a new chat**.

**3. Add steps**

Each step does one thing, and says which step comes next:

* **Say something**: a message.
* **Ask with buttons**: up to three buttons. Each button leads to its own next step.
* **Ask with a list**: up to ten options.
* **Ask for typed words**: the customer types an answer, which must be words, a number, an email address or a phone number. Name the answer so later steps can use it.
* **Branch on an answer**: choose the next step from an earlier answer.
* **Set a lead field**: put an answer, or words you write, into one of the lead's fields. A value the field does not accept is refused, never saved.
* **Hand over to a person**, **Hand over to the AI receptionist**, or **End the chat**.

**4. Save and switch on**

The page lists anything still to fix, such as a step that leads nowhere or can never be reached. **Save and switch on** works once nothing is left to fix.

## How it behaves

* **One chatbot per chat.** A chat runs at most one chatbot at a time.
* **It never talks over your team.** It does not start while a person is writing in the chat or the AI receptionist has it, and it stops the moment a person sends a message (from Marro or the WhatsApp Business app).
* **The 24-hour window.** A chatbot runs only while WhatsApp allows free messages: 24 hours after the customer's last message. If the window closes, the chatbot ends quietly and sends nothing.
* **Wrong answers.** If a customer types instead of tapping, or types something a question does not accept, it asks again once. A second miss follows the step's **Unclear answer** choice, or hands the chat to a person when none is set.
* **STOP.** A customer who replies STOP is never messaged again, and their chatbot stops.
* **Replies from the AI receptionist, keyword replies and welcome or away messages stay quiet** while a chatbot answers a message.

## See what it did

Above the message box, the chat shows one line: which chatbot ran, whether it is still asking, was handed over or finished, and the answers so far. While it runs, **Stop** ends it so your team can take over. When a chatbot hands over or finishes, a note is added to the lead with the answers it collected.

## Ask the assistant

The assistant can list your chatbots, create or change one as a draft, switch it on or off, and stop one running in a chat. Each change is shown for your approval first; saving a chatbot never switches it on.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.