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

# Gửi tin nhắn hàng loạt cho nhiều Fanpage

> Hướng dẫn toàn diện quy trình kết nối nhiều Fanpage, quét liên hệ cũ tự động và thiết lập chiến dịch gửi tin nhắn hàng loạt đa trang trên Facebook Messenger.

**Gửi tin nhắn hàng loạt đa Fanpage** (Send Bulk Broadcast) là giải pháp giúp bạn phát động chiến dịch tiếp thị và chăm sóc khách hàng đồng thời trên nhiều trang Facebook Messenger cùng lúc. Thay vì phải cấu hình thủ công từng chiến dịch riêng lẻ cho từng Fanpage, ChatbotX cho phép bạn gom các trang lại trong một chiến dịch duy nhất, tùy biến nội dung mẫu theo từng trang và lên lịch gửi tự động đến toàn bộ tệp liên hệ.

Tính năng này đặc biệt phù hợp với các doanh nghiệp, chuỗi thương hiệu hoặc đội ngũ vận hành nhiều Fanpage chi nhánh muốn tiết kiệm thời gian, tối ưu quy trình và đảm bảo thông điệp tiếp thị được triển khai đồng bộ.

Quy trình thiết lập trọn vẹn bao gồm 3 giai đoạn:

1. **Chuẩn bị kênh:** Kết nối các Fanpage vào ChatbotX bằng tính năng tích hợp hàng loạt.
2. **Chuẩn bị dữ liệu:** Quét và đồng bộ lịch sử liên hệ cũ của các trang vào hệ thống.
3. **Phát động chiến dịch:** Tạo Broadcast, chọn đa Fanpage, ánh xạ mẫu tin nhắn và lên lịch gửi.

## Giai đoạn 1: Kết nối Fanpage hàng loạt vào ChatbotX

Trước khi gửi tin nhắn, bạn cần bảo đảm các Fanpage đã được kết nối đầy đủ vào hệ thống ChatbotX.

<Steps>
  <Step title="Mở cấu hình kênh Messenger">
    Từ menu điều hướng bên trái, chọn **Settings** (1) > chuyển sang tab **Channels** (2) > tìm mục **Messenger** và nhấn nút **+ Add Messenger** (3).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/hy32n_LnTaDHhlNA/images/settings_channels_add_messenger.png?fit=max&auto=format&n=hy32n_LnTaDHhlNA&q=85&s=4beb164f3adc83247f4529a8acaad9fe" alt="Settings Channels Add Messenger" width="2924" height="1560" data-path="images/settings_channels_add_messenger.png" />
    </Frame>
  </Step>

  <Step title="Xác thực và cấp quyền truy cập Meta">
    Hệ thống chuyển hướng sang giao diện xác thực Facebook (Meta). Đăng nhập tài khoản Facebook quản trị của bạn, kiểm tra danh sách Fanpage và nhấn **Continue** để cấp toàn bộ quyền truy cập tin nhắn, quản lý cuộc hội thoại cho ứng dụng ChatbotX.
  </Step>

  <Step title="Tích chọn Fanpage hàng loạt">
    Sau khi xác thực, hộp thoại **Connect Messenger** hiển thị danh sách tất cả các trang bạn đang quản lý. Bạn tích chọn các Fanpage muốn kết nối hoặc tích vào ô **Select all** để chọn toàn bộ danh sách cùng lúc.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/STYGDYcJAqZ2HB39/images/connect_messenger_bulk_pages_selection.png?fit=max&auto=format&n=STYGDYcJAqZ2HB39&q=85&s=6aec86961a3154e288dc41de64f1dcd5" alt="Connect Messenger Bulk Pages Selection" width="2911" height="1815" data-path="images/connect_messenger_bulk_pages_selection.png" />
    </Frame>

    Bên cạnh mỗi trang, bạn có thể bật công tắc **Sync history** để hệ thống tự động đồng bộ liên hệ và tối đa 3 tháng lịch sử chat. Sau đó, nhấn **Continue** để hoàn tất kết nối hàng loạt.
  </Step>
</Steps>

## Giai đoạn 2: Quét và đồng bộ liên hệ cũ từ các trang

Nếu Fanpage của bạn có sẵn tệp khách hàng từng nhắn tin trong quá khứ trước khi kết nối ChatbotX, hãy sử dụng tính năng **Automatic Customer Scan** để đưa toàn bộ khách hàng này vào danh bạ liên hệ.

