Hướng dẫn
Làm một lần duy nhất cho mỗi fanpage, khoảng 10–15 phút nếu là lần đầu. Bạn không cần biết lập trình, chỉ cần đang là quản trị viên của fanpage.
Bạn không phải đưa mật khẩu Facebook cho ai. Toàn bộ quy trình dùng cơ chế cấp quyền chính thức của Meta, và bạn có thể thu hồi bất cứ lúc nào ở Facebook → Cài đặt → Ứng dụng và trang web.
Vào developers.facebook.com/apps. Lần đầu vào, Facebook sẽ hỏi xác minh tài khoản nhà phát triển — làm theo hướng dẫn trên màn hình (thường chỉ cần xác nhận số điện thoại).
Bấm Tạo ứng dụng, rồi:
Ứng dụng này là của riêng bạn. Chúng tôi không có quyền truy cập vào nó, không thấy và không giữ mật khẩu Facebook của bạn.
Trong ứng dụng vừa tạo, vào Trường hợp sử dụng ở menu trái → Thêm trường hợp sử dụng → chọn:
Meta đã đổi giao diện. Hướng dẫn cũ trên mạng (kể cả bản trước của trang này) ghi là Thêm sản phẩm → Messenger / Webhooks. Menu đó không còn nữa — giờ mọi thứ gom vào Trường hợp sử dụng. Webhook tự đi kèm, không phải thêm riêng.
Menu trái → Cài đặt ứng dụng → Cơ bản. Trang này có hai thứ cần copy:
| ID ứng dụng | Dãy số dài, hiện sẵn. Đây là App ID. |
|---|---|
| Khoá bí mật | Bấm Hiển thị, Facebook sẽ hỏi lại mật khẩu của bạn. Chuỗi hiện ra là App Secret. |
App Secret dùng để làm gì? Hai việc: xác thực dữ liệu Facebook gửi về (chống giả mạo), và đổi mã ngắn hạn vài giờ sang mã Trang vĩnh viễn. Hệ thống lưu nó dạng mã hoá AES-256, không lưu thô trong cơ sở dữ liệu.
Bước sau sẽ phải tick từng quyền. Mỗi quyền mở ra một tính năng cụ thể:
| Quyền | Dùng để làm gì |
|---|---|
pages_show_list | Liệt kê fanpage bạn quản lý, để chọn kết nối |
pages_read_engagement | Đọc bài viết và số liệu tương tác của trang |
pages_read_user_content | Đọc bình luận của khách dưới bài viết |
pages_manage_engagement | Trả lời, ẩn, xoá, thả like bình luận |
pages_messaging | Đọc và gửi tin nhắn Messenger |
pages_manage_posts | Đăng bài, hẹn giờ, xoá bài |
pages_manage_metadata | Đăng ký nhận webhook cho trang |
business_management | Truy cập trang nằm trong Trình quản lý doanh nghiệp |
ads_read | Tuỳ chọn — xem số liệu quảng cáo |
ads_management | Tuỳ chọn — bật/tắt chiến dịch quảng cáo |
Không cần quyền nào là bỏ tick quyền đó. Ví dụ không dùng mục Quảng cáo thì bỏ hai dòng cuối. Càng ít quyền càng dễ qua bước xét duyệt.
Mở Graph API Explorer. Ở khung bên phải:
Copy chuỗi token dài hiện ra ở ô Mã truy cập.
Quyền cần tick không có trong danh sách? Vào ứng dụng → Trường hợp sử dụng → Quản lý mọi thứ trên Trang → Quyền và tính năng, bấm Thêm cho quyền đó, rồi quay lại Explorer là sẽ thấy.
Đừng bấm liên tục vào ô "Người dùng hoặc Trang" — Facebook có thể tạm khoá tính năng này nếu thao tác quá nhanh nhiều lần.
Bước "Chọn Doanh nghiệp": nếu fanpage không nằm trong Trình quản lý doanh nghiệp nào, hãy chọn "Áp dụng cho tất cả Doanh nghiệp hiện tại và tương lai". Chọn một doanh nghiệp cụ thể sẽ bị kẹt, không bấm Tiếp tục được.
Vào Fanpage → Kết nối fanpage và dán ba thứ:
Bấm Lấy danh sách fanpage. Hệ thống tự đổi sang mã dài hạn rồi hiện danh sách fanpage bạn quản lý. Có điền Khoá bí mật thì mã thành vĩnh viễn, khỏi lo hết hạn.
Tick fanpage muốn quản lý → Lưu & bật nhận realtime.
Xong bước này, quay về danh sách bấm Đồng bộ một lần để kéo toàn bộ hội thoại và bình luận cũ về. Lần đầu có thể mất 10–30 giây.
Quay lại ứng dụng Meta → Webhooks → chọn đối tượng Page → Subscribe to this object, rồi điền:
| Callback URL | https://facebook.hdcode.vn/webhook |
|---|---|
| Verify Token | Hệ thống tự sinh sau khi bạn kết nối fanpage ở bước 6. Lấy trong Fanpage → chọn fanpage → Sửa. |
| Fields cần tick |
feed · messages · message_echoes ·
messaging_postbacks · message_reactions
|
Mỗi ứng dụng Meta chỉ khai được một Callback URL. Nếu ứng dụng này đang dùng cho hệ thống khác thì phải tạo ứng dụng riêng, không dùng chung được.
Đây là bước quan trọng nhất và hay bị bỏ sót nhất. Khi ứng dụng còn ở chế độ Development, Facebook chỉ gửi dữ liệu của những người có vai trò trong ứng dụng — tin nhắn và bình luận của khách hàng thật sẽ không về hệ thống. Nhiều người kết nối xong thấy im lìm và tưởng hỏng, thực ra là do bước này.
Cách làm:
Muốn dùng thử ngay trong lúc chờ duyệt? Vào Vai trò trong ứng dụng → Người dùng thử, thêm tài khoản Facebook của bạn và của nhân viên. Tin nhắn từ những tài khoản đó sẽ về ngay lập tức. Cách này chỉ hợp để test, không phục vụ được khách thật.
Điền Khoá bí mật (App Secret) lúc kết nối thì không. Hệ thống tự đổi mã bạn dán sang mã Trang vĩnh viễn — Facebook không đặt hạn cho loại mã này, cứ chạy mãi tới khi bạn gỡ ứng dụng hoặc đổi mật khẩu Facebook.
Bỏ trống Khoá bí mật thì có. Lúc đó mã chỉ sống vài giờ tới vài tuần. Hết hạn là
hệ thống ngừng nhận tin và báo lỗi code 190.
Cách chữa dứt điểm: vào Fanpage → Kết nối lại, lần này điền đủ cả Khoá bí mật.
Muốn kiểm tra mã còn sống không: mở Access Token Debugger, dán mã vào. Dòng Expires ghi Never là đã vĩnh viễn.
| Kiểm tra cái gì | Làm thế nào |
|---|---|
| Token còn sống | Vào Fanpage, bấm Đồng bộ. Báo số hội thoại/tin nhắn là token tốt.
Báo code 190 là token hỏng hoặc hết hạn. |
| Đọc được tin nhắn | Sau khi đồng bộ, vào Tin nhắn phải thấy các hội thoại đã có sẵn trên fanpage. |
| Trả lời được | Mở một hội thoại, gửi thử một tin. Kiểm tra trên Messenger xem tin đã tới chưa. |
| Webhook hoạt động | Nhắn thử vào fanpage từ một tài khoản khác. Nếu tin hiện trong vòng vài giây là webhook chạy. Nếu phải chờ lâu hoặc không thấy, xem mục Nhật ký. |
| Đăng bài được | Vào Đăng bài, soạn một bài thử rồi bấm Đăng. Kiểm tra trên fanpage. |
| Triệu chứng | Nguyên nhân & cách xử lý |
|---|---|
| Không lấy được danh sách fanpage | Token hết hạn hoặc thiếu pages_show_list. Tạo lại token ở bước 5. |
| Danh sách trống dù có fanpage | Tài khoản Facebook chưa phải quản trị viên của fanpage đó, hoặc lúc cấp quyền bạn không tick chọn fanpage. Tạo lại token và nhớ chọn fanpage. |
| Kết nối xong nhưng không có tin nhắn | Chưa bấm Đồng bộ lần đầu. Vào Fanpage bấm Đồng bộ. |
| Khách nhắn mà không hiện ngay | Ứng dụng chưa ở chế độ Live (bước 8), hoặc chưa khai webhook (bước 7). Xem mục Nhật ký để biết Facebook có gửi dữ liệu về hay không. |
| Bình luận không hiện tên người viết | Facebook chỉ trả tên khi ứng dụng đã qua xét duyệt. Hoàn tất bước 8 là hết. |
| Không trả lời được bình luận | Token thiếu pages_manage_engagement. Thêm quyền rồi tạo lại token. |
| Mục Quảng cáo báo lỗi | Token thiếu ads_read hoặc ads_management. |
| Token hết hạn sau 1–2 giờ | Bạn chưa điền App ID và App Secret nên hệ thống không đổi được sang token dài hạn. Điền đủ rồi kết nối lại. |
code 190 | Token hết hạn hoặc bị thu hồi → làm lại bước 5 và 6. |
code 10 khi gửi tin |
Quá 24 giờ kể từ tin nhắn cuối của khách. Meta chỉ cho nhắn tự do trong 24 giờ đó. |
code 100 / code 200 |
Token thiếu quyền cho thao tác đang làm. Đối chiếu bảng quyền ở bước 4. |
| Có phải đưa mật khẩu Facebook không? | Không. Toàn bộ dùng cơ chế cấp quyền chính thức của Meta. Chúng tôi không thấy và không lưu mật khẩu của bạn. |
| Muốn ngắt kết nối thì làm sao? | Hai cách: xoá fanpage trong mục Fanpage, hoặc thu hồi quyền ở Facebook → Cài đặt → Ứng dụng và trang web. Cách thứ hai chặn triệt để hơn. |
| Quản lý được mấy fanpage? | Không giới hạn. Mỗi fanpage kết nối một lần, dùng chung một ứng dụng Meta cũng được. |
| Dữ liệu khách có bị lẫn với người khác không? | Không. Mỗi tài khoản chỉ thấy fanpage của chính mình; hội thoại, bài đăng và số liệu quảng cáo đều tách riêng theo chủ sở hữu. |
| Có dùng công cụ tự động đăng nhập không? | Không. Hệ thống chỉ gọi Graph API chính thức của Meta, không mượn cookie, không giả lập trình duyệt — nên fanpage không bị rủi ro khoá. |
| Không rành kỹ thuật thì sao? | Liên hệ để bên mình làm giúp phần thiết lập. Bạn chỉ cần bấm duyệt trên Facebook. |
Quản trị viên sẽ xem và mở tài khoản, thường trong ngày làm việc. Chúng tôi báo lại qua email ngay khi mở xong — lúc đó bạn đăng nhập bình thường.