> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Marketing Messages

> Comprehensive guide to Facebook Marketing Messages in ChatbotX: Meta authorization, Campaign management, marketing messages, and Custom Audiences.

**Facebook Marketing Messages** is a specialized promotional solution within the Tools module of ChatbotX, empowering businesses to broadcast marketing campaigns, re-engagement messages, and personalized offers to customers on Facebook Messenger even outside the standard 24-hour messaging window.

Built directly upon Meta's **Marketing Message API**, this feature delivers a compliant, page-safe outbound messaging channel billed per delivered message via your connected Meta Ad Account.

> [!NOTE]
>
> As of February 10, 2026, Meta has deprecated free Recurring Notifications globally. All marketing messages sent outside the standard 24-hour window on Messenger are delivered as Paid Marketing Messages charged through your Meta Ad Account on a per-delivered-message basis.

## Messenger Message Types Comparison

To maintain high delivery rates and adhere strictly to Meta platform policies, understand the operational boundaries of each Messenger message type:

| Message Type | Allowed Window | Cost | Permitted Content |
| :- | :- | :- | :- |
| **Standard Messaging (24h)** | Within 24 hours of customer's last inbound message | Free | Unrestricted: support, sales advisory, promotions, automated flows |
| **Utility Messages** | Outside 24h window (using approved Message Tags) | Free | Account updates, order confirmations, event reminders. **Promotional content strictly prohibited** |
| **Marketing Messages** | Outside 24h window (requires contact Opt-in) | Billed via Ad Account | Discounts, vouchers, exclusive promos, product launches, newsletters |

> [!NOTE]
>
> When a contact receives a marketing message and taps a Quick Reply button, an action button, or replies with text, the free 24-hour standard messaging window reopens immediately. Live human agents or AI Agents can then converse two-way at zero additional cost.

## Meta Connection and Authorization Workflow

Before creating marketing campaigns or audience segments, complete the Meta authorization process to grant messaging permissions and link a billing Ad Account.

**1. Navigate to Facebook Marketing Messages**

In the main left navigation sidebar of ChatbotX, select **Tools** and click the **Facebook Marketing Messages** card.

![Facebook Marketing Messages Tool Location](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_tool_location.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=8ac2cea164cf65fc30f967e55849f2d0)

**2. Initiate Facebook Access Request**

On the onboarding card, click the blue **Grant access** button to open the secure Meta OAuth dialogue.

![Facebook Marketing Messages Grant Access](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_grant_access.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=404133a29f8d64e7f53db01268892f49)

**3. Confirm Facebook Administrator Identity**

Meta prompts you to verify your administrative profile. Confirm the correct Facebook user account and click **Continue**.

![Facebook Marketing Messages Oauth Identity](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_oauth_identity.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=e8b2c94d03417c4f0e5dfda919314b37)

**4. Choose Page Authorization Scope**

Select your preferred page management permission:

* **Opt in to all current and future Pages**: Grants permissions across existing Pages and newly created Pages (recommended).
* **Opt in to current Pages only**: Limits authorization strictly to currently selected Pages.

Click **Continue** to proceed.

![Facebook Marketing Messages Choose Pages](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_choose_pages.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=79b7a024643830c30c50569a041841d5)

**5. Select Facebook Pages and Billing Ad Account**

Configure the mandatory operational pairings:

* **Facebook Pages**: Select the Facebook Pages authorized to broadcast marketing messages.
* **Ad Accounts**: Select the Meta Ad Account responsible for settling delivered message charges.

Review and accept the Beta Terms for Messenger Marketing Messages, then click **Continue**.

![Facebook Marketing Messages Select Ad Account](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_select_ad_account.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=c5a5b0578210f64df345514db729133c)

**6. Configure Automated Subscriber Growth**

Meta provides two automated opt-in expansion features:

* **Invites people to receive marketing messages**: Dispatches opt-in invitations to contacts who previously received utility updates from your Page prior to February 10, 2026.
* **Sends out future invitations automatically**: Sends opt-in prompts when contacts comment on Page posts, initiate conversations from Click-to-Messenger ads, or remain inactive for 48 hours.

Enable or disable options according to your strategy and click **Continue** to finalize authorization.

