WhatsApp Campaigns

The WhatsApp Campaigns module allows businesses to broadcast official Meta-approved marketing, utility, and transactional templates to target audiences at scale. Manage multi-channel broadcasts, upload customer contact lists via CSV, segment audiences from CRM data, schedule automated launches, customize table columns and ordering, and inspect granular delivery analytics and failure error logs from one unified dashboard.

---

1. Navigating to WhatsApp Campaigns

Main Sidebar ➔ Campaigns ➔ WhatsApp

1. In the main navigation sidebar on the left, click Campaigns to expand the channel menu.
2. Select WhatsApp from the submenu.
3. The WhatsApp Campaigns dashboard opens, listing all existing campaigns, their real-time execution status, and delivery metrics.

---

2. Managing the Campaigns Table

The main campaigns dashboard provides complete visibility over past and active broadcasts.

Table Controls & Customization Options

• Search Input (Search across all columns...): Search any campaign by name, connected account, template identifier, or creation date.
• Refresh Button (🔄): Reloads the campaign list and updates delivery metrics in real time without refreshing your browser.
• Columns Menu (Columns): Opens a multi-select dropdown allowing you to toggle visible table columns on or off:
  • Campaign Name
  • Account
  • Template
  • Status
  • Sent / Failed
  • Created At
  • Actions
• Order Menu (Order): Lets you rearrange column sequence or define the priority sorting order of the table columns using drag-and-drop handles.
• Create New Campaign (+ Create New Campaign): Opens the campaign builder wizard.

Table Columns Reference

Column Header	Description	Example / Values
Campaign Name	Internal title assigned to the broadcast campaign.	new launch offer, dec offer, demo
Account	The verified WhatsApp Business Account (WABA) used to dispatch the messages.	WhiteStart
Template	Pre-approved Meta message template name and category.	whitestart_launch_offer [MARKETING], contactus_trigger [UTILITY]
Status	Current operational status of the campaign batch.	sent
Sent / Failed	Ratio showing successful dispatches versus failed messages.	3 / 1, 4 / 0, 0 / 4
Created At	Timestamp when the campaign was created and queued.	Sep 8, 2026 2:49 PM
Actions	Action triggers to inspect performance metrics.	Click 👁 View to open detailed campaign analytics.

---

3. Creating a WhatsApp Campaign

Click the orange + Create New Campaign button at the top right of the campaigns page to open the campaign builder.

Step 1: Channel & Sender Account Selection

1. Under the top channel bar, select WhatsApp (alongside SMS, Email, RCS, and Voice).
2. Review the Sender Account card:
   • Displays the connected WABA Name (e.g., WhiteStart).
   • Displays the verified Display Phone Number (e.g., +91 94946 60198).
   • If multiple sender numbers are connected, choose the desired sender account from the list.
3. Enter a descriptive Campaign Name (e.g., Sep Offer 0909).

---

Step 2: Message Template & Header Media Selection

1. Click on the Message Template dropdown to search and choose an approved WhatsApp template.
2. The dropdown displays all synced templates with their Meta approval badge:
   • whitestart_launch_offer [MARKETING] APPROVED
   • whitestart_plan_upgrade [MARKETING] APPROVED
   • whitestart_subscription_expired [UTILITY] APPROVED
   • whitestart_welcome_signup [MARKETING] APPROVED
   • contactus_trigger [UTILITY] APPROVED
3. If the selected template contains dynamic media in the header, the Header Media upload field will appear:
   • Click Choose file and upload your creative graphic, banner, or promotional asset (e.g., sun real estate cover image.png).
   • Review the real-time layout in the Mobile Preview pane on the right side of the screen.

Tip

• Ensure your templates are pre-approved by WhatsApp.
• Use dynamic personalization tags (e.g., {{name}}) to boost recipient engagement.
• Keep media files under 5MB for rapid delivery and preview rendering.

---

Step 3: Selecting Target Audience

WhiteStart provides two distinct audience targeting modes:

Option A: CSV Upload

Send broadcasts to external lists or newly imported contact sheets.

