Hướng dẫn kết nối Facebook Messenger cho Chatwoot một cách đơn giản
🚀 Sử dụng kênh Facebook Messenger , bạn phải tạo một ứng dụng Facebook trong Facebook Developer Portal.
📋 Yêu cầu tiên quyết :
Tài khoản Facebook hợp lệ | Trang (Page) Facebook hợp lệ
1. Đăng ký ứng dụng Facebook:
1. Truy cập developers.facebook.com và bấm nút "Create App"
2. Chọn tùy chọn "Other"
3. Tại loại ứng dụng, chọn "Business"
4. Điền thông tin cơ bản như tên ứng dụng và email
💡 Lưu ý quan trọng: Sau khi tạo ứng dụng Facebook, ghi lại App ID và App Secret từ phần cài đặt ứng dụng .
2. Thiết lập environment variables của Chatwoot:
FB_VERIFY_TOKEN=chuỗi duy nhất bảo mật
FB_APP_SECRET=app_secret đã lấy
FB_APP_ID= ID ứng dụng
⚠️ Restart server Chatwoot sau khi cập nhật biến môi trường.
3. Cấu hình Facebook Login:
1. Thêm product Facebook Login vào bảng điều khiển ứng dụng
2. Bật Web OAuth Login và điền domain của bạn vào Allowed Domains
4. Thiết lập app Facebook:
1. Thêm installation URL vào App Domain
2. Thêm "Messenger" vào phần Products
3. Cấu hình Callback URL: your_chatwoot_url/bot
4. Thiết lập inbox Messenger trong Chatwoot và chọn trang Facebook.
Hướng dẫn chi tiết tích hợp Messenger
5. Kiểm thử channel Facebook:
⚠️ Development mode, Facebook không gửi tin nhắn mới nhất vào Chatwoot.
Các bước kiểm thử:
1. Vào Messenger settings tại Facebook developers
2. Add trang Facebook target page
3. Subscribe các trường: messages, messaging_postbacks, message_deliveries, message_reads, message_echoes
6. Đưa vào production:
Yêu cầu permissions:
pages_messaging | pages_show_list | pages_manage_metadata | business_management | pages_read_engagement
⚠️ Phiên bản subscription Facebook phải là 17.0
7. Test trên máy local:
1. Cài công cụ ngrok ( required cho HTTPS)
2. Chạy: ngrok http 3000
3. Thiết lập Callback URL: ngrok_url/bot
8. Phiên bản Facebook API: v13.0 trở lên
9. Kiểm tra local setup:
Tạo Facebook inbox tại Chatwoot
Send tin nhắn qua Facebook tới trang
Kiểm tra requests trên ngrok /bot endpoint