Hướng dẫn

Kết nối fanpage vào hệ thống

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.

Trước khi bắt đầu, bạn cần

  • Một tài khoản Facebook cá nhân đang là quản trị viên của fanpage muốn quản lý. Kiểm tra ở fanpage → Cài đặt → Quyền truy cập trang, tên bạn phải có mục Quyền kiểm soát toàn bộ.
  • Máy tính — vài bước bên Facebook không làm được trên điện thoại.
  • Khoảng 15 phút cho lần đầu. Fanpage thứ hai trở đi chỉ mất 2 phút.

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.

1

Tạo ứng dụng trên Meta ~3 phút

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:

  • Phần Bạn muốn ứng dụng làm gì? — chọn Khác rồi Tiếp
  • Phần Chọn loại ứng dụng — chọn Doanh nghiệp
  • Tên ứng dụng — đặt gì cũng được, ví dụ Quản lý fanpage ABC. Tên này khách hàng không nhìn thấy.
  • Email liên hệ — điền email của bạn

Ứ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.

2

Bật quyền quản lý Trang ~1 phút

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:

  • Quản lý mọi thứ trên Trang — đọc bình luận, đăng bài, nhận webhook
  • Tương tác với khách hàng trên Messenger — đọc và trả lời tin nhắ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.

3

Lấy App ID và App Secret ~1 phút

Menu trái → Cài đặt ứng dụng → Cơ bản. Trang này có hai thứ cần copy:

ID ứng dụngDãy số dài, hiện sẵn. Đây là App ID.
Khoá bí mậtBấ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.

4

Hiểu các quyền cần cấp đọc 1 phút

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ềnDùng để làm gì
pages_show_listLiệ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_engagementTrả 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_managementTruy cập trang nằm trong Trình quản lý doanh nghiệp
ads_readTuỳ chọn — xem số liệu quảng cáo
ads_managementTuỳ 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.

5

Lấy Access Token ~3 phút

Mở Graph API Explorer. Ở khung bên phải:

  • Ô Ứng dụng trên Meta — chọn đúng ứng dụng vừa tạo
  • Ô Người dùng hoặc Trang — để nguyên Mã người dùng
  • Mục Quyền — bấm Thêm quyền rồi tick các quyền ở bước 4
  • Bấm Generate Access Token → cửa sổ đăng nhập hiện ra → chọn fanpage → Xong

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.

6

Nhập vào hệ thống ~1 phút

Vào Fanpage → Kết nối fanpage và dán ba thứ:

  • App ID và App Secret — từ bước 3
  • User Access Token — từ bước 5

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.

7

Khai báo webhook ~2 phút

Quay lại ứng dụng Meta → Webhooks → chọn đối tượng Page → Subscribe to this object, rồi điền:

Callback URLhttps://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.

8

Chuyển ứng dụng sang chế độ Live chờ duyệt 1–7 ngày

Đâ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:

  • Vào Xét duyệt ứng dụng → Quyền và tính năng
  • Bấm Yêu cầu cấp quyền cho từng quyền ở bước 4
  • Facebook sẽ hỏi: mô tả cách bạn dùng quyền đó, và một video quay màn hình cho thấy luồng sử dụng. Quay đúng thao tác thật trong hệ thống là được.
  • Gửi duyệt, chờ Facebook phản hồi (thường 1–7 ngày)
  • Duyệt xong, bật công tắc Development → Live ở đầu trang quản lý ứng dụng

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.

9

Mã truy cập có phải gia hạn không? đọc 1 phú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 hệ thống đã chạy đúng chưa

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.

Lỗi hay gặp

Triệu chứngNguyê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 190Token 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âu hỏi thường gặp

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.

Thấy rắc rối quá?

Để bên mình làm giúp phần kỹ thuật. Bạn chỉ cần bấm duyệt trên Facebook, phần còn lại chúng tôi lo.

Nhận hỗ trợ miễn phí