Điều kiện chuẩn bị
Trước khi bắt đầu, hãy đảm bảo bạn có:- Một tài khoản Facebook cá nhân hoạt động bình thường.
- Fanpage Facebook mà bạn có quyền quản trị (Admin).
- Quyền quản trị cao nhất (Super Admin) trên Portal của bạn để nhập cấu hình.
Nếu bạn đang phát triển thử nghiệm ở môi trường cục bộ (local), bạn sẽ cần công cụ tạo đường hầm như ngrok để public server của mình ra internet nhằm nhận webhook từ Facebook.
Bước 1: Tạo ứng dụng Facebook (Facebook App)
1
Khởi tạo ứng dụng mới
Truy cập vào trang quản trị Facebook Developer Portal và nhấn Create App.
2
Nhập thông tin ứng dụng
Nhập tên ứng dụng hiển thị (App name) và email liên hệ (contact email), sau đó nhấn Next.
3
Chọn trường hợp sử dụng (Use case)
Khi hệ thống yêu cầu chọn trường hợp sử dụng, tích chọn Other.
4
Chọn loại ứng dụng (App type)
Chọn loại ứng dụng là Business.
5
Hoàn tất khởi tạo
Kiểm tra lại thông tin và nhấn Create App để hoàn tất quá trình tạo ứng dụng.
6
Lấy thông tin App ID và App Secret
Sau khi tạo ứng dụng thành công, đi đến mục Settings → Basic để lấy App ID và App Secret. Bạn sẽ cần hai giá trị này ở bước tiếp theo.
Bước 2: Cấu hình Credentials trên Portal quản trị
Bạn cần nhập thông tin ứng dụng Facebook vào Portal quản trị để kích hoạt tính năng kết nối Messenger cho khách hàng.1
Mở trang cấu hình kết nối
Đăng nhập vào Portal quản trị của bạn, truy cập mục:Sau đó chọn Messenger.
2
Nhập thông tin ứng dụng
3
Lưu cấu hình
Nhấn Save để lưu lại. Kênh Messenger lúc này sẽ sẵn sàng để khách hàng của bạn kết nối.Sau khi lưu, hệ thống sẽ hiển thị một đường dẫn Webhook URL. Hãy sao chép đường dẫn này để sử dụng trong Bước 4.
Bước 3: Cấu hình Facebook Login
1
Thêm sản phẩm Facebook Login
Tại trang quản trị ứng dụng của Meta, thêm sản phẩm Facebook Login.
2
Cấu hình cài đặt Facebook Login
Tại mục cấu hình Facebook Login settings:
- Kích hoạt Web OAuth Login
- Kích hoạt Login with JavaScript SDK
- Thêm tên miền portal của bạn vào ô Allowed Domains for the JavaScript SDK (ví dụ:
app.chatconnectx.com)
Bước 4: Cấu hình Webhook trên ứng dụng Facebook
1
Thêm App Domain
Tại mục Settings → Basic, nhập tên miền portal của bạn (ví dụ: 
app.chatconnectx.com) vào ô App Domains.2
Thêm sản phẩm Messenger
Tại danh mục Products, thêm sản phẩm Messenger vào ứng dụng.
3
Cấu hình Webhook
Tại trang cấu hình của Messenger, thiết lập Webhook:
- Callback URL: Nhập đường dẫn Webhook URL được cấp ở Bước 2 (ví dụ:
https://app.chatconnectx.com/integrations/messenger/callback) - Verify Token: Nhập chuỗi Webhook Verify Token bạn đã cấu hình trên Portal quản trị ở Bước 2.
Bước 5: Thử nghiệm trước khi vận hành chính thức
Meta sẽ không chuyển tiếp tin nhắn từ Fanpage đến webhook của bạn cho đến khi ứng dụng được phê duyệt Live. Bạn cần thêm tài khoản thử nghiệm để kiểm tra trước.1
Liên kết Fanpage
Tại trang cấu hình Messenger trên ứng dụng Facebook, nhấn Connect bên cạnh Fanpage bạn muốn dùng thử nghiệm kết nối.
2
Thêm đăng ký sự kiện (Subscriptions)
Tại Fanpage đã liên kết, nhấn Add subscriptions.
3
Chọn các trường dữ liệu đăng ký
Tích chọn các trường dữ liệu sau và nhấn lưu:
4
Gửi tin nhắn thử nghiệm
Dùng tài khoản cá nhân Facebook (đang giữ quyền Admin/Tester của ứng dụng) gửi tin nhắn đến Fanpage. Tin nhắn sẽ được đồng bộ hiển thị trên Portal của bạn.
Đưa ứng dụng vào hoạt động chính thức (Going to Production)
Để khách hàng có thể kết nối Fanpage của họ và sử dụng bình thường, bạn cần gửi ứng dụng Facebook của mình cho Meta xét duyệt.1
Gửi yêu cầu xét duyệt ứng dụng (App Review)
Làm theo quy trình Facebook App Review để Meta xác minh ứng dụng của bạn.
2
Yêu cầu quyền truy cập nâng cao (Advanced Access)
Yêu cầu quyền truy cập nâng cao cho các quyền tối thiểu dưới đây:Các quyền bắt buộc:
Các quyền tùy chọn:
Phiên bản API
Hệ thống hỗ trợ Facebook API v25.0. Hãy đảm bảo ứng dụng của bạn được cấu hình đúng phiên bản này.- Cập nhật phiên bản API tại mục Settings → Advanced trên ứng dụng Facebook của bạn.
- Đảm bảo phiên bản đăng ký webhook cũng được thiết lập là v25.0.