![Facebook Marketing Messages Grow Customer Base](https://mintcdn.com/chatbotx/XZq-CUIrAKPxmcwA/images/facebook_marketing_messages_grow_customer_base.png?fit=max\&auto=format\&n=XZq-CUIrAKPxmcwA\&q=85\&s=c19e6af8e1e30f063e95d96b0ed588b1)

## Facebook Marketing Messages Dashboard Architecture

Once connected, the Facebook Marketing Messages control center provides 3 dedicated workspaces in the top navigation:

* **Campaigns**: Create, schedule, and review outbound broadcast campaigns, monitoring delivery throughput, spend, and completion rates.
* **Audiences**: Build and manage custom audience segments from ChatbotX contact filters or imported files for targeted message delivery.
* **Statistics**: Review aggregated delivery analytics, engagement KPIs, and return on ad spend.

## Managing and Creating Marketing Campaigns

The **Campaigns** tab provides complete administrative control over creating, scheduling, and monitoring outbound marketing broadcasts.

### Campaign Management Dashboard

The dashboard provides a complete overview of active and historical campaigns:

![Facebook Marketing Messages Dashboard Campaigns](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_dashboard_campaigns.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=36396c51df21149d764bb2d26e3807cc)

The campaign management table provides the following columns:

| Column | Description |
| :- | :- |
| **Name** | Internal campaign title. |
| **Facebook Page** | Originating Facebook Page delivering the broadcast. |
| **Ad account** | Connected Meta Ad Account billed for message delivery. |
| **Budget** | Monetary expenditure ceiling assigned to the campaign. |
| **Budget type** | Budget pacing rule: `Daily budget` or `Lifetime budget`. |
| **Status** | Operational status of the campaign (`Not sent`, `Sending`, or `Completed`). |
| **Sent** | Total count of marketing messages dispatched by the system. |
| **Delivered** | Number of messages successfully delivered to buyer Messenger inboxes. Charges apply only to delivered messages. |
| **Failed** | Number of undelivered messages (e.g., blocked contacts or invalid recipients). |
| **Created At** | Timestamp when the campaign was created. |
| **Actions** | Edit pencil icon to modify parameters, and trash icon to delete the campaign. |

### Campaign Creation Workflow

To launch a new marketing message campaign:

**1. Open the Campaign Creation Form**

In the top-right corner of the **Campaigns** dashboard, click the blue **+ Create New** button.

**2. Configure Identity, Budget, and Target Audience**

Complete the parameters in the upper configuration card:

![Facebook Marketing Messages Create Campaign](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_create_campaign.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=d14a3d2fda652c77a5abd96355796026)

* **Name**: Enter a clear, identifiable name for your campaign.
* **Facebook Page**: Select the originating Facebook Page from your authorized list.
* **Ad account**: Choose the billing Meta Ad Account. Use the refresh icon next to the dropdown if you recently funded or updated accounts in Meta Business Suite.
* **Budget type**: Select your budget pacing method:
  * `Daily budget`: Caps the maximum spend within a single calendar day.
  * `Lifetime budget`: Sets an absolute maximum spend cap across the full lifespan of the campaign.
* **Budget**: Enter your desired budget figure. The currency indicator (e.g., `USD` or `VND`) matches your Meta Ad Account settings automatically.
* **Target messaging**: Select your target recipient group:
  * **Opt-in**: Sends messages to contacts who have agreed to receive marketing messages on your Page.
  * **Custom Audience**: Sends messages to audiences uploaded from a file.

**3. Select and Configure Message Format**

In the lower configuration card, select your preferred message layout from the **Message type** dropdown:

* **Text**: Plain text copy paired with quick reply pills.
* **Button**: Text copy embedded with functional interactive buttons.
* **Media**: Eye-catching image assets with button and quick reply attachments.
* **Generic**: Horizontal carousel slider supporting up to 5 product cards.

**4. Finalize and Launch Campaign**

Review budget limits, targeting parameters, and message content, then click **Create** at the bottom right corner to submit the campaign.

### Detailed Message Formats

#### Text Format

Ideal for short announcements, time-sensitive alerts, or personalized conversational invitations:

* **Text**: Enter the marketing message copy.
* **Quick replies**: Click **+ Quick Reply** to attach rapid response pills below the message.

#### Button Format

Enhance text copy with interactive action buttons:

![Facebook Marketing Messages Message Type Button](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_message_type_button.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=530bdc7891d22adf4bd20096912c3a51)

* **Text**: Enter campaign description copy.
* **Button**: Attach interactive action buttons:
  * `Open Website`: Directs contacts to an external landing page or web shop URL.
  * `Start External Flow`: Launches an automated ChatbotX flow to handle consultations or orders.
  * `Start External Node`: Navigates contacts to a specific step within an existing flow.
  * Click **+ Add** to attach multiple action buttons.
* **Quick replies**: Attach quick reply response pills below the message.

#### Media Format

Capture attention using rich visual imagery:

![Facebook Marketing Messages Message Type Media](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_message_type_media.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=88dffe53f0480e2a3317f274acfe8440)

* **Media**: Select **Image** as the media format.
* **Image Asset**: Upload image files from your computer or paste direct image links.
* **Button**: Attach action buttons (such as `Open Website`) leading to products or booking forms. Click **+ Add** to add more buttons.
* **Quick replies**: Include interactive quick reply options beneath the media card.

#### Generic Format (Carousel Slider)

Present product catalogs, collections, or tiered promotional bundles:

![Facebook Marketing Messages Message Type Generic](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_message_type_generic.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=0599b7cc2750f13c394c761af0cd07dd)

* **Greeting (optional)**: Brief introductory headline displayed above the card slider.
* **Cards**: Supports up to 5 horizontally scrollable cards (with a `1/5` position counter and directional navigation arrows):
  * **Card Image**: Upload product thumbnail images for each card.
  * **Enter title**: Primary card headline (mandatory). Click the blue `+` icon to add cards to the carousel.
  * **Enter subtitle (optional)**: Secondary description, pricing, or promotional details. Click the red trash icon to delete the active card.
  * **Button**: Attach dedicated action buttons for each card.
* **Quick replies**: Attach common quick reply options below the entire carousel.

### Strategic Quick Reply Configuration

Quick replies are critical for driving conversions while minimizing messaging expenses:

* **Title**: Enter concise action text on the pill button.
* **Action Triggers**:
  * `Start External Flow`: Launches an automated flow immediately upon contact tap to deliver catalog items or capture lead details.
  * `Start External Node`: Jumps to a specific node within an existing flow graph.
* **Cost Advantage**: When a contact taps a Quick Reply, Meta's free 24-hour messaging window reopens instantly. All subsequent conversational steps and transactions proceed with zero per-message charges.

## Managing Custom Audiences

The **Audiences** tab enables you to create and manage **Custom Audiences** by uploading customer identifier lists (such as email addresses and phone numbers). ChatbotX securely hashes identifier records client-side using cryptographic standards and matches them against Facebook and Instagram accounts for targeted marketing message delivery.

### Custom Audiences Dashboard

The Audiences dashboard lists all configured audience segments along with their Meta matching status:

![Facebook Marketing Messages Audiences Dashboard](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_audiences_dashboard.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=63bac662256513af3f7b41df34e4fcea)

The audience table displays the following columns:

| Column | Description |
| :- | :- |
| **Audience ID** | Unique system identifier assigned to the custom audience segment by Meta. |
| **Facebook Page** | Facebook Page authorized to broadcast messages to this audience. |
| **Ad account** | Associated Meta Ad Account holding the custom audience asset. |
| **Name** | Custom label assigned to identify the audience segment. |
| **Approximate count** | Estimated number of matched Meta users (e.g., `0 - 0` while processing or if below minimum thresholds). |
| **Status** | Readiness state of the audience (e.g., *Audience is too small to be used in campaign creation* if below Meta's minimum viable threshold). |
| **Created At** | Date on which the audience segment was created. |
| **Actions** | Upload/sync icon to append new customer records, and trash icon to delete the audience. |

### 3-Step Custom Audience Creation Process

Follow the standardized 3-step wizard to upload and initialize a custom audience:

**1. Step 1: Prepare List (Prepare list)**

From the **Audiences** tab, click **+ Create New** at the top right to open the modal:

![Facebook Marketing Messages Audience Prepare List](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_audience_prepare_list.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=9f3260798c888d3a955fe3f187ad182f)

* **Download file template**: Click **Download file template** to retrieve the official CSV/spreadsheet template with standard column headers.
* **Main identifiers (at least one required)**: Your list must include at least one primary identifier for Meta account matching:
  * `Email`: Customer email addresses.
  * `Phone Number`: Customer phone numbers with international dialing codes.
* **More identifiers**: Supply optional secondary attributes to increase matching accuracy:
  * `Mobile advertiser ID`: Mobile advertising identifiers (IDFA / GAID).
  * `First name` & `Last name`: Customer given name and surname.
  * `City`, `State/Province`, `Country`, `ZIP/Postal Code`: Geographic location data.
  * `Date of birth`, `Year of birth`, `Gender`: Demographic attributes.
* **Client-Side Data Hashing**: Prior to transmission, all personal identifiers are automatically hashed into random strings using SHA-256 directly in your browser, maintaining strict privacy compliance.
* Click **Next** to proceed.

**2. Step 2: Upload Audience Data (Upload)**

Configure destination assets and select your prepared subscriber list:

![Facebook Marketing Messages Audience Upload List](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_audience_upload_list.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=14903b3d66082577ba3f40def864adf9)

* **Ad account**: Select the target Meta Ad Account to store and govern the audience asset.
* **Facebook Page**: Choose the Facebook Page associated with the subscriber cohort.
* **Name**: Enter a descriptive name for the custom audience (e.g., *VIP Buyers October* or *Audience*).
* **Description (optional)**: Provide internal notes regarding segmentation criteria or campaign intent.
* **Upload file**: Click or drag and drop your contact list file into the dropzone. Supported formats include `.csv`, `.txt`, and `.xlsx` with a maximum file size of 20MB.
* Click **Upload** to initiate data transfer.

**3. Step 3: Confirm Upload (Confirm)**

Upon transmission completion, the wizard confirms successful submission:

![Facebook Marketing Messages Audience Confirm](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_audience_confirm.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=8eb4f11f70341817f57baa7f15724f6d)

* **Upload successful**: Confirms the exact number of rows received (e.g., *Your Messenger subscriber list has been uploaded 9 rows*).
* **Matching Processing Window**: Meta requires anywhere from several minutes to a few hours to match uploaded identifiers against active profiles. Check the **Status** and **Approximate count** columns in the Audiences table to track readiness.
* Click **Done** to return to the Audiences dashboard.

## Performance Analytics in the Statistics Tab

The **Statistics** tab provides comprehensive reporting on delivery rates, engagement metrics, and advertising expenditures across all Facebook Marketing Message broadcasts.

![Facebook Marketing Messages Statistics](https://mintcdn.com/chatbotx/4bUW1h1m1Ujk24Q7/images/facebook_marketing_messages_statistics.png?fit=max\&auto=format\&n=4bUW1h1m1Ujk24Q7\&q=85\&s=6bef286387bcc842ce65bf72899002a4)

### Filtering and Search Controls

* **Search by ID or name**: Quick search filter to locate specific campaigns by their unique identifier or descriptive name.
* **Date Range Picker**: Filter metrics across custom date ranges (with start and end calendar pickers). All timestamps adhere to your configured local timezone (e.g., *Dates in Asia/Ho\_Chi\_Minh*).

### Metric Definitions and Evaluation

The reporting table aggregates individual campaign performance and displays summary footers (**Total / Average**) across all columns:

| Metric | Definition and Calculation | Practical Optimization |
| :- | :- | :- |
| **ID** | Unique system identifier for the campaign broadcast. | Cross-reference with Meta Ads Manager billing line items. |
| **Name** | Descriptive campaign title. | Maintain consistent naming conventions across marketing cohorts. |
| **Facebook Page** | Sender Facebook Page associated with the broadcast. | Isolate delivery performance across multiple brand Pages. |
| **Messages delivered** | Total marketing messages successfully handed off to recipients' Messenger inboxes. | Primary billing metric charged by Meta; undelivered messages are never billed. |
| **Read rate** | Percentage of delivered messages opened and viewed by recipients. | Measures the effectiveness of brand recognition and notification preview teasers. |
| **Link clicks** | Total number of clicks on inline URLs and action buttons. | Gauges customer interest in your offer or promotional call to action. |
| **Link click rate (CTR)** | Ratio of link clicks relative to total delivered impressions. | Indicates messaging copy resonance and button placement clarity. |
| **Cost per click (CPC)** | Average expenditure per link tap (Total spend divided by link clicks). | Evaluates economic viability compared to conventional Click-to-Messenger ads. |
| **Cost per delivery (CPD)** | Effective cost per successfully delivered marketing message. | Monitors delivery expense fluctuations across seasonal advertising windows. |
| **Amount spent** | Total real expenditure billed against your Meta Ad Account for this campaign. | Verify against predefined `Daily budget` or `Lifetime budget` allocations. |

## Strategic Alignment Between Audiences, Campaigns, and Statistics

Integrating the three pillars creates an end-to-end performance marketing loop:

1. **Targeting Precision via Custom Audiences:**
   Selecting **Custom Audience** under **Target messaging** during campaign setup ensures promotional broadcasts reach verified subscriber lists rather than untargeted audiences.

2. **Cost Efficiency and 24-Hour Free Re-engagement:**
   When recipients interact with Quick Reply buttons or CTA links within your marketing message, Meta's standard 24-hour service window reopens immediately. Follow-up sales conversations, AI agent interactions, and order processing proceed with zero per-message charges.

3. **Data-Driven Optimization via Statistics:**
   Evaluate `Read rate`, `Link click rate`, and `Cost per click` in the Statistics tab to identify top-performing creatives and copy variations, allowing you to scale successful broadcasts systematically.

## Best Practices and Cost Management

> [card] Start with Modest Daily Budgets
>
> Always test new broadcasts with conservative Daily Budgets to benchmark delivery rates, response ratios, and effective cost per conversion before scaling.

> [card] Optimize Action Triggers
>
> Ensure marketing messages include compelling Quick Replies that trigger automated flows, reopening the free 24-hour messaging window upon customer response.

> [card] Respect Messaging Frequency Caps
>
> Meta enforces a strict frequency limit: each Page may send at most 1 marketing message per recipient per 24 hours. Schedule broadcasts during peak engagement hours.

> [card] Protect Page Reputation
>
> Avoid spamming contacts with repetitive messages to prevent spam reports or blocks, which can lead to Meta imposing delivery limits on your Page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.