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

# WhatsApp Agent

> Learn how to create an agent that you can connect to your WhatsApp number to respond to your customers.

<img src="https://mintcdn.com/droxy/PYQi07ER2Z1UGGRz/images/documentation/agents/messaging/whatsapp.png?fit=max&auto=format&n=PYQi07ER2Z1UGGRz&q=85&s=176c1832ed4515f769670326e2ff32b3" alt="WhatsApp Agent" width="1630" height="840" data-path="images/documentation/agents/messaging/whatsapp.png" />

## What is a WhatsApp Messaging Agent?

It is an LLM-based agent that you can connect to your WhatsApp business account to provide instant support and answers to your customers. The agent:

* Learns from your company's knowledge sources including website content, PDFs, YouTube videos, and other documents
* Provides real-time responses to customer queries based on your specific business information
* Integrates seamlessly with your WhatsApp Business Account
* Answers in your brand's voice in a natural and conversational manner through WhatsApp chats
* Handles multiple customer conversations simultaneously
* Available 24/7 to respond to customer inquiries via WhatsApp

## Connect A WhatsApp Business Account

In the Droxy dashboard, go to the **Integrations** section and click on the **WhatsApp** card.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/select-whatsapp.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=31bc3802ad165bc0919cf07d28c6d02b" alt="WhatsApp Agent" width="1788" height="1006" data-path="images/documentation/integrations/whatsapp/select-whatsapp.png" />
</Frame>

### 1. Start the connection process

Click on the **Connect** button to connect a WhatsApp Business Account.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/connect-account.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=91fd4f35ba58032e049cf55f80a88abb" alt="Connect WhatsApp Account" width="1788" height="1006" data-path="images/documentation/integrations/whatsapp/connect-account.png" />
</Frame>

<Note>
  The WhatsApp phone number integrated with the agent can only be used by the agent. It cannot be used on WhatsApp or WhatsApp Business. If you are already using this phone number with WhatsApp, you must delete your account first to free up the number.

  Steps to delete WhatsApp account:

  1. Open the WhatsApp or WhatsApp Business app.
  2. Navigate to Settings > Account > Delete my account.
  3. Confirm the deletion by entering the phone number.
  4. Select 'Delete my account'. After a few minutes, your number will be available again.
</Note>

### 2. Login with your Facebook account

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/1-login.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=512e85cf63c3453afff22f100e95d902" alt="Login with Facebook" width="1112" height="1330" data-path="images/documentation/integrations/whatsapp/meta-popup/1-login.png" />
</Frame>

Click on **Get Started** to continue.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/2-start.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=602d09273d829c10f74e39111db2fbd5" alt="Start" width="1112" height="1330" data-path="images/documentation/integrations/whatsapp/meta-popup/2-start.png" />
</Frame>

### 3. Choose or create a business profile

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/3-portfolio.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=79422f48f8953404a0763ba070347c05" alt="Portfolio" width="1112" height="1330" data-path="images/documentation/integrations/whatsapp/meta-popup/3-portfolio.png" />
</Frame>

### 4. Choose or create a WhatsApp Business Account

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/4-business-account.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=c12a3fa4b769612ef5eb92cd9d9b6093" alt="WhatsApp Account" width="1112" height="1330" data-path="images/documentation/integrations/whatsapp/meta-popup/4-business-account.png" />
</Frame>

### 5. WhatsApp Business Profile (Optional)

If you chose to create a new business account, fill in the required information for your WhatsApp Business Profile.

<Warning>
  Please make sure to follow Meta's [display name guidelines](https://www.facebook.com/business/help/757569725593362) as this could affect your account's eligibility to send messages.
</Warning>

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/5-business-profile.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=8e80cb803a1318c3db2519b446e638a8" alt="Business Profile" width="1112" height="1330" data-path="images/documentation/integrations/whatsapp/meta-popup/5-business-profile.png" />
</Frame>

### 6. WhatsApp Business Phone Number (Optional)

If you do not have a phone number in your WhatsApp Business Account, add a phone number and verify it.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/6-phone-number.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=087633b3c27de61031b5880125bcb248" alt="Phone Number" width="1112" height="1328" data-path="images/documentation/integrations/whatsapp/meta-popup/6-phone-number.png" />
</Frame>

### 7. Confirm the connection

Click on **Continue** to allow Droxy to access your WhatsApp Business Account.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/7-permissions.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=ca7c8d967dafe97ee9850b744315c381" alt="Continue" width="1112" height="1328" data-path="images/documentation/integrations/whatsapp/meta-popup/7-permissions.png" />
</Frame>

