> For the complete documentation index, see [llms.txt](https://helpdocumentation.gitbook.io/user-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocumentation.gitbook.io/user-documentation/bot-builder/whatsapp-chatbot/trigger-a-bot-flow-via-inbound-webhook.md).

# Trigger a Bot Flow Via Inbound Webhook

The **Inbound Webhook Trigger** allows you to trigger a bot flow using external systems by sending data via API.

### Steps to Configure

#### 1. Create Bot Flow

1. Go to **Chatbot → Create Bot Flow**
2. Enter a **Bot Flow name**
3. Click on **+ icon → WhatsApp Chatbot**
4. Select **Inbound Webhook Trigger**

#### 2. Configure Trigger

5. Choose how the channel will be selected
6. Select the appropriate **WhatsApp Channel**
7. Add a **Sample Payload (JSON)**

Example:

```
{
  "chat_uid": "1234567890",
  "name": "John"
}
```

8. Select **Chat Identifier / UID** from the payload
9. Click on **Create Webhook**
10. Copy the generated **Webhook URL**

#### 3. Test Webhook

11. Use tools like Postman
12. Send a **POST request** with the sample JSON
13. Verify that the webhook is accepted

#### 4. Send Initial Message

14. Add a node → **Send Message / CRM → Template Message**
15. Select channel and template
16. Map required variables (e.g., phone number, name)
17. Run and save

> Note: Template messages are required if the WhatsApp session is not active.

#### 5. Add Smart Wait

18. Add **Native Tools → Smart Wait**
19. Set response type (e.g., single reply)
20. Define wait time (e.g., 100 hours)
21. Save configuration

#### 6. Continue Flow

22. Add further steps like:

* Ask questions
* Send interactive messages
* Collect user data

This setup allows external systems to trigger bot flows and start user interactions seamlessly through API integration.

{% embed url="<https://youtu.be/F8ZHBKnFL9Y>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdocumentation.gitbook.io/user-documentation/bot-builder/whatsapp-chatbot/trigger-a-bot-flow-via-inbound-webhook.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.