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

# Send WhatsApp campaigns with approved message templates

> Send outbound WhatsApp campaigns to your contacts using pre-approved Meta message templates. Step-by-step guide for creating, sending, and tracking WhatsApp campaigns.

A WhatsApp campaign in Chatbase sends an approved WhatsApp message template to many of your contacts at once, from the WhatsApp number connected to your AI agent. It's for businesses, such as online stores and service providers, that want to message customers first, for example with order follow-ups or reminders, instead of waiting for them to write in. You create and track WhatsApp campaigns from the **Outbound** page, and replies go to your AI agent or your Helpdesk team.

WhatsApp campaigns let you send bulk messages to your contacts using pre-approved message templates from Meta. This is the primary way to proactively reach out to customers on WhatsApp outside the 24-hour conversation window.

> [!NOTE]
>
> WhatsApp requires all outbound messages to use **pre-approved templates**. You cannot send free-form text as a campaign. Templates must be created in Meta and approved before use. See the [WhatsApp Templates guide](https://chatbase.co/docs/user-guides/integrations/whatsapp-templates.md) for how to create and manage templates.

## Prerequisites

* A connected WhatsApp integration ([setup guide](https://chatbase.co/docs/user-guides/integrations/whatsapp.md))
* At least one approved message template in Meta ([WhatsApp Templates guide](https://chatbase.co/docs/user-guides/integrations/whatsapp-templates.md))
* Contacts with phone numbers in your contact list ([Contacts guide](https://chatbase.co/docs/user-guides/chatbot/contacts/contacts-overview.md))
* A payment method configured in your [Meta billing settings](https://business.facebook.com/billing_hub)
* Opt-in from your recipients, as Meta's WhatsApp policy requires

> [!WARNING]
>
> Meta charges fees for each template message sent. Fees vary by country and template category. See [Meta's WhatsApp pricing](https://developers.facebook.com/docs/whatsapp/pricing) for current rates.

## Campaign ideas for stores

These are ideas to adapt, not ready-made campaigns. Each one needs an approved template that fits it, and contacts with the details you want to use. Name the templates and attributes however suits your business.

| Idea | Who to send it to | How to set it up |
| - | - | - |
| **Order follow-up** | Customers with a recent order | Use a **Utility** template, the category for order updates. Map the customer's name to the **Name** contact field. Keep **AI replies** on so the AI agent can answer questions about the order. |
| **Back in stock** | Customers who asked about an item | Tag interested contacts with a custom attribute, then filter the audience by that tag. Set the product name as a **Static value**, since it's the same for every recipient. |
| **Appointment reminder** | Customers with an upcoming booking | Store the booking detail you want to show as a custom attribute, and map it to a template variable so each customer sees their own. Choose **Human takeover** if your team should handle reschedule requests. |

> [!TIP]
>
> If customers often ask the same follow-up questions after a campaign, add the answers to your AI agent's [Data Sources](https://chatbase.co/docs/user-guides/chatbot/data-sources.md) before you send, so **AI replies** can handle them.

## Getting templates approved

Campaigns can only send templates Meta has approved, and a template appears in the **Select from template** picker only after approval. From the [WhatsApp Templates guide](https://chatbase.co/docs/user-guides/integrations/whatsapp-templates.md):

* **Keep the message clear and concise.**
* **Avoid promotional language,** and clearly state the transactional or authentication purpose of the template.
* **Expect a review.** Meta usually reviews templates within a few minutes, but it can take longer, so submit templates ahead of a planned campaign.
* **Avoid URL buttons with a variable.** Campaigns can't send a template whose URL button contains a `{{1}}`-style placeholder. Edit the template in WhatsApp Manager to use a fixed address, or use a version without the button.

## Creating a WhatsApp Campaign

1\. Click **Outbound** in the sidebar and click **+ New campaign**.

![Campaigns list page with New campaign button](https://mintcdn.com/chatbase/St1vNiMgEx0Vl5Y7/user-guides/chatbot/images/outbound-campaigns/campaigns-list.png?fit=max\&auto=format\&n=St1vNiMgEx0Vl5Y7\&q=85\&s=c7b3983df5281acd5252054ae9dabb42)

The new campaign page has two tabs: **Configuration** and **Audience**.

### Configuration

![New campaign configuration page showing Delivery, Replies, and Content sections with a message preview](https://mintcdn.com/chatbase/St1vNiMgEx0Vl5Y7/user-guides/chatbot/images/outbound-campaigns/new-campaign-config.png?fit=max\&auto=format\&n=St1vNiMgEx0Vl5Y7\&q=85\&s=310c38b56745d88016b022b3176b40cc)

**Delivery:** Select **WhatsApp** as your channel and choose the phone number to send from. The selected number displays its verified business name.

**Replies:** Choose how your team handles replies from campaign recipients:

* **AI replies** (default): Your AI agent responds to replies automatically. The conversation continues like any normal inbound chat.
* **Human takeover**: When a recipient replies, a Helpdesk ticket is created automatically. Your team picks up the conversation from there.

**Content:** Enter a campaign name, then click **Select from template** to browse your approved templates from Meta. A preview of the message appears on the right as you configure it.

All template categories are supported: **Marketing**, **Utility**, and **Authentication**. Templates with headers (image, video, or document) display a media preview.

![Completed campaign configuration with template selected and message preview](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/config-complete.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=47efb3878889be4d32dd1ff2abc5ef2d)

If your template includes variables (e.g., `{{name}}`), map each one to a data source:

* **Contact field:** Pulls from the recipient's contact data (name, email, phone number, or custom attributes). Each recipient gets a personalized value.
* **Static value:** Enter fixed text that will be the same for all recipients.

Click on a variable in the template body to open the mapping dropdown.

![Variable mapping dropdown showing contact fields (Name, Email, Phone), custom attributes (Tag, City), and free text option](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/variable-mapping-dropdown.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=1ad34525c525917e2edcb8676f5659dd)

### Audience

Switch to the **Audience** tab to choose recipients.

![Audience tab showing the contact list with name, tag, and city columns](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/audience-contacts.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=667b1f4fd099739a4782cde795f8bc45)

Browse your contact list and select who should receive the campaign. You can:

* **Search** contacts by name or phone number
* **Filter** by custom attributes: click a column header like **Tag** or **City** to filter by specific values. Each filter matches one exact value; date ranges aren't supported

![Tag filter dropdown showing Customer and VIP Customer options](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/audience-filter-dropdown.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=ce66695128dd04d19d85c9f56ceca818)

![Contact list filtered by Customer tag showing matching contacts](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/audience-filtered.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=57cd4d19af7076276f1f49e7e4afc07b)

You can combine search and filters to narrow down your audience further.

![Audience filtered by city and searched by name, showing one matching contact](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/audience-search.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=b3a14ce87437e7f4b69db3c8c0e10731)

The selected contact count appears at the top of the tab. At least one contact is required to send.

> [!NOTE]
>
> Only contacts with a valid phone number can receive WhatsApp campaign messages. If a contact doesn't appear in the list, make sure their phone number is set in their [contact profile](https://chatbase.co/docs/user-guides/chatbot/contacts/contacts-overview.md).

## Sending Your Campaign

Once you've configured delivery, content, and audience, click **Send now** in the top right. The campaign goes out right away; campaigns can't be scheduled. You'll be redirected to the campaign detail page where you can monitor delivery in real time.

## Monitoring Delivery

After sending, the campaigns list shows the status and activity for each campaign at a glance. Hover over the activity bar to see a breakdown of delivery stages.

![Campaign activity bar with tooltip showing Sent, Delivered, and Replied counts](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/campaigns-activity-tooltip.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=5093efd33f07fa999545bbc06cc576f2)

Click a campaign to open the detail page with full delivery visibility:

* **Status counters:** Queued, Sending, Sent, Delivered, Read, Replied, and Failed counts at the top.
* **Overview:** Campaign name, channel, reply mode, send time, and recipient count.
* **Content:** The template message that was sent.
* **Delivery funnel:** A visual breakdown showing the percentage of recipients at each stage. Helps you see drop-off between Sent → Delivered → Read → Replied.
* **Recipients table:** A searchable, filterable list of every recipient with their delivery status and timestamps.

![Campaign detail page showing overview, content, delivery funnel, and recipients table](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/campaign-detail.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=d63a277d0908ef1701881765073e8e1a)

> [!NOTE]
>
> **Understanding messaging tiers:** Meta assigns a messaging tier to your WhatsApp Business Account based on quality and volume. Your tier determines how many unique contacts you can message per day. The current usage is shown as **Meta limits** in the top right of the campaigns page.

## Reply Handling

When contacts reply to your campaign, the behavior depends on the mode you selected during creation:

**AI Replies:** Your AI agent handles the reply automatically. The conversation continues like a normal inbound chat. This works well for product inquiries, support questions, and automated follow-ups.

**Human Takeover**: The reply creates a Helpdesk ticket tagged with the campaign name. Your team picks up the conversation and responds manually from the Helpdesk inbox.

![Helpdesk ticket created from a campaign reply, showing the campaign name in the subject and the recipient's message](https://mintcdn.com/chatbase/rt2QeVIgaPfKUcEa/user-guides/chatbot/images/outbound-campaigns/helpdesk-ticket.png?fit=max\&auto=format\&n=rt2QeVIgaPfKUcEa\&q=85\&s=92cff7765bfb664f99accef8f6cc4b43)

## Troubleshooting

* **Campaign stuck in "Sending"?** Large campaigns are processed in batches and may take a few minutes. If there's no progress after 10 minutes, check that your [WhatsApp integration](https://chatbase.co/docs/user-guides/integrations/whatsapp.md) is still connected.
* **Recipients showing "Failed"?** Common causes include an invalid phone number, Meta rate limits being reached, or a missing payment method in your [Meta billing settings](https://business.facebook.com/billing_hub).
* **Template not appearing?** Make sure the template has been approved in Meta. Only approved templates appear in the campaign template picker.
* **Replies not creating tickets?** Verify that reply behavior is set to **Human Takeover**.
* **Hitting rate limits?** Your Meta messaging tier determines daily send limits. Check your tier on the campaigns page. To increase your tier, maintain high message quality and gradually increase volume.

## Frequently asked questions

> [accordion] Why do WhatsApp campaigns need templates?
>
> WhatsApp requires outbound messages to use templates that Meta has approved. Free-form messages only work within 24 hours of a customer's last message, so a template is how you reach contacts who haven't written to you recently.

> [accordion] Which template categories can I send in a campaign?
>
> All of them: **Marketing**, **Utility**, and **Authentication**. Templates with an image, video, or document header show a media preview while you configure the campaign.

> [accordion] How do I personalize each message?
>
> Map each template variable to a **Contact field**, such as name, email, phone number, or a custom attribute, so each recipient gets their own value. Use a **Static value** for text that's the same for everyone.

> [accordion] How many contacts can I message per day?
>
> It depends on the messaging tier Meta assigns your WhatsApp Business Account, based on quality and volume. Your current usage appears as **Meta limits** at the top right of the campaigns page. To move up a tier, keep message quality high and increase volume gradually.

> [accordion] What does a WhatsApp campaign cost?
>
> Sending a campaign doesn't use Chatbase message credits. Meta charges a fee for each template message sent, which varies by country and template category. See [Meta's WhatsApp pricing](https://developers.facebook.com/docs/whatsapp/pricing). When your AI agent answers replies, those replies use message credits based on its [AI model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md).

> [accordion] Can I schedule a campaign?
>
> No. A campaign is sent as soon as you click **Send now**.

> [accordion] How many contacts can one campaign reach?
>
> Up to 50,000. Meta's messaging tier can still limit how many unique contacts you reach per day.

> [accordion] Where do replies go?
>
> With **AI replies**, your AI agent answers and the conversation continues like a normal inbound chat. With **Human takeover**, each reply creates a Helpdesk ticket tagged with the campaign name.


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