Scheduled Broadcast Campaigns

Summary

Timing is a critical determinant of marketing campaign success on WhatsApp. Delivering messages when customers are commuting, on lunch breaks, or browsing in the evening yields substantially higher read and engagement rates than off-peak dispatches.

Wabixo's Scheduled Broadcasts Console (/dashboard/marketing/scheduled) empowers marketing teams to plan, draft, and schedule promotional outreach days or weeks in advance. Backed by an automated, minute-by-minute background queue worker (campaign-schedule-monitor), scheduled campaigns execute autonomously at the designated timestamp without requiring manual operator intervention.

---

Accessing Scheduled Broadcasts

1. Log in to your Wabixo dashboard with Marketing permissions (CanAccessMarketing).
2. In the top navigation bar, click Marketing (/dashboard/marketing).
3. Select the Scheduled Broadcasts tab from the sidebar navigation (or navigate directly to /dashboard/marketing/scheduled).

---

1. Scheduling Modes & Cadences

Campaign scheduling is configured during Step 5 of the standard Broadcast Campaign Wizard:

Scheduling Cadence	Execution Behavior	Typical Use Case
On Time (One-Time)	Executes once at a specific future calendar date, time, and timezone.	Flash sales, festival promotions, grand opening events.
Daily	Executes every day at the designated hour and minute.	Daily morning reminders, daily menu announcements.
Weekly	Executes on a selected day of the week (e.g. Every Monday at 10:00 AM).	Weekly specials, weekend preview offers, Tuesday discounts.
Monthly	Executes on a specific calendar day of every month (e.g. 1st or 15th of the month at 11:00 AM).	Monthly membership renewals, monthly statement alerts.

Step-by-Step Scheduling Flow:

1. In Marketing › Broadcasts, click + New Campaign (or trigger directly from an audience segment).
2. Complete Steps 1 through 4 (Template selection, Segment targeting, Cost verification, and Dynamic variable mapping).
3. On Step 5: Scheduling & Dispatch Mode:
   • Select Schedule for Later.
   • Choose your cadence: Once, Daily, Weekly, or Monthly.
   • For Once: Select the target date from the calendar.
   • For Weekly: Select the target weekday (e.g. Friday).
   • For Monthly: Select the target day of the month (e.g. 1st).
   • Launch Time: Set the exact hour and minute using the 24-hour time selector (e.g. 18:30 for 6:30 PM).
   • Timezone Confirmation: Verify that the displayed timezone aligns with your audience's local time (e.g. Asia/Kolkata).
4. Click Next to review the pre-flight summary and confirm.

---

2. Managing the Scheduled Broadcast Queue

The Scheduled Broadcasts page provides a centralized overview of all upcoming jobs:

Column / Card Field	Information Displayed	Operational Significance
Broadcast	Internal campaign title and template name.	Identifies campaign purpose and copy.
Audience	Name of the bound audience segment.	Confirms recipient targeting parameters.
Mode	Template Only or Template + Webpage.	Dispatch format.
Timing / Schedule	Primary schedule label (e.g. Every Friday at 10:00 AM or 15 Oct 2026, 06:30 PM).	Target execution window and cadence.
Recipients	Total number of unique, validated recipient numbers.	Final estimated audience size.
Status Badge	On Time, Daily, Weekly, or Monthly.	Visual cadence indicator.
Created By & Date	Team member name and creation timestamp.	Operational audit trail.
Actions	Edit / Reschedule button and Cancel / Delete button.	Real-time queue management before dispatch begins.

---

3. Editing and Cancelling Scheduled Broadcasts

Until a scheduled campaign reaches its designated execution timestamp, administrators retain complete control:

Editing a Campaign

If campaign parameters or dates need adjustment:

1. Locate the campaign in the Scheduled Broadcasts table.
2. Click the Edit (Pencil) icon.
3. The Edit Campaign Dialog opens, allowing you to:
   • Adjust template variable values and fallbacks.
   • Modify the scheduled dispatch time or cadence.
4. Click Save Changes. The background scheduler updates the job parameters immediately.

Cancelling a Scheduled Campaign

If a promotion is called off:

1. Click the Delete (Trash) icon on the campaign row.
2. A confirmation dialog will prompt: "Are you sure you want to delete this scheduled broadcast? This action cannot be undone."
3. Confirm deletion.
4. The scheduled job is immediately purged from the dispatch queue. No conversation wallet credits are deducted.

---

4. Automated Background Execution Architecture

Wabixo's backend scheduling engine is engineered for resilience and high concurrency:

1. Minute-by-Minute Monitor (* * * * *): A dedicated background cron task (checkCampaignSchedules) runs every 60 seconds on the server.
2. Atomic Job Claiming: When current clock time reaches or passes a campaign's launch time, the worker atomically claims due schedules via database transactions to prevent duplicate dispatches.
3. Pre-Execution Wallet Validation: Prior to transmitting messages, the worker verifies that the sending WABA account has sufficient prepaid conversation credits.
4. Concurrent Batch Dispatch: Messages are dispatched in high-throughput worker batches complying with Meta messaging rate limits.
5. Telemetry Hand-off: As soon as dispatch starts, the campaign transitions to Broadcasts (/dashboard/marketing/campaigns) and the Campaign Details view (/dashboard/marketing/campaigns/:id) for real-time delivery tracking.