Kết nối Facebook Messenger

Hướng dẫn kết nối qua nút Kết nối Facebook (OAuth Meta).

Điều kiện trước

• Bạn là Admin của Fanpage.
• Fanpage Published.
• Không có chatbot khác (ManyChat/Chatfuel/Pancake) đang dùng Page đó.

Các bước

1. Mở trang Kênh

Cài đặt → Kênh (/app/channels) → tab Nhắn tin tự động.

2. Bấm Kết nối Facebook

Thẻ Facebook Messenger → bấm nút xanh Kết nối Facebook.

Modal “Hướng dẫn kết nối Facebook” hiện 4 bước:

1. Nhấn “Kết nối Facebook” bên dưới.
2. Đăng nhập Facebook → cấp quyền cho ứng dụng.
3. Chọn Fanpage muốn kết nối nhận tin.
4. Hệ thống sẽ lưu token và đồng bộ tin nhắn.

3. Popup OAuth

• Popup Facebook mở → đăng nhập FB sở hữu Page.
• Cấp quyền pages_messaging + pages_manage_metadata.

4. Chọn Page + Agent

Quay về TrolyPage → overlay “Chọn Fanpage để kết nối”:

• List các Page bạn quản lý.
• Mỗi Page có chữ kết nối.
• Dropdown AI Agent (mặc định Mặc định).
• Bấm Page muốn kết nối → Hủy để thoát.

5. Kiểm tra

Thẻ FB Messenger xuất hiện với:

• Chip Hoạt động.
• Subtitle Facebook Messenger (Graph API).

Gửi 1 tin thử từ FB khác vào Page → tin hiện trong Hội thoại trong ~10 giây → thành công.

Nút Test

Trong thẻ kênh có nút Test — nhập PSID khách (đã nhắn với Page trước) → gửi tin test.

Troubleshooting

“Chưa đăng ký webhook”

Warning hiện trên thẻ kênh → bấm Đăng ký webhook → đợi vài giây → chip xanh.

Tin nhắn không vào TrolyPage

Theo thứ tự khả năng:

1. Chatbot khác chiếm webhook → Page Settings → Advanced Messaging → remove app khác.
2. Page “Bật thủ công” → Page Settings → Messaging → bật nhận tin.
3. Webhook lệch → bấm Đăng ký webhook lại.

Channel 🔴 “Tạm dừng” tự nhiên

Token hết hạn / FB thu hồi quyền (đổi mật khẩu) → bấm Kết nối Facebook lại (không có nút Sửa).

Khách không nhận reply

• Kênh 🟢 không?
• Toggle AI có bật cho khách đó?
• Hết AI Credit?
• Hết 24h window?

Xem thêm Troubleshooting Facebook.

Bước tiếp theo

• Hội thoại tổng quan — xem tin.
• Thông tin khách — toggle AI.
• Troubleshooting Facebook — lỗi sâu.