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

# WhatsApp

> Send and receive messages via WhatsApp Business

Connect your WhatsApp Business account and give your agents the ability to send messages, share media and documents,
manage templates, and interact with contacts through the WhatsApp Business API.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Messaging" icon="comment">
    Send text messages, reply to conversations, and mark messages as read across your WhatsApp Business channels.
  </Card>

  <Card title="Rich media and documents" icon="paperclip">
    Share images, videos, audio, documents, locations, and contact cards in conversations.
  </Card>

  <Card title="Template and interactive messages" icon="rectangle-list">
    Send pre-approved template messages, interactive button menus, and list pickers for structured customer
    interactions.
  </Card>

  <Card title="Business profile management" icon="briefcase">
    View and update your WhatsApp Business profile, manage phone numbers, and organize message templates.
  </Card>
</CardGroup>

***

## Connect WhatsApp

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **WhatsApp**.
  </Step>

  <Step title="Authorize with WhatsApp Business">
    Click **Connect** and follow the OAuth flow to link your WhatsApp Business account. You will need access to a Meta
    Business Suite account with a WhatsApp Business API setup.
  </Step>

  <Step title="Add WhatsApp to an agent">Open the agent and enable only the WhatsApp actions it needs.</Step>
</Steps>

***

## Agent tools

### Messages

| Tool                     | Description                                  |
| ------------------------ | -------------------------------------------- |
| Send message             | Send a text message to a phone number        |
| Reply to message         | Reply to a specific incoming message         |
| Send template message    | Send a pre-approved message template         |
| Send interactive buttons | Send a message with clickable button options |
| Send interactive list    | Send a message with a scrollable list picker |
| Mark as read             | Mark a received message as read              |
| Send contacts            | Share one or more contact cards              |

### Media

| Tool          | Description                            |
| ------------- | -------------------------------------- |
| Send image    | Send an image in a conversation        |
| Send document | Send a file or document                |
| Send video    | Send a video message                   |
| Send audio    | Send an audio file or voice note       |
| Send location | Share a geographic location            |
| Upload media  | Upload media for later use in messages |

### Templates and business

| Tool                    | Description                                            |
| ----------------------- | ------------------------------------------------------ |
| List templates          | List all approved message templates                    |
| Create template         | Create a new message template for approval             |
| Get template status     | Check the approval status of a template                |
| Delete template         | Remove a message template                              |
| Get business profile    | Retrieve your WhatsApp Business profile details        |
| Update business profile | Update your business description, address, or category |

***

## Triggers

<Note>
  Triggers are not yet available for WhatsApp. When trigger support is added, you will be able to start agent tasks
  automatically based on incoming messages and delivery events.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Send order confirmations to customers">
    After a purchase is completed, have your agent send a personalized template message via WhatsApp with order details,
    tracking info, and a thank-you note.
  </Accordion>

  <Accordion title="Handle customer inquiries with interactive menus">
    When a customer messages your business number, an agent can reply with an interactive list of common topics (order
    status, returns, FAQs) and route the conversation accordingly.
  </Accordion>

  <Accordion title="Broadcast updates to a contact list">
    Use approved templates to send product updates, appointment reminders, or event invitations to a list of opted-in
    contacts.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection fails">
    Ensure your Meta Business Suite account has the WhatsApp Business API properly set up. You need a verified business,
    a registered phone number, and the WhatsApp Business app configured in Meta for Developers.
  </Accordion>

  <Accordion title="Template messages are rejected">
    WhatsApp requires all proactive messages to use pre-approved templates. Submit your template for review in the Meta
    Business Suite. Templates with prohibited content (e.g., promotions without opt-in) will be rejected.
  </Accordion>

  <Accordion title="Cannot send messages outside the 24-hour window">
    WhatsApp enforces a 24-hour messaging window after the customer's last message. Outside this window, you must use an
    approved template message to initiate conversation.
  </Accordion>

  <Accordion title="Media uploads fail">
    Check that files meet WhatsApp's size and format requirements: images (JPEG, PNG, max 5 MB), documents (PDF, max 100
    MB), videos (MP4, max 16 MB), audio (AAC, MP3, max 16 MB).
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>