Loại tài khoản yêu cầu — FB/IG/Zalo

Câu hỏi phổ biến nhất khi khách kết nối kênh: “Tài khoản cá nhân của tôi dùng được không?” / “Tôi có IG rồi sao không kết nối được?”. Trang này trả lời thẳng — dựa trên yêu cầu thật của hệ thống.

Bảng tóm tắt — dùng được hay không

Kênh	Tài khoản cá nhân?	Yêu cầu	Connect
Facebook Messenger	❌ KHÔNG	Facebook Page (có quyền `pages_messaging`)	OAuth → chọn Page
Facebook Auto Post	❌ KHÔNG	Facebook Page (có quyền `pages_manage_posts`)	OAuth (tab Auto Post)
Instagram DM	❌ KHÔNG	IG Business/Creator + link FB Page	OAuth → chọn IG
Instagram Auto Post	❌ KHÔNG	IG Business + `instagram_content_publish` + link Page	OAuth (tab Auto Post)
Zalo OA	n/a	Official Account (App ID + Secret)	Form / OAuth
Zalo Bot	n/a	Bot Token từ Zalo Bot Manager	Form
Zalo Cá nhân	✅ CÓ	Trả phí + rủi ro khoá	QR / Cookie + Proxy

1. Facebook — phải là Page

Tại sao cá nhân không dùng được

Toàn bộ luồng Facebook dùng Graph API /me/accounts — endpoint này của Meta chỉ trả về Page bạn quản trị, không bao giờ trả profile cá nhân. Scope bắt buộc là pages_messaging (cấp Page), không có scope profile cá nhân.

OAuth popup hiện: “Chọn Fanpage để kết nối” — không có lựa chọn profile cá nhân.

Lỗi nếu cố dùng cá nhân

Nếu bạn FB chỉ có profile cá nhân (không có Page nào):

Popup OAuth trả về 0 Page.
Toast hiện: “Không tìm thấy trang nào. Hãy đảm bảo bạn có quyền quản lý Page.”
Backend log chi tiết hơn: “Không tìm thấy Facebook Page nào. Nguyên nhân có thể: tài khoản chưa có Page nào / Page thuộc Meta Business Account / chưa chọn Page nào trong màn hình chọn tài sản.”

Cách fix

Tạo Facebook Page cho shop (miễn phí): facebook.com → Pages → Create New Page.
Quay lại Kênh → tab Nhắn tin tự động → Kết nối Facebook → chọn Page mới.

2. Instagram — phải Business/Creator + link Page

“Tôi có IG rồi sao không kết nối được?”

Đây là câu hỏi kinh điển. 99% trường hợp là vì IG của bạn là Personal (cá nhân), chưa phải Business/Creator, hoặc đã là Business nhưng chưa link với Facebook Page.

Hệ thống filter ở backend: chỉ Page có field instagram_business_account mới xuất hiện trong list chọn. IG Personal không có field này → bị filter ra → list rỗng → “không tìm thấy”.

Yêu cầu chính xác

IG phải thoả cả 2:

Loại tài khoản = Business hoặc Creator (không phải Personal).
Đã liên kết với 1 Facebook Page mà bạn quản trị.

Lỗi nếu IG Personal

OAuth xong → list tài khoản IG rỗng.
Toast: “Không tìm thấy trang nào. Hãy đảm bảo bạn có quyền quản lý Page.” (thông báo này hơi chung — cho IG thì nguyên nhân thật là account type, không phải quyền Page).
Backend: HTTP 404 “Không tìm thấy Page hoặc Page chưa liên kết Instagram Business.”

Cách fix — 3 bước

Convert IG sang Business/Creator:
- Mở app IG → Profile → Edit Profile → Switch to professional account → chọn Business (hoặc Creator).
Link IG với Facebook Page:
- IG Settings → Business/Creator → Linked accounts → Facebook → chọn Page của shop.
Reconnect ở TrolyPage:
- Kênh → tab Nhắn tin tự động → Instagram → Kết nối Instagram → giờ IG sẽ xuất hiện.

2 điều kiện cùng lúc

Convert Business mà chưa link Page → vẫn không kết nối được. Link Page mà IG vẫn Personal → cũng không được. Phải cả 2 cùng lúc.

3. Zalo — 3 loại khác nhau

TrolyPage hỗ trợ 3 loại Zalo hoàn toàn khác nhau. Đừng nhầm.

3a. Zalo OA (Official Account)