<Steps>
  <Step title="Mở tính năng Automatic Customer Scan">
    Vào mục **Contacts** trên thanh điều hướng, nhấn vào nút **Actions** ở góc trên bên phải, di chuột vào **Import** và chọn **Automatic Customer Scan**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/STYGDYcJAqZ2HB39/images/contacts_automatic_customer_scan_menu.png?fit=max&auto=format&n=STYGDYcJAqZ2HB39&q=85&s=7ee194b2260918e6a82337bea7e80345" alt="Contacts Automatic Customer Scan Menu" width="2922" height="1563" data-path="images/contacts_automatic_customer_scan_menu.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình thông số quét theo từng Inbox">
    Chọn Fanpage cần quét tại trường **Inbox** và chọn mốc thời gian bắt đầu quét tại **Scan Inbox from Time** (ví dụ từ ngày 01/01/2026 đến hiện tại).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/STYGDYcJAqZ2HB39/images/contacts_automatic_customer_scan_modal.png?fit=max&auto=format&n=STYGDYcJAqZ2HB39&q=85&s=6ac27f0648c13a118ef57c15dab6a2a8" alt="Contacts Automatic Customer Scan Modal" width="2363" height="1025" data-path="images/contacts_automatic_customer_scan_modal.png" />
    </Frame>
  </Step>

  <Step title="Bắt đầu quét tự động">
    Nhấn nút **Automatic Scan** để khởi chạy tiến trình quét. Hệ thống sẽ tự động quét ngầm toàn bộ cuộc hội thoại từ mốc thời gian đã chọn và nhập các liên hệ vào danh bạ của ChatbotX. Bạn có thể lặp lại thao tác này cho các Fanpage khác nếu muốn gom tệp liên hệ để gửi tin hàng loạt.
  </Step>
</Steps>

## Giai đoạn 3: Thiết lập chiến dịch gửi tin nhắn đa Fanpage

Sau khi các Fanpage đã sẵn sàng và danh bạ liên hệ đã được đồng bộ, bạn tiến hành tạo chiến dịch Broadcast theo các bước dưới đây:

<Steps>
  <Step title="Bắt đầu tạo chiến dịch">
    Từ thanh menu bên trái, chọn **Broadcasts**, sau đó nhấn nút **+ Create Broadcast** ở góc trên bên phải màn hình.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/RccmqYl_4Bk1sIYo/images/create_broadcast.png?fit=max&auto=format&n=RccmqYl_4Bk1sIYo&q=85&s=7b54e2cbedf3541bc2f3ab3cecec45fa" alt="Create Broadcast" width="3228" height="1233" data-path="images/create_broadcast.png" />
    </Frame>
  </Step>

  <Step title="Chọn kênh Messenger">
    Tại màn hình **Choose Channel**, nhấp chọn kênh **Messenger** và nhấn **Continue**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/zlZVdeDJQGuptVbv/images/create-messenger-broadcast.png?fit=max&auto=format&n=zlZVdeDJQGuptVbv&q=85&s=9905ad4a00c94906b7be3ef1f3b1f00e" alt="Create Messenger Broadcast" width="2541" height="1645" data-path="images/create-messenger-broadcast.png" />
    </Frame>
  </Step>

  <Step title="Chọn kiểu gửi Template Message">
    Tại màn hình **Choose Subaction**, bạn chọn **Template Message** rồi nhấn **Continue**. Tùy chọn này cho phép gửi mẫu tin nhắn Tiện ích (Utility Messages) đã được Meta phê duyệt đến tệp khách hàng ngoài khung giờ 24 giờ.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/hy32n_LnTaDHhlNA/images/broadcast_choose_subaction_template_message.png?fit=max&auto=format&n=hy32n_LnTaDHhlNA&q=85&s=8dd68b9ecfc2fcf2b5b3e2f3e85caa19" alt="Broadcast Choose Subaction Template Message" width="2356" height="1031" data-path="images/broadcast_choose_subaction_template_message.png" />
    </Frame>

    > **Lưu ý:** Nếu bạn chọn **Messenger Active Contacts**, tin nhắn dạng kịch bản chỉ có thể gửi đến những người đã nhắn tin với trang trong vòng 24 giờ gần nhất.
  </Step>

  <Step title="Chọn hình thức Template và chọn nhiều Fanpage">
    Tại màn hình cấu hình, chọn tab **Template** ("Send a template to your contacts").

    Tại mục **Messenger Pages**, mở danh sách thả xuống và tích chọn các Fanpage bạn muốn tham gia vào chiến dịch này. Bạn có thể tìm kiếm tên trang hoặc tích vào ô **(Select All)** để chọn nhanh toàn bộ các trang.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/hy32n_LnTaDHhlNA/images/broadcast_template_message_select_multiple_pages.png?fit=max&auto=format&n=hy32n_LnTaDHhlNA&q=85&s=ecba6f4f9abad9fc4faf2b61537cd5f1" alt="Broadcast Template Message Select Multiple Pages" width="1492" height="1155" data-path="images/broadcast_template_message_select_multiple_pages.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình nội dung mẫu cho từng Fanpage">
    Khi bạn chọn nhiều Fanpage, hệ thống sẽ tạo các khối cấu hình độc lập cho từng trang:

    <Frame>
      <img src="https://mintcdn.com/chatbotx/hy32n_LnTaDHhlNA/images/broadcast_template_message_per_page_mapping.png?fit=max&auto=format&n=hy32n_LnTaDHhlNA&q=85&s=526ffe5dbf7421214f191db47874e782" alt="Broadcast Template Message Per Page Mapping" width="1497" height="1647" data-path="images/broadcast_template_message_per_page_mapping.png" />
    </Frame>

    Đối với từng Fanpage, bạn thực hiện:

    * **Messenger Template:** Chọn mẫu tin nhắn tiện ích tương ứng của trang đó (ví dụ: mẫu thông báo xác nhận đơn hàng `order_confirmation`).
    * **Ánh xạ thuộc tính biến động:** Điền các thuộc tính của khách hàng tương ứng với các biến trong mẫu:
      * `{{1}}`: Chọn thuộc tính họ tên khách (ví dụ: `{{first_name}}`).
      * `{{2}}`: Chọn thuộc tính dữ liệu cần hiển thị (ví dụ: `{{result}}` hoặc mã đơn hàng).
    * **Preview:** Xem trước văn bản tin nhắn thực tế mà khách hàng sẽ nhận được để bảo đảm tính chuẩn xác trước khi gửi.
  </Step>

  <Step title="Lên lịch gửi và thiết lập bộ lọc liên hệ">
    Cuộn xuống khu vực thiết lập thời gian và điều kiện nhận tin:

    <Frame>
      <img src="https://mintcdn.com/chatbotx/hy32n_LnTaDHhlNA/images/broadcast_schedule_filter_and_confirm.png?fit=max&auto=format&n=hy32n_LnTaDHhlNA&q=85&s=a222e4034a1f962549ae3367fe8426a2" alt="Broadcast Schedule Filter And Confirm" width="1491" height="1043" data-path="images/broadcast_schedule_filter_and_confirm.png" />
    </Frame>

    * **Schedule:**
      * Chọn **Now** nếu bạn muốn phát động gửi tin nhắn ngay lập tức.
      * Chọn **Schedule for later** để lên lịch gửi trong tương lai, sau đó chọn ngày và giờ cụ thể tại ô **Pick a date**.
    * **Contact filter:** Thu hẹp nhóm khách nhận tin bằng các điều kiện lọc:
      * **Match all the conditions below:** Khách hàng phải thỏa mãn tất cả các điều kiện đặt ra.
      * **Match one of the conditions below:** Khách hàng chỉ cần thỏa mãn một trong các điều kiện.
      * Nhấn **+ Add Condition** để thêm tiêu chí lọc theo Tag, Thuộc tính tùy chỉnh (Custom Field)...
    * **Receivers:** Kiểm tra tổng số lượng liên hệ thực tế thỏa mãn điều kiện lọc và sẽ nhận được tin nhắn từ các trang đã chọn.
  </Step>

  <Step title="Xác nhận và phát động chiến dịch">
    * Nhấn **Save as draft** nếu bạn muốn lưu lại toàn bộ cấu hình để tiếp tục chỉnh sửa sau.
    * Nhấn nút **Confirm** màu xanh để chính thức kích hoạt hoặc lên lịch cho chiến dịch gửi tin đa Fanpage.
  </Step>
</Steps>

## Theo dõi và quản lý chiến dịch sau khi gửi

Sau khi nhấn **Confirm**, chiến dịch của bạn sẽ xuất hiện trên danh sách **Broadcasts**. Bạn có thể theo dõi tiến độ gửi tin thời gian thực qua các chỉ số:

| Trạng thái | Ý nghĩa |
| - | - |
| **Draft** | Chiến dịch đang được lưu ở dạng bản nháp, chưa phát đi tin nhắn nào. |
| **Scheduled** | Chiến dịch đã được lên lịch thành công và đang chờ đến thời điểm thiết lập để tự động gửi. |
| **Sending** | Hệ thống đang tiến hành phân phối tin nhắn đến khách hàng qua các Fanpage đã chọn. |
| **Completed** | Chiến dịch đã hoàn tất việc gửi tin. |

<Note>
  Khi gửi tin nhắn hàng loạt trên nhiều Fanpage, hệ thống sẽ tự động điều phối hàng đợi gửi tin theo hạn mức của từng Fanpage để bảo đảm an toàn và tuân thủ các quy định giới hạn tốc độ (Rate Limit) của Meta.
</Note>


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