Mass Campaigns

Before sending any bulk mass campaigns or starting conversations on official WhatsApp Business API (WABA), you must have approved Message Templates.

How to create a Template:
1. Navigate to Dashboard → Templates.
2. Click the "Create New Template" button (top right).
3. Fill in the template details:
   • Template Name: Unique name using lowercase letters and underscores (e.g., order_shipment_notice).
   • Category:
     - MARKETING: Choose this for offers, news, promotions, or general marketing.
     - UTILITY: Choose this for transactions, orders, OTPs, or notifications.
   • Language: Choose the language of your template text.
4. Build your Template Content:
   • Header (Optional):
     - NONE: Text only.
     - TEXT: Bold title text. Can contain a single variable {{1}} (e.g., "Hello {{1}}").
     - MEDIA: Choose Image, Video, or Document (.pdf) to send rich attachments.
   • Body (Required): Write the main text of your message. Add variables by clicking the "Add Variable" button or typing {{1}}, {{2}} in order.
     - Example: "Hi {{1}}, thank you for buying {{2}}. Your order status is {{3}}."
   • Footer (Optional): Add short, light grey text at the very bottom (e.g. copyright or brand tagline).
   • Buttons (Optional): Add interactive buttons at the bottom:
     - Quick Reply: Up to 3 clickable text buttons.
     - Call to Action: Up to 2 buttons (e.g., a "Visit Website" button with URL link, and a "Call Us" button with a phone number).
5. Add Variable Examples (Crucial Step):
   - For every variable you added in the Header or Body (like {{1}}, {{2}}), you MUST provide a realistic sample value (e.g. {{1}} = John, {{2}} = Laptop).
   - Warning: Meta will automatically reject templates if example values are missing or look fake.
6. Click Submit.
   - The template is sent directly to Meta for review.
   - Approval usually takes between 2 minutes and 2 hours.
   - You can monitor the approval status (Pending, Approved, Rejected) in your Templates page. Once "Approved", it can be used for campaigns.

Follow these exact steps to send a bulk WhatsApp broadcast to your contact list:

Step 1 — Prepare your Contact List:
• Create a new spreadsheet in Microsoft Excel or Google Sheets.
• Save it as an Excel (.xlsx) file.
• Make sure the first row contains column headers.
• Required Column:
  - phone: Must be in international format without the "+" sign or leading "00" (e.g., 923001234567, 14155552671).
• Custom Variable Columns:
  - Add extra columns if your template needs personalization variables (e.g., name, product, delivery_date).
  - Example Row: phone = 923001234567 | name = Ali | product = Keyboard.

Step 2 — Initiate the Campaign Wizard:
1. Go to Dashboard → Campaigns.
2. Click "New Campaign" (top right).
3. Set Campaign Details:
   • Campaign Name: Give it a descriptive name (e.g. "Eid Sale 2026").
   • Connection: Select the official WABA instance you want to send from (Campaigns require WABA).
   • Scheduling:
     - Send Immediately: Messages start queuing as soon as you finish.
     - Schedule for Later: Pick a future Date, Time, and Timezone.
4. Click Next.

Step 3 — Upload and Verify Leads:
1. Drag and drop your .xlsx file into the upload box.
2. The page will process the file and display a preview of the contacts and variables.
3. Verify that the total number of contacts loaded matches your spreadsheet.
4. Click Next.

Step 4 — Select Template & Map Variables:
1. Select your approved Meta Template from the dropdown.
2. Map your Template Variables:
   - The wizard will list all variables found in the template (e.g., Body Variable 1, Body Variable 2).
   - Match each template variable to a column from your uploaded spreadsheet.
     - Example: Map "Body Variable 1" ({{1}}) to the "name" column.
     - Example: Map "Body Variable 2" ({{2}}) to the "product" column.
3. Check the Live Preview window on the right side of the screen to see how the finalized message will look for a sample row.
4. Click "Finish & Create".

Step 5 — Monitor and Queue:
• The campaign will enter "Pending" or "Scheduled" status.
• The system processes broadcasts sequentially in the background to ensure high deliverability.
• Check the Campaigns list page at any time to view real-time delivery graphs and statistics.

Once a campaign starts sending, click on the campaign name in the dashboard to access the tracking center:

Real-Time Metrics:
• Total Leads: The number of recipients uploaded.
• Pending: Messages currently queued in the delivery engine.
• Sent: Successfully delivered to the WhatsApp gateway.
• Failed: Message could not be sent (common causes: invalid phone number, contact block, Meta account restriction).

Understanding WABA Messaging Tiers:
Meta restricts daily messaging limits for WABA numbers based on a tier system:
• Tier 1: 1,000 unique business-initiated conversations per 24 hours.
• Tier 2: 10,000 unique business-initiated conversations per 24 hours.
• Tier 3: 100,000 unique business-initiated conversations per 24 hours.
• Tier 4: Unlimited business-initiated conversations per 24 hours.
• How to upgrade: Your tier increases automatically when you send high-quality, non-spam messages to at least half of your current daily limit within a 7-day window.