HƯỚNG DẪN CẤU HÌNH • TỰ PHỤC VỤ (SELF-SERVICE)

Hướng dẫn kết nối Meta App với NHÂN PAGE

Chỉ cần cấu hình Meta App một lần, nhập App ID và App Secret vào NHÂN PAGE, sau đó đăng nhập Facebook để hệ thống tự động kết nối các Trang bạn quản lý.

Lưu ý bảo mật quan trọng: Mỗi doanh nghiệp nên sử dụng Meta App riêng của mình. Tuyệt đối không bao giờ chia sẻ hoặc gửi App Secret qua chat, email hoặc cho bất kỳ ai, kể cả nhân viên hỗ trợ. App Secret chỉ được dán trực tiếp vào phần mềm NHÂN PAGE trên thiết bị của bạn.

Bộ 1: Tạo App trong Business Manager (8 bước)

Quy trình khởi tạo ứng dụng trực tiếp từ Trình quản lý doanh nghiệp (Business Manager), chọn các trường hợp sử dụng Trang và Messenger trước khi tiến hành cấu hình chi tiết.

Bước 01

Vào Business Manager → Ứng dụng

  1. Đăng nhập vào Trình quản lý doanh nghiệp (Business Manager) theo liên kết business.facebook.com.
  2. Chọn tài khoản doanh nghiệp của bạn, sau đó nhấp vào Cài đặt doanh nghiệp (Business Settings).
  3. Ở bảng điều hướng bên trái, tìm nhóm mục Tài khoản (Accounts) và chọn Ứng dụng (Apps).
Vào Business Manager → Ứng dụng
🔍 Phóng to ảnh
Mở mục Cài đặt doanh nghiệp > Tài khoản > Ứng dụng trong Business Manager
Bước 02

Chọn Tạo ID ứng dụng mới

  1. Tại giao diện quản lý Ứng dụng của Business Manager, nhấp vào nút Thêm (Add) màu xanh.
  2. Trong danh mục tùy chọn thả xuống, nhấp chọn Tạo ID ứng dụng mới (Create a new app ID).
Chọn Tạo ID ứng dụng mới
🔍 Phóng to ảnh
Bấm Thêm và chọn Tạo ID ứng dụng mới
Bước 03

Điền tên và email ứng dụng

  1. Nhập Tên hiển thị ứng dụng (App Display Name) theo tên doanh nghiệp hoặc dịch vụ thương hiệu của bạn.
  2. Nhập Email liên hệ của ứng dụng (App Contact Email) của quản trị viên để Meta gửi thông báo kỹ thuật và cập nhật chính sách.
  3. Chọn mục đích sử dụng ứng dụng doanh nghiệp và bấm tiếp tục.
Điền tên và email ứng dụng
🔍 Phóng to ảnh
Nhập Tên hiển thị và Email liên hệ quản trị của ứng dụng
Bước 04

Chọn trường hợp sử dụng: Trang

Tại danh sách Các trường hợp sử dụng (Use Cases), tích chọn mục Trang (Manage Pages) để ứng dụng được cấp quyền quản lý nội dung, bài viết, bình luận và dữ liệu tương tác của Fanpage.

Lưu ý quan trọng: Chỉ tích chọn trường hợp sử dụng Trang (Pages). Không tích chọn Threads, Instagram, Video trực tiếp hoặc các trường hợp sử dụng khác nếu không phục vụ chức năng Facebook Page.

Chọn trường hợp sử dụng: Trang
🔍 Phóng to ảnh
Chọn trường hợp sử dụng Trang (Manage Pages) để quản trị Fanpage
Bước 05

Chọn trường hợp sử dụng: Messenger

Tiếp tục tại danh sách Các trường hợp sử dụng, tích chọn thêm mục Messenger (pages_messaging) để ứng dụng kết nối trực tiếp với hộp thư của Trang nhằm nhận thông báo tin nhắn và phản hồi khách hàng tự động.

Lưu ý quan trọng: Chỉ chọn Messenger nếu doanh nghiệp cần quản lý hội thoại và tin nhắn tự động. Bỏ qua WhatsApp và Instagram Messaging nếu không phục vụ chức năng Facebook Messenger.