Yêu cầu: Tài khoản Zalo Official Account đã đăng ký (có OA ID + App ID + Secret Key từ Zalo OA management).
Cách connect: Form nhập OA ID + App ID + Secret (hoặc OAuth Zalo).
Rủi ro: Không — đây là API chính thức của Zalo.
Token: Access token 25h, tự refresh; nếu refresh fail → reauth_required → phải cấp lại.

3b. Zalo Bot

Yêu cầu: Bot Token từ Zalo Bot Manager.
Cách connect: Form — chỉ cần dán Bot Token.
Khác OA: Bot đơn giản hơn, 1 chiều (chỉ nhận/s gửi message event), dùng Bot Platform riêng của Zalo.
Rủi ro: Không — API chính thức.

3c. Zalo Cá nhân — RỦI RO CAO + TRẢ PHÍ

Đây là loại đặc biệt — dùng API không chính thức để điều khiển nick Zalo cá nhân.

Yếu tố	Chi tiết
Yêu cầu	Gói trả phí (entitlement `zalo_personal`) — gói trial không có
Cách connect	QR code (quét bằng app Zalo điện thoại) hoặc Cookie (đăng nhập Zalo Web → copy cookie + IMEI + User-Agent)
Sidecar	Phải chạy Node.js sidecar (`zalo-sidecar`) — nếu sidecar down → kết nối fail
Proxy	Bắt buộc khuyến nghị — mỗi tài khoản 1 proxy riêng (residential/4G VN) để tránh khoá
Session	Cookie sống vài giờ/vài ngày → phải đăng nhập lại định kỳ

Lỗi Zalo cá nhân thường gặp

Triệu chứng	Nguyên nhân	Fix
“Tính năng trả phí” + nút khoá	Gói trial → không có entitlement	Nâng cấp gói
“Đang chờ quét QR…” lâu	Chưa quét / hết giờ (80 lần poll × 3s)	Quét lại QR
“Kết nối thất bại. Thử đăng nhập bằng Cookie.”	QR fail	Dùng cách Cookie
“Cookie đã hết hạn hoặc bị Zalo từ chối”	Cookie expire / Zalo chặn	Đăng nhập lại QR lấy cookie mới
“Sidecar không phản hồi”	Node sidecar down	Báo admin TrolyPage restart sidecar
Nick bị khoá sau vài ngày	Dùng nhiều nick cùng IP	Mỗi nick 1 proxy residential VN

4. Các lỗi “không kết nối được” khác

Token Facebook/Instagram hết hạn

Token FB/IG là long-lived token 60 ngày (Meta exchange). Khi hết hạn:

Token không tự gia hạn — phải reconnect.
Cảnh báo ở tab Auto Post: “Token hết hạn — cần refresh hoặc kết nối lại”.

“Phiên xác thực Facebook không hợp lệ”

State mismatch / session expired giữa lúc OAuth.
Fix: Kết nối lại từ đầu.

“Phiên OAuth đã hết hạn. Vui lòng kết nối lại.”

Session chọn Page hết hạn (chậm tay quá lâu ở bước chọn).
Fix: Kết nối lại, chọn Page nhanh hơn.

Page thuộc Meta Business Account — không thấy

Page quản trị qua Meta Business Account (không trực tiếp) có thể không xuất hiện.

Fix 1: Đảm bảo bạn được add vào Business Account với quyền quản lý Page.
Fix 2: Trong OAuth, accept tất cả quyền (kể cả business_management).
Fix 3: Vào facebook.com → Cài đặt → Ứng dụng → xoá TrolyPage → kết nối lại.

Toast: “Trình duyệt đã chặn popup. Vui lòng cho phép popup.”

Fix: Thanh address → icon popup blocked → Allow → thử lại.

5. App Meta chưa được review (Development Mode)

Nếu app Meta đang ở Development Mode (chưa qua App Review):

Chỉ tester/developer trong app mới dùng được.
Người ngoài OAuth → trả 0 Page / permission error.

Hệ thống không có thông báo riêng cho case này (chỉ TikTok có). Symptom: giống “không thấy Page”.

Fix: Vào Meta App Dashboard → submit App Review cho các permission cần thiết (pages_messaging, pages_manage_posts…). Hoặc add người test vào app tạm.

Bước tiếp theo

FAQ kênh — 12+ câu hỏi tương tự.
Facebook Messenger — kết nối.
Instagram — kết nối.
Zalo tổng quan — OA / Bot / Personal.
Troubleshooting Facebook session — lỗi token.