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

# Cách kết nối Facebook Messenger vào ChatbotX

> Hướng dẫn kết nối Facebook Page với ChatbotX để tự động hóa tin nhắn Messenger và bình luận trên bài đăng.

Facebook Messenger là một trong những kênh tương tác khách hàng quan trọng nhất hiện nay. Bằng cách kết nối Fanpage của bạn với **ChatbotX**, bạn có thể dùng AI Agents để tự động hóa chăm sóc khách hàng, phản hồi 24/7 và quản lý toàn bộ hội thoại trong một trung tâm duy nhất.

## Điều kiện cần trước khi kết nối

Trước khi bắt đầu, hãy chắc chắn bạn đã đáp ứng các yêu cầu sau:

1. **Quyền quản trị:** Bạn cần có quyền **"Full Control"** hoặc **Admin** trên Fanpage muốn kết nối.
2. **Tài khoản Facebook cá nhân:** Bạn phải dùng đúng tài khoản Facebook cá nhân đang quản lý Fanpage đó và tài khoản này cần đăng nhập sẵn trên trình duyệt.
3. **Quyền truy cập Meta Business Suite:** Nếu trang nằm trong một Business Manager (BM), tài khoản của bạn cũng phải có đủ quyền trong BM đó.

## Bước 1: Mở phần cấu hình kênh

1. Vào **Settings** → **Channels**.
2. Tìm biểu tượng Messenger và nhấn nút **"Add Messenger"**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-239.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=687001882034c4beb304b17ec907aad2" alt="chatbotx_navigate_to_facebook_channel_setup" width="3019" height="1359" data-path="images/image-239.png" />
</Frame>

## Bước 2: Cấp quyền truy cập

Hệ thống sẽ chuyển bạn sang giao diện xác thực của Facebook (Meta).

1. Nhấn nút **"Continue as \[Tên của bạn]"** để cấp quyền.
   > **Quan trọng:** Nếu trước đó bạn đã kết nối các trang khác, hãy chọn **Edit Settings** để bảo đảm mọi trang mới hoặc các trang chưa được chọn trước đây đều hiển thị.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-240.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=bdabbfe154586885f5f85ea4db944e47" alt="meta_facebook_authentication_popup_step" width="1482" height="1814" data-path="images/image-240.png" />
</Frame>

## Bước 3: Chọn Facebook Fanpages

Danh sách tất cả Fanpage bạn đang quản lý sẽ xuất hiện.

1. Tích chọn các Fanpage bạn muốn kết nối với **ChatbotX** hoặc chọn **Tất cả**
2. Nhấn **Continue** để sang bước cài đặt quyền.

<Frame>
  <img src="https://mintcdn.com/chatbotx/yiWT9ZnID5SHGklx/images/image-236.png?fit=max&auto=format&n=yiWT9ZnID5SHGklx&q=85&s=cc03db1a0815a382ab39a4cf43be669b" alt="select_facebook_fanpages_for_chatbotx_integration" width="1110" height="1389" data-path="images/image-236.png" />
</Frame>

## Bước 4: Xem lại quyền

Đây là bước cuối cùng

1. Xem lại các quyền mà ứng dụng được phép truy cập.
2. Sau khi kiểm tra xong, nhấn nút **Save** ở góc dưới bên phải.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-241.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=a27da326e59cd7ee14ff4ba2c9a7f663" alt="granting_meta_permissions_for_messenger_bot" width="1449" height="1812" data-path="images/image-241.png" />
</Frame>

## Bước 5: Chọn Facebook Page

Xác nhận chính xác Fanpage bạn muốn liên kết với nền tảng.

* Chọn nút radio bên cạnh Facebook Page bạn muốn dùng, ví dụ **ChatbotX Demo**.
* Nhấn nút **Continue** để hoàn tất kết nối.

<Frame>
  <img src="https://mintcdn.com/chatbotx/yiWT9ZnID5SHGklx/images/image-238.png?fit=max&auto=format&n=yiWT9ZnID5SHGklx&q=85&s=9d201e5138afe1f80b46cf46402db969" alt="selecting_facebook_page_to_connect" width="1089" height="439" data-path="images/image-238.png" />
</Frame>

## Bước 6: Đồng bộ liên hệ và lịch sử chat

Sau khi nhấp tiếp tục từ việc chọn Fanpage, một hộp thoại sẽ hiển thị hỏi bạn có muốn đồng bộ liên hệ và lịch sử chat cũ hay không.

* **Enable sync:** Cho phép ChatbotX nhập toàn bộ liên hệ cũ từ Messenger và tối đa 3 tháng lịch sử cuộc trò chuyện từ Fanpage này.
  * *Lưu ý:* Quá trình đồng bộ này đối với các Fanpage lớn có thể mất vài giờ để hoàn tất.
* **Don't sync:** Bỏ qua việc đồng bộ dữ liệu cũ và bắt đầu sử dụng trực tiếp với các khách hàng mới.

