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

# WhatsApp Business Integration

> Connect your AI assistants to WhatsApp Business for automated messages and voice calls

> [!NOTE]
>
> **New: External Numbers** — You can now bring your own mobile number to WhatsApp! Use platform numbers or connect your existing mobile number with SMS/voice verification.

## What is WhatsApp Business Integration?

WhatsApp Business integration allows you to connect your AI assistants to WhatsApp, enabling automated text-based conversations with customers through the world's most popular messaging platform.

With this integration, you can:

* **Receive customer messages** and respond automatically with AI
* **Send template messages** to start conversations or re-engage customers
* **Use AI-powered replies** for 24/7 customer support
* **Trigger automation flows** based on WhatsApp conversations
* **Answer WhatsApp voice calls** and call customers after they grant permission
* **Track all conversations** in your dashboard

## How It Works

```mermaid theme={null}
flowchart LR
    A[Customer] -->|Sends WhatsApp message| B[Your WhatsApp Sender]
    B -->|Routes to| C[AI Assistant]
    C -->|Generates response| B
    B -->|Replies to| A
```

1. **Create a WhatsApp Sender** using a platform number or your own external number
2. **Connect an AI Assistant** to handle incoming messages automatically
3. **Create Message Templates** for outbound conversations (required by Meta)
4. **Customers message you** and receive AI-powered responses instantly

## Key Components

> [card] [WhatsApp Senders](https://docs.receptonic.com/whatsapp/senders.md)
>
> Phone numbers registered for WhatsApp Business messaging

> [card] [Message Templates](https://docs.receptonic.com/whatsapp/templates.md)
>
> Pre-approved message formats for business-initiated conversations

> [card] [AI Conversations](https://docs.receptonic.com/whatsapp/conversations.md)
>
> AI-powered automated responses to customer messages

> [card] [WhatsApp Calling](https://docs.receptonic.com/whatsapp/calling.md)
>
> Answer inbound WhatsApp calls and call customers after they grant permission

> [card] [Automation](https://docs.receptonic.com/whatsapp/automation.md)
>
> Trigger flows and send messages via the automation platform

## Understanding WhatsApp Business Rules

WhatsApp has specific rules for business messaging that you need to understand:

### The 24-Hour Messaging Window

> [!NOTE]
>
> When a customer messages you, a **24-hour window** opens where you can send free-form messages. After this window closes, you must use an **approved template** to re-engage the customer.

* **Within 24 hours**: Send any message directly
* **After 24 hours**: Must use a pre-approved template message

### Template Messages

Template messages are pre-approved message formats required for:

* Starting new conversations with customers
* Re-engaging customers after the 24-hour window
* Sending notifications, updates, or marketing messages

Templates must be submitted to Meta for approval before use (typically takes minutes to 24 hours).

### Quality Rating & Limits

Meta monitors your messaging quality. New senders start with limited messaging capacity that increases as you maintain good quality:

| Quality Level | Daily Message Limit |
| - | - |
| New Sender | \~250 messages |
| Low Quality | 1,000 messages |
| Medium | 10,000 messages |
| High Quality | 100,000+ messages |

> [!WARNING]
>
> High block rates or spam reports will lower your quality rating and reduce your messaging limits. Always send relevant, requested content.

## Supported Features

### What's Supported

* **Platform numbers** — Use numbers purchased through our platform with automated AI verification
* **External numbers** — Bring your own mobile number and verify via SMS or voice call
* AI-powered automated replies
* Template messages (Utility, Marketing, Authentication)
* Voice Call Request templates (request permission to call via WhatsApp)
* WhatsApp voice calls (inbound anytime; outbound after the customer allows)
* Conversation history and tracking
* Automation platform integration

### Media & Vision

* **Image analysis (Vision)** — When customers send images, your AI assistant can analyze them using vision-capable LLMs (OpenAI, Claude, Gemini). The AI describes and responds to image content within the conversation.
* **Voice message transcription** — Incoming voice notes are automatically transcribed based on your assistant's language settings. The transcribed text is processed by the AI just like a regular message.
* **Media attachments** — All inbound media (images, audio, video, documents) are stored as attachments on the conversation and accessible from your dashboard.

## Getting Started

**1. Choose Your Number Type**

Decide whether to use a **platform number** (purchased from us) or your own **external mobile number**. External numbers must be able to receive SMS or voice calls for verification.

**2. Create a WhatsApp Sender**

Navigate to **WhatsApp Senders** and follow the setup wizard to connect your number to WhatsApp Business.

**3. Connect an AI Assistant**

Link an AI assistant to automatically respond to incoming messages.

**4. Create Templates**

Set up message templates for outbound conversations and wait for Meta approval.

**5. Start Messaging**

Your WhatsApp sender is ready! Customers can message you and receive AI-powered responses.

## Next Steps

* Learn how to [create WhatsApp senders](https://docs.receptonic.com/whatsapp/senders.md)
* Turn on [WhatsApp Calling](https://docs.receptonic.com/whatsapp/calling.md)
* Understand [message templates](https://docs.receptonic.com/whatsapp/templates.md) and approval process
* Set up [automation triggers](https://docs.receptonic.com/whatsapp/automation.md) for WhatsApp


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