Chọn trường hợp sử dụng: Messenger
🔍 Phóng to ảnh
Chọn trường hợp sử dụng Messenger để quản lý hội thoại và tin nhắn tự động
Bước 06

Liên kết tài khoản doanh nghiệp

Tại bước chọn tài khoản Doanh nghiệp quản lý, chọn đúng tài khoản Business Manager chính thức của bạn để ứng dụng gắn liền với tài sản pháp nhân của doanh nghiệp, không phụ thuộc vào tài khoản cá nhân đơn lẻ.

Liên kết tài khoản doanh nghiệp
🔍 Phóng to ảnh
Chọn tài khoản Business Manager để quản lý và sở hữu ứng dụng Meta
Bước 07

Xem yêu cầu của Meta

Xem lại các chính sách bảo vệ dữ liệu, điều khoản nhà phát triển và yêu cầu tuân thủ của Meta. Đảm bảo đã chuẩn bị sẵn các đường dẫn chính sách bảo mật (https://nhansocial.vn/privacy) và điều khoản dịch vụ (https://nhansocial.vn/terms).

Xem yêu cầu của Meta
🔍 Phóng to ảnh
Kiểm tra các yêu cầu chính sách và quyền truy cập dữ liệu của Meta
Bước 08

Kiểm tra tổng quan và tạo App

  1. Rà soát lại toàn bộ thông tin thiết lập trong Business Manager.
  2. Nhấp vào nút Tạo ứng dụng (Create App) và nhập mật khẩu Facebook của bạn để xác thực danh tính.
  3. Sau khi ứng dụng được tạo thành công, bạn chuyển sang tab Bộ 2: Cấu hình Meta App & kết nối NHÂN PAGE để điền thông tin cơ bản, thêm nền tảng Trang web và cấu hình OAuth Callback.
Kiểm tra tổng quan và tạo App
🔍 Phóng to ảnh
Xác nhận thông tin và bấm Tạo ứng dụng hoàn tất trong Business Manager

Bộ 2: Cấu hình Meta App & kết nối NHÂN PAGE (8 bước)

Quy trình chuẩn: Khai báo thông tin cơ bản, thêm nền tảng Trang web, cấu hình Facebook Login, khai báo OAuth Redirect URI và đồng bộ Trang Facebook vào NHÂN PAGE.

📋 Thông tin cần điền Sử dụng để khai báo trên Meta for Developers
Miền ứng dụng
nhansocial.vn
Website URL
https://nhansocial.vn
Chính sách quyền riêng tư
https://nhansocial.vn/privacy
Điều khoản dịch vụ
https://nhansocial.vn/terms
Xóa dữ liệu người dùng
https://nhansocial.vn/data-deletion
OAuth Redirect URI
https://auth.nhansocial.vn/meta/oauth/callback
📸 Ảnh tổng hợp thông tin cần điền nhanh trên Meta for Developers:
Thông tin cần điền nhanh cho Meta App
🔍 Phóng to ảnh
Thông tin chuẩn cần điền khi thiết lập Meta App
Bước 01

Tạo hoặc mở ứng dụng Meta

  1. Truy cập trang quản trị Meta for Developers và đăng nhập bằng tài khoản Facebook của bạn.
  2. Mở ứng dụng doanh nghiệp hiện có hoặc nhấp vào Tạo ứng dụng (Create App).
  3. Chọn loại trường hợp sử dụng phù hợp với doanh nghiệp của bạn (chọn loại ứng dụng Doanh nghiệp hoặc Khác).
  4. Đặt tên ứng dụng theo tên thương hiệu hoặc tên doanh nghiệp của bạn và hoàn tất phần thông tin email liên hệ.
Tạo hoặc mở ứng dụng Meta for Developers
🔍 Phóng to ảnh
Giao diện tạo hoặc chọn ứng dụng trên Meta for Developers
Bước 02

Điền Thông tin cơ bản

Tại bảng điều hướng bên trái của ứng dụng Meta, vào mục Cài đặt ứng dụng (App Settings) > Chọn Thông tin cơ bản (Basic), sau đó khai báo các trường như sau:

  • Vùng tên (Namespace): Để trống.
  • Miền ứng dụng (App Domains): Nhập nhansocial.vn (bấm Enter để xác nhận tag).
  • Email liên hệ: Nhập địa chỉ email thật của doanh nghiệp hoặc quản trị viên (ví dụ: admin@congtyabc.vn hoặc email Gmail công ty).
  • URL chính sách quyền riêng tư: https://nhansocial.vn/privacy
  • URL Điều khoản dịch vụ: https://nhansocial.vn/terms
  • Xóa dữ liệu người dùng: https://nhansocial.vn/data-deletion
  • Hạng mục: Chọn Doanh nghiệp và Trang (Business and Pages).

Cuộn xuống cuối trang và bấm Lưu thay đổi (Save Changes).

Điền thông tin cơ bản của Meta App
🔍 Phóng to ảnh
Cài đặt Thông tin cơ bản với miền nhansocial.vn và các liên kết pháp lý
Bước 03

Thêm nền tảng Trang web

Vẫn tại trang Thông tin cơ bản, cuộn xuống phần dưới cùng:

  1. Nhấp vào nút + Thêm nền tảng (+ Add Platform) > chọn Trang web (Website).
  2. Tại ô URL trang web (Site URL), nhập chính xác: https://nhansocial.vn
  3. Nhấp Lưu thay đổi (Save Changes).

Lưu ý quan trọng: Tuyệt đối không sử dụng auth.nhansocial.vn làm Website URL. Miền auth.nhansocial.vn chỉ dành riêng cho OAuth callback chuyển hướng.

Thêm nền tảng Trang web Website URL
🔍 Phóng to ảnh
Khai báo Website URL chính xác là https://nhansocial.vn
Bước 04

Cấu hình Đăng nhập bằng Facebook

  1. Ở thanh menu bên trái, tìm và mở sản phẩm Facebook Login (Đăng nhập bằng Facebook). Nếu chưa có, nhấp vào Thêm sản phẩm (Add Product) và chọn Thiết lập tại Facebook Login.
  2. Nhấp vào mục Cài đặt (Settings) dưới Facebook Login.
  3. Đảm bảo mục Đăng nhập OAuth trên web (Web OAuth Login) được bật (chọn Bật / Có / Yes nếu cấu hình hiện tại yêu cầu).
  4. Sử dụng chế độ URI chuyển hướng nghiêm ngặt (Strict Mode for Redirect URIs) để đảm bảo tiêu chuẩn bảo mật Meta cao nhất.
Cấu hình Đăng nhập bằng Facebook
🔍 Phóng to ảnh
Cài đặt sản phẩm Facebook Login và bật Web OAuth Login
Bước 05

Khai báo OAuth Redirect URI

Tại trang Cài đặt của Facebook Login, tìm ô URI chuyển hướng OAuth hợp lệ (Valid OAuth Redirect URIs).

Khai báo chính xác URL sau:
https://auth.nhansocial.vn/meta/oauth/callback

Dán địa chỉ trên vào ô Valid OAuth Redirect URIs và bấm Lưu thay đổi (Save Changes).

Sau khi lưu, bạn có thể kiểm tra tính hợp lệ bằng công cụ kiểm tra (Redirect URI Validator) ở ngay bên dưới. Kết quả kỳ vọng: URI hợp lệ.

Cảnh báo an toàn: Không thêm localhost callback, ChatHub callback hoặc bất kỳ callback SaaS nào khác vào danh sách này cho ứng dụng Meta sản xuất của NHÂN PAGE.

Khai báo Valid OAuth Redirect URI
🔍 Phóng to ảnh
Khai báo URI chuyển hướng OAuth https://auth.nhansocial.vn/meta/oauth/callback
Bước 06

Lấy App ID và App Secret

  1. Quay lại menu Cài đặt ứng dụng > Thông tin cơ bản (App Settings > Basic).
  2. Tại trường ID ứng dụng (App ID): Sao chép chuỗi số App ID.
  3. Tại trường Khóa bí mật của ứng dụng (App Secret): Nhấp vào nút Hiển thị (Show), nhập mật khẩu tài khoản Facebook nếu được hỏi, sau đó sao chép chuỗi ký tự bí mật này.

Cảnh báo bảo mật tuyệt đối:

App Secret là mã khóa bí mật cao nhất của ứng dụng Meta. Bạn tuyệt đối:

  • KHÔNG gửi App Secret qua tin nhắn chat (Zalo, Messenger, Skype, Telegram...).
  • KHÔNG gửi qua ảnh chụp màn hình.
  • KHÔNG lưu vào file văn bản (TXT/DOC) không mã hóa.
  • KHÔNG gửi cho bất kỳ ai, kể cả nhân viên hỗ trợ của NHÂN PAGE.
  • KHÔNG đưa vào nhật ký hệ thống hay đưa lên mạng.

Chỉ dán App Secret trực tiếp vào phần mềm NHÂN PAGE trên thiết bị của bạn.

Lấy App ID và App Secret
🔍 Phóng to ảnh
Sao chép App ID và App Secret (bảo mật tuyệt đối App Secret)
Bước 07

Nhập thông tin vào NHÂN PAGE

  1. Mở phần mềm NHÂN PAGE trên máy tính của bạn.
  2. Tại thanh menu chính, chọn mục Kết nối Meta.
  3. Tại thẻ 1. ỨNG DỤNG FACEBOOK:
    • Dán App ID đã lấy từ Bước 06 vào ô App ID.
    • Dán App Secret đã lấy từ Bước 06 vào ô App Secret.
  4. Nhấp vào nút Lưu cấu hình.

Trạng thái hiển thị kỳ vọng: Thẻ chuyển sang trạng thái ✅ Đã cấu hình ứng dụng Facebook (READY). App Secret được mã hóa an toàn trong Secure Keychain của hệ điều hành và không bao giờ xuất hiện ở dạng văn bản thô.

Nhập thông tin vào NHÂN PAGE
🔍 Phóng to ảnh
Nhập App ID và App Secret vào thẻ 1. ỨNG DỤNG FACEBOOK trong NHÂN PAGE
Bước 08

Kết nối bằng Facebook

  1. Sau khi đã lưu cấu hình thành công ở Bước 07, cuộn xuống phần Lấy token bằng một lần đăng nhập.
  2. Nhấp vào nút Kết nối bằng Facebook. Cửa sổ đăng nhập Facebook sẽ tự động bật mở.
  3. Đăng nhập tài khoản Facebook có quyền quản trị các Trang (Fanpage) bạn muốn kết nối.
  4. Bấm Tiếp tục và xác nhận các quyền Meta yêu cầu (quản lý Trang, đọc tin nhắn, gửi phản hồi...).
  5. Chờ vài giây để hệ thống hoàn tất kết nối và tự động đóng cửa sổ đăng nhập.

Kết quả hiển thị kỳ vọng trên NHÂN PAGE:

  • ✅ Đã kết nối Facebook
  • Token: Đã lưu an toàn trong hệ thống
  • Trang Facebook: Được đồng bộ tự động ngay lập tức và hiển thị đầy đủ danh sách Trang
Kết nối bằng Facebook thành công
🔍 Phóng to ảnh
Hoàn tất đăng nhập Facebook và đồng bộ tự động toàn bộ Trang quản lý

Bộ 3: Nâng cao — Nhập Token thủ công (8 bước)

Phương thức nâng cao dành cho người dùng cần nhập token thủ công hoặc chẩn đoán kỹ thuật. Đăng nhập Facebook bằng OAuth (Bộ 2) vẫn là phương thức khuyến nghị cho mọi người dùng thông thường.

Kiến trúc Token 2 vai trò độc lập:

  • Token 1 (PRIMARY_META): Tạo từ System User trong Business Manager. Dùng cho đồng bộ danh sách Trang, đăng bài, quản lý bình luận và tương tác Meta.
  • Token 2 (MESSENGER_SEND): Tạo từ luồng cấp quyền của Meta (như Graph API Explorer) với quyền pages_messaging trên đúng Page cần chat. Tùy chọn: chỉ cần thiết khi sử dụng tính năng gửi/phản hồi tin nhắn Messenger.
Bước 01

Mở mục Nhập Token thủ công

  1. Mở phần mềm NHÂN PAGE và chọn mục Kết nối Meta tại thanh bên.
  2. Cuộn xuống thẻ 3. NÂNG CAO (Nhập Token thủ công) (Manual Fallback).
  3. Tại đây, hệ thống hiển thị 2 trường nhập token độc lập: Meta Access Token ** (bắt buộc) và Token Trả lời Messenger (tùy chọn).

Lưu ý: Phương thức thủ công này chỉ nên sử dụng khi không thể đăng nhập OAuth hoặc khi cần quản trị nâng cao với System User chuyên biệt.

Mở mục Nhập Token thủ công trên NHÂN PAGE
🔍 Phóng to ảnh
Giao diện thẻ 3. NÂNG CAO (Nhập Token thủ công) trong NHÂN PAGE
Bước 02

Vào Người dùng hệ thống

  1. Đăng nhập vào Trình quản lý doanh nghiệp (Business Manager) theo liên kết business.facebook.com.
  2. Mở mục Cài đặt doanh nghiệp (Business Settings).
  3. Tại menu điều hướng bên trái, chọn Người dùng > Người dùng hệ thống (System Users).
  4. Chọn đúng System User tên NHÂN PAGE (hoặc bấm Thêm để tạo System User mới với quyền Quản trị viên nếu chưa có).
  5. Chuyển sang tab Tài sản đã chỉ định (Assigned Assets) để xem các quyền đã gán.
Vào Người dùng hệ thống trong Business Manager
🔍 Phóng to ảnh
Mở Cài đặt doanh nghiệp > Người dùng hệ thống và chọn System User
Bước 03

Kiểm tra quyền và Page đã cấp

  1. Kiểm tra System User có Quyền truy cập của Admin (Admin Access).
  2. Tại mục Trang Facebook, kiểm tra danh sách Fanpage cần quản lý đã được gán và hiển thị Quyền truy cập đầy đủ (Full Control).
  3. Tại mục Ứng dụng đã cài đặt, xác nhận ứng dụng Meta App của doanh nghiệp đã được liên kết với System User.
  4. Nếu thiếu Trang nào, bấm Thêm tài sản để cấp quyền bổ sung trước khi tạo token.
Kiểm tra quyền và Trang đã cấp cho System User
🔍 Phóng to ảnh
Xác minh quyền Admin và các Trang Facebook đã được chỉ định cho System User
Bước 04

Tạo Token 1 — System User

  1. Tại hàng thông tin của System User NHÂN PAGE, nhấp vào nút Tạo mã (Generate Token).
  2. Chọn đúng ứng dụng Meta của doanh nghiệp đã cấu hình.
  3. Chọn thời hạn token (khuyến nghị Không bao giờ hết hạn - Never Expirable cho System User).
  4. Tích chọn các quyền cần thiết cho hoạt động quản lý Trang: pages_show_list, pages_read_engagement, pages_manage_posts, pages_manage_metadata, pages_read_user_content...
  5. Bấm Tạo mã truy cập và sao chép chuỗi mã truy cập hiển thị trên pop-up.

Đặc tính Token 1: Đây là PRIMARY_META Token. Dùng riêng cho đồng bộ dữ liệu Trang, xem thông tin và đăng bài/bình luận. Không tự động đóng vai trò token gửi tin nhắn Messenger.

Tạo Token 1 System User Access Token
🔍 Phóng to ảnh
Tạo mã System User Access Token (Token 1 - PRIMARY_META)
Bước 05

Dán Token 1 vào NHÂN PAGE

  1. Quay lại phần mềm NHÂN PAGE tại mục 3. NÂNG CAO (Nhập Token thủ công).
  2. Dán chuỗi token vừa sao chép ở Bước 04 vào ô Meta Access Token **.
  3. Phân định vai trò nghiêm ngặt: Tuyệt đối không dán Token 1 vào ô Token Trả lời Messenger. Hệ thống phân chia ranh giới rõ ràng giữa hai quyền hạn này.
Dán Token 1 vào ô Meta Access Token
🔍 Phóng to ảnh
Dán Token 1 vào đúng ô Meta Access Token **, không dán vào ô Messenger
Bước 06

Mở Graph API Explorer

  1. Mở trình duyệt và truy cập: https://developers.facebook.com/tools/explorer/ (Trình khám phá API Đồ thị).
  2. Tại mục Ứng dụng trên Meta (Meta App), chọn đúng ứng dụng Meta của doanh nghiệp bạn.
  3. Tại mục Người dùng hoặc Trang (User or Page), lưu ý cần chọn đúng Trang (Fanpage) bạn muốn cấp quyền gửi tin nhắn Messenger.
  4. Nhấp vào nút Permissions (Quyền) để mở danh mục quyền cấp phép.

Lưu ý quan trọng về loại Token: User Access Token trên Graph API Explorer KHÔNG tự động là Page Access Token gửi Messenger hợp lệ. Để gửi tin nhắn Trang, bạn bắt buộc phải tạo hoặc trích xuất đúng Page Access Token của Trang đó.

Mở Trình khám phá API Đồ thị Graph API Explorer
🔍 Phóng to ảnh
Truy cập Graph API Explorer và chọn ứng dụng Meta cùng Trang đích
Bước 07

Tạo và điền Token 2 — Messenger

  1. Tại danh mục quyền Permissions, đảm bảo tích chọn quyền bắt buộc: pages_messaging.
  2. Bấm Generate Access Token để Meta tạo mã xác thực.
  3. Sao chép chuỗi mã truy cập Page Access Token và quay lại NHÂN PAGE.
  4. Dán mã token này vào ô Token Trả lời Messenger.

Tính chất Tùy chọn & An toàn quyền hạn:

  • Token 2 là tùy chọn: Nếu doanh nghiệp chỉ quản lý bài viết, đọc bình luận mà không sử dụng tính năng phản hồi tin nhắn tự động qua Messenger, bạn có thể để trống ô này.
  • Quyền pages_messaging: Quyền pages_utility_messaging đơn thuần KHÔNG thể thay thế cho pages_messaging khi gửi tin nhắn thoại/hội thoại thông thường.
  • Cách ly hoàn toàn: Không bao giờ định tuyến tin nhắn gửi đi qua Token 1 (PRIMARY_META).
Tạo và dán Token 2 vào ô Token Trả lời Messenger
🔍 Phóng to ảnh
Tạo Token 2 có quyền pages_messaging và dán vào ô Token Trả lời Messenger
Bước 08

Kết nối Meta App và kiểm tra

  1. Rà soát lại thông tin: Ô Meta Access Token ** đã có Token 1; Ô Token Trả lời Messenger có Token 2 (nếu cần dùng Messenger).
  2. Bấm nút Kết nối Meta App (Connect Meta App) màu xanh.
  3. Hệ thống thực hiện xác thực chữ ký API với Meta, mã hóa token an toàn bằng AES-256 và kích hoạt các quyền tương ứng.
  4. Sau khi kết nối thành công, thẻ thông báo hiển thị Sẵn sàng (READY) kèm danh sách khả năng tính năng (Feature Capabilities) có màu xanh lá.

Khuyến cáo: Token thủ công có thể hết hạn tùy thuộc vào chính sách cấp phát của Meta và loại token. Nếu phát sinh lỗi hết hạn, bạn chỉ cần tạo lại mã token mới và cập nhật lại vào ô tương ứng trong NHÂN PAGE.

Bấm Kết nối Meta App và kiểm tra trạng thái
🔍 Phóng to ảnh
Bấm Kết nối Meta App để hoàn tất thiết lập thông tin xác thực thủ công

Có 2 cách kết nối trong NHÂN PAGE

Cả hai phương thức kết nối đều được NHÂN PAGE hỗ trợ chính thức và song song. Sau khi kết nối, hệ thống sẽ chuẩn hóa tự động vào bộ định tuyến thông tin xác thực để toàn bộ tính năng hoạt động đồng nhất.

PHƯƠNG THỨC 1 — KHUYẾN NGHỊ

Đăng nhập Facebook một lần (OAuth)

Chỉ cần cấu hình Meta App một lần và đăng nhập. Tự động đồng bộ toàn bộ Trang quản lý, tự động gia hạn token, bảo mật cao nhất và tiện lợi cho mọi doanh nghiệp.

PHƯƠNG THỨC 2 — NÂNG CAO

Nhập Token thủ công

Dành cho cấu hình kỹ thuật nâng cao, môi trường mạng đặc biệt, chẩn đoán lỗi hoặc nhu cầu chạy dự phòng với các token kiểm thử độc lập.

Quay về Trang chủ Xem Chính sách quyền riêng tư
Đã sao chép