# Kết nối Facebook Messenger

Kênh **Facebook** (`/{slug}/channels/facebook`) cho phép kết nối trực tiếp các **Fanpage Facebook** vào Workspace để nhận, trả lời tin nhắn Messenger và bật Bot AI tự động hỗ trợ khách hàng.

:::note[Quyền truy cập]
- **Xem danh sách Fanpage**: Cần **`nick:read:all`** (hiển thị mục điều hướng khi có `nick:read:all`, `nick:connect` hoặc `nick:operate`).
- **Kết nối mới / Kết nối lại Fanpage**: Cần **`nick:connect`**.
- **Ngắt kết nối Fanpage**: Cần **`nick:delete`**.
- **Gán Bot AI & Bật/tắt AI**: Cần **`workspace:manage`**.
:::

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

- Tài khoản Facebook của bạn phải có quyền quản trị trên **Fanpage** cần kết nối.
- Trình duyệt cho phép mở cửa sổ bật lên (**popup**) để hoàn tất bước đăng nhập Meta OAuth.

## Các bước kết nối Fanpage

1. Truy cập **Kênh kết nối → Facebook** (hoặc **Tất cả kênh**), nhấn **Thêm kênh** và chọn **Facebook**.
2. Trong hộp thoại kết nối, nhấn **Kết nối ngay**. Cửa sổ đăng nhập **Meta OAuth (v21.0)** sẽ mở ra và yêu cầu cấp các quyền:
   - `pages_show_list` (liệt kê danh sách Fanpage)
   - `pages_read_engagement` (đọc thông tin tương tác)
   - `pages_manage_metadata` (đăng ký webhook cho Fanpage)
   - `pages_messaging` (nhận và gửi tin nhắn Messenger)
3. Sau khi cấp quyền, OmnyBot tự động tải danh sách các Fanpage khả dụng.
4. Chọn Fanpage cần kết nối và nhấn **Xác nhận kết nối**.

:::tip[Nhập mã xác thực thủ công]
Nếu trình duyệt chặn phản hồi từ cửa sổ popup (ví dụ khi thử nghiệm ở môi trường nội bộ), bạn có thể sao chép toàn bộ URL callback (chứa tham số `code=...`) hoặc mã `code` và dán vào ô nhập thủ công hiển thị trong hộp thoại để tiếp tục bước chọn Fanpage.
:::

## Thao tác quản lý Fanpage

Tại danh sách kênh, nhấn menu **`⋮`** của Fanpage để thực hiện:

- **Xem trên Facebook**: Mở nhanh trang Fanpage trên Facebook ở tab mới.
- **Đồng bộ tin nhắn**: Chủ động kéo và đồng bộ lại hội thoại/tin nhắn mới nhất từ Fanpage về hộp thư.
- **Kết nối lại trang** (`nick:connect`): Mở lại luồng đăng nhập Meta OAuth để làm mới mã truy cập (access token) khi phiên bị hết hạn hoặc thay đổi quyền.
- **Ngắt kết nối trang** (`nick:delete`): Gỡ kết nối Fanpage khỏi Workspace.

:::caution[Ngắt kết nối Fanpage]
Sau khi ngắt kết nối, OmnyBot sẽ ngừng nhận sự kiện tin nhắn mới từ Fanpage đó cho tới khi bạn thực hiện kết nối lại.
:::

## Tài liệu liên quan

- [Tổng quan kênh kết nối](/vi/channels/overview/)
- [Kết nối WhatsApp Business](/vi/channels/whatsapp/)