1. Under 2. Target Audience, select the CSV Upload tab.
2. Click Choose file and upload your recipient list (e.g., StartupLanes India 21.csv).
3. Ensure the CSV file includes dedicated columns for phone numbers (with country code) and any required template personalization variables.
4. Once processed, the validation card confirms:
   • File processed successfully
   • Total count of valid recipient numbers (e.g., 466 valid records found.).

Option B: CRM Segment

Send broadcasts to dynamically filtered segments directly from your built-in CRM database.

1. Under 2. Target Audience, select the CRM Segment tab.
2. Click the Select Segment dropdown:
   • All Active Users: Broadcasts to all active registered contacts.
   • VIP Customers: Targets top-tier accounts and high-value purchasers.
   • Inactive > 30 Days: Re-engages dormant leads and lapsed customers.

---

Step 4: Scheduling & Campaign Launch

Under 3. Schedule, define when the campaign should be dispatched.

• Immediate Launch: Leave the Schedule Campaign toggle switched OFF and click the orange 🚀 Launch Campaign Now button to start instant delivery.
• Scheduled Launch:
  1. Toggle the Schedule Campaign switch to ON.
  2. In the Select Date & Time picker, configure your target future date and exact time (e.g., September 8th, 2026 at 17:01).
  3. Click the orange 🚀 Schedule Campaign button to queue the batch.

---

4. Viewing Campaign Analytics & Performance

From the main campaigns table, click 👁 View in the Actions column next to any campaign to open its dedicated analytics dashboard.

Top Metric Summary Cards

• Total Messages: Total recipient records queued in the broadcast (e.g., 4).
• Success Sent: Total messages accepted by WhatsApp servers and delivery percentage (e.g., 3 | 75% success rate).
• Delivered: Total messages successfully delivered to recipient devices (e.g., 1 | 33% delivery rate).
• Read: Messages opened and read by recipients (e.g., 2 | 67% read rate).
• Failed: Messages that could not be delivered due to ecosystem or recipient errors (e.g., 1 | 25% failure rate).

Visual Analytics & Engagement

• Message States Donut Chart: Visual breakdown displaying the proportion of Delivered, Failed, Read, and Sent messages.
• Engagement Timeline Graph: Real-time chronological tracking showing when recipients opened and read your broadcast over time.
• Mobile Preview: Exact replica of the template, header image, and button layout as seen on recipient smartphones.
• Top Failure Reasons: Itemized breakdown of delivery errors returned by Meta (e.g., “In order to maintain a healthy ecosystem engagement, the message failed to be delivered”).

---

5. Inspecting Detailed Live Message Logs

To audit individual recipient delivery timestamps, read receipts, and error codes, click the orange View Detailed Logs button in the top right of the campaign analytics view.

Live Message Logs Modal Controls

• Search Phone…: Quickly filter logs by typing a specific recipient phone number.
• Status Filter (All Statuses ▾): Filter the log modal by specific message states:
  • All Statuses: Shows all records.
  • Sent: Messages dispatched from WhiteStart servers to Meta.
  • Delivered: Messages verified as delivered to the handset.
  • Read / Answered: Messages opened and viewed by the recipient.
  • Failed / No Answer: Messages that encountered delivery failures or rate limits.
• Refresh (🔄 Refresh): Fetch live delivery receipts from Meta in real time.
• Download CSV (⬇ Download CSV): Export the full campaign audit log with all recipient timestamps and error descriptions into a spreadsheet.

Message Logs Data Schema

Field Name	Description	Example / Values
Recipient	The recipient’s normalized phone number with country code.	919492288163, 918639958995, 919182419079
Status	Terminal delivery status badge.	read (orange), Delivered (amber), failed (red)
Sent At	Timestamp when the message left WhiteStart servers.	Sep 8, 14:49
Delivered At	Exact timestamp when the message reached the handset.	14:49:47, 14:49:48
Read At	Exact timestamp when the recipient opened the chat.	15:18:05, 14:50:13
Error	Meta API error code and diagnostic explanation for delivery failures.	131049 In order to maintain a healthy ecosystem engagement...

Note

If messages fail with error code 131049, Meta has temporarily rate-limited outreach to protect recipient experience. Maintain high template quality, clean your contact numbers regularly, and target active opt-in users to protect your phone number quality rating.