---
url: >-
  https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/facebook-messenger-campaigns.md
description: >-
  Create and manage broadcast campaigns for Facebook Messenger in WhatsMark.
  Send template messages to contacts with scheduling and delivery tracking.
---

# Facebook Messenger Campaigns

Create and manage broadcast campaigns for Facebook Messenger from **Facebook Messenger > Campaigns** in the WhatsMark sidebar.

::: warning 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](../installation/cron-jobs.md) 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 |

![Facebook Messenger Campaigns](../images/facebook-messenger/fb-campaigns-list.png)

## 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.

![Create Campaign - Basic Information](../images/facebook-messenger/fb-campaign-step1.png)

### 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

![Create Campaign - Contact Selection](../images/facebook-messenger/fb-campaign-step2.png)

### 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`

![Create Campaign - Variables & Files](../images/facebook-messenger/fb-campaign-step3.png)

### 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.

![Create Campaign - Scheduling](../images/facebook-messenger/fb-campaign-step4.png)

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 Details](../images/facebook-messenger/fb-campaign-details.png)

### 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.