Click on **Finish** to complete the connection process.

<Frame>
  <img src="https://mintcdn.com/droxy/HOdum5UyXwRG-ShM/images/documentation/integrations/whatsapp/meta-popup/8-finish.png?fit=max&auto=format&n=HOdum5UyXwRG-ShM&q=85&s=6980fc8cbdfa81de90d98396fa08243c" alt="Finish" width="1112" height="1328" data-path="images/documentation/integrations/whatsapp/meta-popup/8-finish.png" />
</Frame>

## Setting up your WhatsApp Messaging Agent

In the Droxy dashboard, go to the **Agents** section and click on **+ Add**. Then select **WhatsApp Agent** in the **Messaging** category.

<Frame>
  <img src="https://mintcdn.com/droxy/I4AvPcTQJGk7K3_u/images/documentation/agents/selection/whatsapp-messaging.png?fit=max&auto=format&n=I4AvPcTQJGk7K3_u&q=85&s=f8a1420d37ce9eda350fb85c09bf1114" alt="Select WhatsApp Agent" width="1788" height="1006" data-path="images/documentation/agents/selection/whatsapp-messaging.png" />
</Frame>

### 1. Basics

Configure the basics for your WhatsApp agent:

<Frame>
  <img src="https://mintcdn.com/droxy/PYQi07ER2Z1UGGRz/images/documentation/agents/messaging/whatsapp/basics.png?fit=max&auto=format&n=PYQi07ER2Z1UGGRz&q=85&s=ff9be93828cd17e68cb718a1ca678c3b" alt="Basics" width="2412" height="382" data-path="images/documentation/agents/messaging/whatsapp/basics.png" />
</Frame>

* **Name and Avatar**: Give your agent a name and upload an avatar image that will be displayed in your dashboard
* **Connected Account**: Choose a WhatsApp Business Account to connect to your agent
* **Phone Number**: Choose a WhatsApp phone number to connect to your agent

### 2. Configuration

Configure your agent's behavior to suit your business needs:

<Frame>
  <img src="https://mintcdn.com/droxy/PYQi07ER2Z1UGGRz/images/documentation/agents/messaging/whatsapp/configuration.png?fit=max&auto=format&n=PYQi07ER2Z1UGGRz&q=85&s=237a1bebe554a5c614ca9a2d0ef4e2c9" alt="Configuration" width="2424" height="786" data-path="images/documentation/agents/messaging/whatsapp/configuration.png" />
</Frame>

* **Behavior**: Define the agent's role, personality, and communication style. Be specific about how the agent should interact with visitors. Use the built-in prompt generator to create and refine your agent's instructions.
* **Model**: Select the LLM powering your agent (e.g., GPT-4o mini, Claude Sonnet 4.6, Gemini 3 Flash). Each model consumes different amounts of tokens and has different capabilities.
* **Knowledge Restrictions**: Choose whether to restrict the agent's responses to only your provided knowledge content. Make sure to specify to the agent what to answer if the knowledge base doesn't contain an answer.
* **Emojis**: Choose whether to enable emojis in the agent's responses

### 3. Knowledge Base

Ground your agent with relevant business information to help it answer customer questions accurately:

<Frame>
  <img src="https://mintcdn.com/droxy/PYQi07ER2Z1UGGRz/images/documentation/agents/messaging/whatsapp/knowledge.png?fit=max&auto=format&n=PYQi07ER2Z1UGGRz&q=85&s=95f97fd7293813cdb7a9ede1cd029022" alt="Knowledge" width="2926" height="1108" data-path="images/documentation/agents/messaging/whatsapp/knowledge.png" />
</Frame>

* Upload relevant company documents (PDFs, text files, Google Docs, etc.)
* Add website URLs for the agent to learn from
* Link YouTube videos that contain product information or tutorials
* Import custom knowledge bases or FAQs

### 4. Tools

You can enable the following tools to enhance messaging agent functionality:

<Frame>
  <img src="https://mintcdn.com/droxy/PYQi07ER2Z1UGGRz/images/documentation/agents/messaging/whatsapp/tools.png?fit=max&auto=format&n=PYQi07ER2Z1UGGRz&q=85&s=1d25415e809a4c0910f9f841fd7fc90b" alt="Available Tools" width="1588" height="424" data-path="images/documentation/agents/messaging/whatsapp/tools.png" />
</Frame>

* **Takeover Request**: Enables the agent to automatically request a conversation to be taken over by a human agent when appropriate or when the user requests to speak to a human. You will receive a notification about the takeover request.

Each tool can be toggled on/off using the switches, allowing you to customize the feature set based on your needs.