# Campaigns

The WhatsApp Campaigns section under Interactions enables teams to create and execute targeted messaging campaigns to specific user groups or segments. This feature is essential for marketing outreach, customer re-engagement, promotional offers, and scheduled communications via WhatsApp Business API.

> All campaigns require approved WhatsApp templates and valid user consent for compliance.

## Campaigns Dashboard

The main dashboard displays all your WhatsApp campaigns in a comprehensive table view. Each row provides key campaign metrics and status information:

**Campaign Name:** Internal identifier for the campaign.

**Time:** Timestamp showing when the campaign was executed or scheduled.

**Sent:** Number of messages successfully dispatched with progress indicator.

**Delivered:** Messages confirmed as delivered to recipient devices.

**Read:** Messages opened by recipients (when read receipts are available).

**Failed:** Messages that couldn't be delivered due to various reasons.

**Status:** Current campaign state (Completed, In Progress, Scheduled, etc.).



<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FJy8FoX5aQKZGTbIzkSBX%2Fimage.png?alt=media&#x26;token=fa48f3e0-244a-4f8e-9d8c-1f7d18f94190" alt=""><figcaption></figcaption></figure>

## Campaign Details View

Clicking on any campaign from the dashboard opens a detailed view showing comprehensive information about that specific campaign.

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FZAItSc0zEE9pd9hPCeyH%2Fimage.png?alt=media&#x26;token=4c18e807-ba2c-40c2-be3d-7c67a98db559" alt=""><figcaption></figcaption></figure>

### **Campaign Overview**

* **Name:** The campaign identifier
* **Status:** Current state with visual indicator (Completed, In Progress, etc.)
* **Description:** Internal notes about the campaign purpose

### **Broadcast Settings**

* **Dispatch Mode:** Shows whether the campaign was sent instantly or scheduled
* Template preview appears on the right showing the actual message sent to users

### **Users**&#x20;

View all user groups included in the campaign displayed as filter tags. This shows which audience segments received the campaign messages.

### **Metrics**&#x20;

The metrics section allows to assess campaign performance, understand audience engagement, and gather insights for future messaging strategies.

* **Sent:** Total messages dispatched
* **Delivered:** Messages successfully delivered to devices
* **Read:** Messages opened by recipients
* **Replied:** Users who responded to the campaign
* **Total:** Overall campaign volume
* **Failed:** Messages that couldn't be delivered
* **Processed:** Messages handled by the system
* **Queued:** Messages waiting to be sent

> Use the Sync button to refresh campaign metrics and get the latest delivery status updates.

## Create New Campaign

Click the **New** button to launch the 5-step campaign creation workflow:

### **Step 1:** Name and Description

Define the campaign's basic information for internal reference.

> Campaign names cannot be changed once the campaign is saved and executed.

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FIDCyGfxTNAFgRh3952WR%2FCreateCampaign-ezgif.com-video-to-gif-converter%20(2).gif?alt=media&#x26;token=90aba7cb-656c-4f2f-9d56-9f2fe33ed697" alt=""><figcaption></figcaption></figure>

### **Step 2:** Users

Select the target audience for your campaign.

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2Fz05a6hZzBTwCYbwNPybe%2FCreateCampaign-ezgif.com-video-to-gif-converter%20(3).gif?alt=media&#x26;token=82cae6e6-5bb2-4eaf-934e-608fc6c24b84" alt=""><figcaption></figcaption></figure>

**User Groups** Choose from existing user groups in your system. The interface shows:

**Create New Group** If needed, you can create a new user group by clicking the "New Group" link.

The system displays user validation metrics:

* Green indicators for valid contacts
* Warning indicators for potential issues (missing data, invalid numbers)

> Only users with valid WhatsApp numbers and proper opt-in consent will receive campaign messages.

### Step 3: Template

Choose from your library of approved WhatsApp templates using the dropdown menu that will be sent to your audience.

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FSYR0iAuK6EQAOhONZK60%2FCreateCampaign-ezgif.com-video-to-gif-converter%20(4).gif?alt=media&#x26;token=3e673cbe-6b94-4760-a8b1-dfe7a111bbf2" alt=""><figcaption></figcaption></figure>

#### **Variable Inputs (Required)**&#x20;

If your template contains variables, you must configure how they'll be populated:

* **Static Values:** Use the same value for all recipients
* **User Attributes:** Pull dynamic data from user profiles (name, order details, etc.)

The right panel shows a live preview of how the message will appear on WhatsApp, including your variable substitutions.

> Only approved WhatsApp templates can be used for campaigns. Unapproved templates will not appear in the selection dropdown.

### Step 4: Broadcast Settings

Configure how and when your campaign will be delivered.

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FpaPU73UyvHpISDkuCP3v%2FCreateCampaign-ezgif.com-video-to-gif-converter%20(5).gif?alt=media&#x26;token=f263b4bb-52b6-48b7-a32d-5ffa68eb134b" alt=""><figcaption></figcaption></figure>

#### **Channel Selection**&#x20;

Select the WhatsApp Business phone number from which messages will be sent. The system shows available verified numbers linked to your account.

#### Broadcast Setting

Choose when to send your campaign:

* **Instant:** Send immediately upon campaign creation.
* **Scheduled:** Set a specific date and time for delivery.

#### Batching (Optional)&#x20;

Enable message batching to control delivery rate and avoid overwhelming recipients:

* **Interval:** Time gap between batches (in hours).
* **Number of Batches:** How many groups to split your audience into.

#### User Split Across Batches&#x20;

The system automatically calculates how users will be distributed across batches, showing:

* Batch names (Batch 1, Batch 2, etc.)
* Percentage of total audience per batch.
* User count per batch.

This ensures controlled message delivery while maintaining compliance with WhatsApp's rate limits.

> Batching is recommended for large campaigns to maintain delivery quality and comply with WhatsApp Business API rate limits.

### Step 5: Review

The final step provides a comprehensive summary before campaign execution. Review all configured details

<figure><img src="https://1498739645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9LCwJgTgcJ0hBsgJLqUA%2Fuploads%2FuwlcCgKlGPlNoZ550Oqr%2FCreateCampaign-ezgif.com-video-to-gif-converter%20(6).gif?alt=media&#x26;token=c861c63a-a1b9-41af-ab20-f8e84a3e742b" alt=""><figcaption></figcaption></figure>

Once reviewed, click **Save** to create the campaign. Depending on your dispatch mode, the campaign will either begin sending immediately or be scheduled for the specified time.
