**Send one approved template to every contact with the labels you choose, at a scheduled time, and see who received and read it.** ## Plan & access * **Chatwoot Cloud:** WhatsApp campaigns are available on the **Business plan and above**. They are on automatically; you do not need to request them. * **Self-hosted:** sending campaigns is not a premium feature. It works on Community Edition and is on by default. * **Campaign analytics:** Business plan and above on Cloud. On self-hosted, it needs a paid self-hosted plan. Your installation's super admin turns on **Campaign Analytics** in **Super Admin › Accounts ›** open the account **› Edit**, under **Premium features**, then clicks **Save changes**. * **Inbox:** WhatsApp Cloud API only (Quick setup or manual). Twilio and 360dialog inboxes cannot send campaigns. * **Who:** administrators. See [Pricing & Plans](https://www.chatwoot.com/pricing). **How to check you have it:** open **Campaigns** in the sidebar. If **WhatsApp** appears under it, campaigns are available for your account. ## Before you start * At least one **approved template** in your WhatsApp Cloud API inbox. See [Templates and the 24-hour window](https://www.chatwoot.com/hc/user-guide/articles/1754940076-whatsapp-templates). * The contacts you want to reach have a **label**, and either a **phone number** or a WhatsApp **Business-Scoped User ID (BSUID)** from an earlier conversation in this inbox. See [How to add labels?](https://www.chatwoot.com/hc/user-guide/articles/1677496066-how-to-add-labels), contact filters and segments, and [WhatsApp usernames and Business-Scoped User IDs](https://www.chatwoot.com/hc/user-guide/articles/1788437540-bsuid). * Every contact you send to has opted in to receive WhatsApp messages from your business. See [Meta's opt-in rules](https://developers.facebook.com/docs/whatsapp/overview/getting-opt-in). ## Create a campaign 1. Go to **Campaigns › WhatsApp** and click **Create campaign**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQU1MQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4aba186046c17a55cf4506c75874173314c9c602/wa08-g1-list.png) 2. **Basic settings:** enter a **Title** and pick your WhatsApp **Inbox**. The **Account information** panel shows the number's messaging tier, account status and quality rating from Meta. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR1lMQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8f93e8b1dda96f3c8255cac5349900dc021c85ec/wa08-g2-basic.png) 3. **Audience:** choose one or more **Labels**. Contacts with **any** of the labels are included. Click **View** to see exactly who is included. The panel shows how many customers your WhatsApp account can message. Labels only select who receives the campaign. They do not record consent, so add only contacts who have opted in. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTkVMQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0904b6915adf523221166140b1f5d0d1fe8d7156/wa08-g3-audience.png) 4. **Template:** pick an approved template and fill in its header, variables and buttons. Check the **Message preview**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjhNQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d824435b67d3aee104d3115fd8a0e12e061e49f2/wa08-g4-template.png) 5. Click **Schedule campaign**, pick a time and click **Create**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTEVNQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5218f7e2399566ed742f3cecb6b97df1a619d596/wa08-g8-schedule-popover.png) **Test it:** send the first campaign to a test label that contains only your own number. The **Live test** button at the top of the form is not available (its tooltip reads **Live test will be available soon**). ## What to expect * The campaign sends **once**, at the scheduled time. Its status moves from **Scheduled** to **Processing** to **Completed**. * You can edit it while it is **Scheduled**. Once it starts sending, it cannot be changed. * Chatwoot sends to the contact's phone number. If the contact has no phone number, it sends to the contact's BSUID for this inbox instead. A contact is **skipped** when: * it has neither a phone number nor a BSUID for this inbox * it has no phone number and more than one BSUID for this inbox (Chatwoot does not choose between them) * it has only a BSUID and the template is an **Authentication** template, or Chatwoot cannot find the template among the inbox's synced templates to check its category (authentication templates need a phone number) * the template variables cannot be filled in for that contact * Only **approved templates** can be sent. Free-text broadcasts are not possible on WhatsApp. * **Meta charges for template messages**, including every campaign message delivered. The rate depends on the template category and the recipient's country. Meta bills these charges to your WhatsApp Business account, separately from your Chatwoot subscription. Estimate costs with the [WhatsApp pricing calculator](https://www.chatwoot.com/tools/whatsapp-pricing-calculator) and see [Meta's current pricing](https://developers.facebook.com/docs/whatsapp/pricing). * How many customers you can message in a day is set by **Meta's messaging limit**, shared across all numbers in your business portfolio. See [Manage your WhatsApp number](https://www.chatwoot.com/hc/user-guide/articles/1791472075-11-manage-your-whats_app-number). * When customers reply, a new conversation opens in the inbox and the 24-hour window starts. * Campaign messages sent to a contact appear in their WhatsApp conversation, marked **Campaign**. ## See results Analytics is available on the Business plan and above on Chatwoot Cloud, or a paid self-hosted plan. Click **View analytics** on the campaign to see: * **Audience**, **Submitted to WhatsApp**, **Delivered**, **Read**, **Failed** and **Skipped** * The **Deliveries** table: each contact's status and, for failures and skips, the **Reason**. Filter it by status. * While a campaign is still sending, the numbers are partial. Analytics may be unavailable for campaigns sent before delivery tracking was introduced. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR0VOQVFjPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--026feeac42e5acd3dd4de030bf3d4fda7b3118c9/wa08-g6-analytics.png) ## Good practice * Create a dedicated label for each campaign instead of reusing a broad one. * Use **Utility** templates for updates and **Marketing** templates only for contacts who opted in. * Watch your quality rating after each campaign. Many blocks or reports can lower your messaging limit. ## Troubleshoot | Symptom | Likely cause | What to do | | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | No **WhatsApp** under Campaigns | Your plan does not include campaigns, or you are not an administrator | On Chatwoot Cloud, check you are on the Business plan or above. Check you are signed in as an administrator. If both are true and the tab is still missing, contact Chatwoot support. | | My inbox is not in the list | It is a Twilio or 360dialog inbox | Campaigns need a WhatsApp Cloud API inbox. See **[Choose how to connect WhatsApp](https://www.chatwoot.com/hc/user-guide/articles/1791465157-2-choose-how-to-connect-whats_app)** | | **This inbox has no approved templates that can be used in a campaign** | No approved templates, or they have not synced | Click **Sync Templates**. See **[Templates and the 24-hour window](https://www.chatwoot.com/hc/user-guide/articles/1754940076-whatsapp-templates)** | | Some contacts did not receive it | No phone number or BSUID, missing label, or Meta rejected the message | Open **View analytics**, filter by **Failed** or **Skipped**, and read the reason. For error codes, see [Troubleshoot WhatsApp](https://www.chatwoot.com/hc/user-guide/articles/1768986869-common-whats_app-issues-and-how-to-fix-them). | | I cannot edit the campaign | It has already started sending | Create a new campaign. |