> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/conversations/whatsapp.md).

# Integrate with Platform: WhatsApp

## Pre-Connection Checklist

* An "AI Assistant" has been created on the [MaiAgent platform](https://admin.maiagent.ai/)
* You have a [Meta Business](https://business.facebook.com/) account
* A WhatsApp Business account has been created and a phone number has been linked

## Start Connection

### 1. Go to the Connect Chat Platform Page

Click <mark style="color:blue;">Chat Platforms</mark> in the left menu, then click the <mark style="color:blue;">Connect Chat Platform</mark> button in the upper right corner.

### 2. Select WhatsApp

On the platform selection page, click <mark style="color:blue;">WhatsApp</mark>.

### 3. Connect Your Facebook Account

Click the <mark style="color:blue;">Connect WhatsApp</mark> button. The system will open a Facebook OAuth login window.

1. Log in to your Facebook account
2. Authorize MaiAgent to access WhatsApp Business management permissions
3. After authorization, the window will close automatically and return to the settings page

{% hint style="warning" %}
Ensure your browser allows pop-up windows; otherwise, the OAuth login window may be blocked.
{% endhint %}

### 4. Select WhatsApp Business Account and Phone Number

After OAuth authorization is complete:

1. From the <mark style="color:blue;">Select WhatsApp Business Account</mark> dropdown, choose the business account to connect
2. From the <mark style="color:blue;">Select Phone Number</mark> dropdown, choose the phone number to receive messages

### 5. Basic Settings

| Field             | Description                                                                             |
| ----------------- | --------------------------------------------------------------------------------------- |
| **Platform Name** | Give this connection a name for easy identification                                     |
| **AI Assistant**  | Select the AI Assistant to bind                                                         |
| **Reset Command** | (Optional) Set a command that allows users to restart the conversation, e.g., "restart" |

### 6. Save Settings

After confirming all settings are correct, click <mark style="color:blue;">Save</mark> to complete the connection.

Once connected, when users send messages to the phone number via WhatsApp, the AI Assistant will automatically reply.

{% hint style="info" %}
After successful connection, you can find this integration in the chat platform list. Click edit to further configure feature options (OCR recognition, time-based replies, access control, etc.).
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/conversations/whatsapp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.