Facebook Messenger Campaigns
Create and manage broadcast campaigns for Facebook Messenger from Facebook Messenger > Campaigns in the WhatsMark sidebar.
Important
Once a campaign is sent or being processed for sending, it cannot be edited. You can edit a campaign only before it is picked up for processing. Campaigns are processed via cron jobs and queue workers, so make sure your Cron Job Configuration and queue setup are properly configured.
Campaign List
The campaign list displays all your Messenger campaigns with the following columns:
| Column | Description |
|---|---|
| # | Serial number |
| Campaign Name | Name of the campaign |
| Template | The Messenger template used |
| Status | Campaign status (e.g., Completed, Pending, Processing) |
| Total | Total number of contacts targeted |
| Sent | Number of messages successfully sent |
| Failed | Number of messages that failed to send |
| Scheduled At | Scheduled date and time (if scheduled), or — for immediate |
| Created At | When the campaign was created |
| Actions | View Details or Delete the campaign |
Creating a New Campaign
Click the + Create Campaign button to start the multi-step campaign creation wizard. All fields marked with * are required.
Step 1: Basic Information
Enter campaign details and select a template.
| Field | Description |
|---|---|
| Campaign Name * | A name to identify your campaign |
| Relation Type * | Select the contact relation type to target |
| Template * | Select a Messenger template to use for this campaign |
A Live Preview panel on the right shows how your message will look to recipients as you select a template.
Step 2: Contact Selection
Choose the target audience for your campaign.
- Select All Contacts - Automatically include all contacts with Facebook Messenger
- Filter by Status - Filter contacts by their status
- Filter by Source - Filter contacts by their source
- Filter by Groups - Filter contacts by group membership
- Select Contacts - Manually search and select individual contacts from the list
Step 3: Variables & Files
Map template variables and upload media files.
- Upload Image - If your template uses an Image content type, the template default image is shown. You can upload a new image to override it (max file size: 25MB)
- Variable Mapping - Map each template variable to a merge field. Type
@to select from available fields like@contact_first_name
Step 4: Scheduling
Choose when to send your campaign.
| Option | Description |
|---|---|
| Send Immediately | Campaign will start immediately after creation |
| Schedule for Later | Choose a specific date and time to send |
If you select Schedule for Later, set the Scheduled Send Time using the date and time picker.
Click Create Campaign to finalize. The campaign will be queued for processing.
Campaign Details
Click View Details from the actions menu on any campaign to see the full campaign report.
Campaign Overview
The top section shows a summary of the campaign:
| Field | Description |
|---|---|
| Status | Current campaign status (e.g., Completed) |
| Template | Template used for the campaign |
| Scheduled For | immediate or the scheduled date/time |
| Created | Date and time the campaign was created |
Delivery Statistics
Three cards display the delivery performance:
| Metric | Description |
|---|---|
| Delivered | Number of messages delivered out of total, with delivery rate percentage |
| Pending | Number of messages still pending, with pending rate percentage |
| Failed | Number of messages that failed, with failure rate percentage |
Recipients
The recipients table shows per-contact delivery details:
| Column | Description |
|---|---|
| Contact | Contact name and PSID (Page-Scoped User ID) |
| PSID | The Facebook Page-Scoped ID of the recipient |
| Status | Delivery status (e.g., Sent) |
| Message Status | Message-level status (e.g., sent) |
| Response | Any response received from the recipient |
| Created At | When the message was sent |
You can Export the recipients list, adjust visible Columns, switch between Compact view, and Search for specific contacts.