Chuyển đến nội dung chính
Tạo ứng dụng Facebook Messenger riêng giúp tùy biến màn hình cấp quyền hiển thị thương hiệu và logo của riêng bạn khi khách hàng kết nối Fanpage.

​
Đ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.
Create App button in the Facebook Developer Portal
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.
App name and contact email fields
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.
Use case selection - Other option highlighted
4

Chọn loại ứng dụng (App type)

Chọn loại ứng dụng là Business.
App type selection - Business option highlighted
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.
Confirmation screen before creating the app
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.
App ID and App Secret in Basic Settings

​
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:
https://app.chatconnectx.com/manage/integrations
Sau đó chọn Messenger.
chatbotx_super_admin_integrations_messenger
2

Nhập thông tin ứng dụng

chatbotx_super_admin_messenger_edit_modal
Điền đầy đủ các thông số lấy từ Meta Developer Portal vào biểu mẫu:
TrườngMô tảNơi lấy thông tin
App IDMã ID ứng dụng FacebookSettings → Basic
App SecretMã khóa bảo mật của ứng dụngSettings → Basic → nhấn Show
Webhook Verify TokenChuỗi ký tự bảo mật tự chọn dùng để xác thực webhookBạn tự nhập một chuỗi ngẫu nhiên (chữ và số)
API VersionPhiên bản API của Facebook (sử dụng v25.0)Settings → Advanced
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.
chatbotx_super_admin_messenger_overview

​
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.
Adding Facebook Login product
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)
Facebook Login settings with OAuth and SDK options

​
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.
App domain field in Basic Settings
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.
Adding Messenger product
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.
Webhook callback URL and verify token fields

​
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.
Connect button for a Facebook Page
2

Thêm đăng ký sự kiện (Subscriptions)

Tại Fanpage đã liên kết, nhấn Add subscriptions.
Add subscriptions button
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:
messages
messaging_postbacks
message_reads
message_echoes
messaging_optins
messaging_feedback
messaging_referrals
Subscription fields selection
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:
QuyềnMục đích sử dụng
pages_messagingGửi tin nhắn thay mặt Fanpage của bạn
pages_show_listHiển thị danh sách Fanpage có thể kết nối
pages_manage_metadataĐăng ký webhook để nhận sự kiện từ Fanpage
Các quyền tùy chọn:
QuyềnMục đích sử dụng
pages_user_genderLấy thông tin giới tính người dùng từ Fanpage
pages_user_localeLấy ngôn ngữ của người dùng từ Fanpage
pages_user_timezoneLấy múi giờ của người dùng từ Fanpage
pages_utility_messagingGửi tin nhắn tiện ích và quản lý các template tin nhắ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.
API version setting in Advanced Settings

​
Hướng dẫn kết nối cho người dùng

Sau khi hoàn tất cấu hình ứng dụng trên Meta Developer Portal và nhập Credentials vào Portal quản trị, khách hàng của bạn có thể tự kết nối Fanpage Facebook của họ. Xem chi tiết tại Hướng dẫn kết nối Facebook Messenger.