Kết nối Facebook Messenger
Xem dạng Markdown
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](/channels/overview/)
- [Kết nối WhatsApp Business](/channels/whatsapp/)
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.
Điều kiện trước khi kết nối
Phần tiêu đề “Đ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
Phần tiêu đề “Các bước kết nối Fanpage”- 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.
- 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)
- Sau khi cấp quyền, OmnyBot tự động tải danh sách các Fanpage khả dụng.
- Chọn Fanpage cần kết nối và nhấn Xác nhận kết nối.
Thao tác quản lý Fanpage
Phần tiêu đề “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.