<Frame>
  <img src="https://mintcdn.com/chatbotx/vAbVpFL_ZF5D0bbF/images/chatbotx_channels_messenger_sync_history.png?fit=max&auto=format&n=vAbVpFL_ZF5D0bbF&q=85&s=0d8eb2ae2a893ed90381f1ec754a8359" alt="Chatbotx Channels Messenger Sync History" width="2096" height="1295" data-path="images/chatbotx_channels_messenger_sync_history.png" />
</Frame>

## Bước 7: Hoàn tất và xác minh

Sau khi được chuyển hướng về lại hệ thống, Facebook Page của bạn sẽ xuất hiện trên dashboard **ChatbotX**.

* **Xác nhận kết nối:** Đảm bảo đúng Fanpage đã hiển thị cùng biểu tượng Messenger.
* **Kiểm tra tích hợp:** Nhấn **Test Now** để gửi tin nhắn thử và xác nhận AI Agent đang hoạt động.

<Frame>
  <img src="https://mintcdn.com/chatbotx/HymWStvnUgfau97Q/images/connect_messenger_dashboard_check.png?fit=max&auto=format&n=HymWStvnUgfau97Q&q=85&s=cc838b6a657701fe9a6902c11245492a" alt="Connect Messenger Dashboard Check" width="3080" height="1527" data-path="images/connect_messenger_dashboard_check.png" />
</Frame>

## Bước 8: Kiểm tra tự động hóa

Bây giờ trang của bạn đã được kết nối. Bạn có thể kiểm tra bằng một trong hai cách sau:

* **Cách 1: Tạo một Flow**
  * Vào mục **Flows** trên thanh bên.
  * Tạo một tin nhắn chào mừng đơn giản hoặc một menu tương tác.
  * Kích hoạt từ Fanpage Messenger để kiểm tra phản hồi.
* **Cách 2: Thiết lập AI Agent**
  * Vào tab **AI Agent** để cấu hình tính cách cho agent của bạn.
  * Sau khi lưu, dùng nút **Test Now** trên dashboard để trò chuyện trực tiếp với AI.

## FAQ

<AccordionGroup>
  <Accordion title="Tại sao tên Fanpage của tôi không xuất hiện trong danh sách kết nối?" iconType="solid">
    Có hai nguyên nhân phổ biến:

    **Quyền truy cập**\
    Bạn có thể chỉ đang có vai trò *Editor* hoặc *Moderator*. Meta yêu cầu quyền **Admin** để thiết lập API.

    **Thiếu quyền ứng dụng**\
    Có thể trước đó bạn đã kết nối ChatbotX nhưng chưa chọn trang cụ thể này trong lần cấp quyền đó.

    **Cách xử lý**\
    Vào hồ sơ Facebook cá nhân → **Settings & Privacy** → **Settings** → **Business Integrations**.\
    Tìm **ChatbotX**, nhấn **Remove**, sau đó quay lại Bước 1 để thực hiện lại từ đầu.
  </Accordion>

  <Accordion title="Tôi đã kết nối thành công nhưng AI không phản hồi khách hàng?">
    Hãy kiểm tra các điểm sau:

    **Cấu hình AI Agent**\
    Đảm bảo bạn đã gán một **AI Agent** cho kênh Messenger này trong phần **AI Agent Settings**.

    **Facebook Auto-Replies**\
    Kiểm tra xem Fanpage có đang bật **Instant Replies** mặc định của Facebook hay không, vì tính năng này có thể xung đột với ChatbotX.
  </Accordion>

  <Accordion title="ChatbotX có hỗ trợ quản lý nhiều Fanpage cùng lúc không?">
    Có. ChatbotX được thiết kế như một nền tảng **Omnichannel**.

    Bạn có thể kết nối nhiều Fanpage, tùy theo gói dịch vụ của mình, và quản lý tất cả tin nhắn đến trong một **Unified Inbox**.
  </Accordion>

  <Accordion title="Quy tắc 24 giờ của Facebook ảnh hưởng đến bot như thế nào?">
    Theo chính sách của Meta, bot chỉ được phép phản hồi khách hàng **trong vòng 24 giờ kể từ tin nhắn gần nhất của khách**.

    Sau 24 giờ, bạn phải dùng:

    * **Message Tags**, hoặc
    * **Marketing Messages on Messenger**

    để tiếp tục cuộc trò chuyện.
  </Accordion>

  <Accordion title="Làm sao cập nhật quyền khi tôi thêm Fanpage mới?">
    Bạn không cần gỡ kết nối hiện tại.

    Chỉ cần lặp lại quy trình **Add Facebook Page**.\
    Khi cửa sổ Meta hiện ra, hãy chọn **Edit Settings** và tích thêm Fanpage mới.

    Hệ thống sẽ tự cập nhật danh sách mà không ảnh hưởng đến các trang đã kết nối trước đó.
  </Accordion>
</AccordionGroup>