Kết nối Meta Social với omniVN
Có thể kết nốiKết nối Facebook Page và tài khoản Instagram liên kết bằng token System User của app Meta do chính doanh nghiệp sở hữu; Omni0 chỉ đọc insights và bài đăng.
Mặc định Omni0 chỉ đọc bài 28 ngày gần nhất và insights vài ngày gần nhất; chọn mốc lịch sử để nhập dữ liệu cũ hơn.
Giới hạn hiện tại
- Chưa có Facebook Login cho Page/Instagram; kết nối bằng token System User.
- Bình luận, tag, mention và story chưa được đồng bộ.
- Reach/số người xem là số người duy nhất theo ngày hoặc theo bài; Omni0 không cộng dồn qua nhiều ngày.
Tổng quan
Meta Social đọc số liệu tự nhiên (không phải quảng cáo): follower, lượt xem, lượt tương tác theo ngày của Page và Instagram, cùng danh sách bài đăng và số liệu từng bài. Mỗi kết nối là một Facebook Page, kèm tài khoản Instagram chuyên nghiệp đã liên kết với Page đó. Kết nối dùng token System User tạo trong Meta Business Settings cho app Meta của doanh nghiệp (cùng app đã bàn giao cho Meta Ads). Token đặt Không bao giờ hết hạn thì không phụ thuộc tài khoản cá nhân và không cần App Review khi doanh nghiệp chỉ đọc tài sản của chính mình.
Điều kiện trước khi bắt đầu
- Omni0 đã nhận App ID/Secret của app Meta của doanh nghiệp (giống Meta Ads).
- Một người có toàn quyền trên Business Portfolio sở hữu Page để tạo System User.
- Instagram là tài khoản chuyên nghiệp (Business/Creator) đã liên kết với Page.
- Trong Omni0: quyền kết nối kênh trên workspace (channels.connect).
Các bước lấy credential
1. Tạo System User
Business Settings → Người dùng hệ thống → Thêm. Đặt tên (ví dụ Omni0 Insights Reader), vai trò Nhân viên. Nên tạo riêng cho Omni0, không dùng lại System User của Conversions API.
2. Gán tài sản với quyền tối thiểu
Chỉ định tài sản: Page (Thông tin chi tiết; thêm Hoạt động cộng đồng nếu cần danh sách bài và bình luận), tài khoản Instagram (Thông tin chi tiết, Hoạt động cộng đồng) và app của doanh nghiệp (Thử nghiệm ứng dụng). Không cần quyền Nội dung, Tin nhắn hay Quảng cáo.
3. Tạo mã
Tạo mã → chọn đúng app đã bàn giao cho Omni0 → Hết hạn: Không bao giờ → chọn quyền pages_show_list, pages_read_engagement, read_insights, business_management; thêm instagram_basic và instagram_manage_insights để đọc Instagram. Sao chép mã vào kho mật khẩu của doanh nghiệp; Meta chỉ hiển thị một lần.
4. Dán token vào Omni0
Omni0 → Integrations → Meta Social → Connect with a system-user token, dán mã. Omni0 kiểm tra mã với Meta (đúng app, đủ quyền), liệt kê Page mà mã đọc được, mã hoá và không bao giờ hiển thị lại.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| System-user token | access_token | Bắt buộc | user_entered Tạo trong Business Settings → Người dùng hệ thống → Tạo mã cho app của doanh nghiệp; dán một lần, Omni0 mã hoá và không hiển thị lại. |
| Facebook Page | page_id | Bắt buộc | oauth_authorization Chọn từ các Page mà token đọc được (/me/accounts), không nhập tay. |
accessToken → secret store sau khi dán; Page id → tài khoản của kết nối (chọn từ /me/accounts); Instagram id → lấy từ instagram_business_account của Page. Page token được tạo lại mỗi lần đồng bộ, không lưu.
Vòng đời token
Token System User đặt Không bao giờ hết hạn thì không cần gia hạn. Meta khuyến nghị token 60 ngày cho bảo mật; nếu chọn 60 ngày thì phải dán token mới trước khi hết hạn (Replace token). Thu hồi bằng Business Settings → Người dùng hệ thống → Thu hồi mã, hoặc gỡ tài sản khỏi System User.
Lỗi thường gặp
TOKEN_APP_MISMATCH
Mã được tạo cho app khác app đã bàn giao cho Omni0. Tạo lại mã và chọn đúng app.
TOKEN_SCOPE_MISSING
Mã thiếu pages_show_list, pages_read_engagement hoặc read_insights. Tạo mã mới với đủ quyền.
Không thấy Page nào sau khi dán token
System User chưa được gán Page, hoặc mã thiếu business_management nên Page do Business Portfolio quản lý không được liệt kê.
Tab Instagram trống
Page chưa liên kết tài khoản Instagram chuyên nghiệp, hoặc mã thiếu instagram_basic / instagram_manage_insights. Số liệu tài khoản Instagram chỉ có trong 90 ngày gần nhất.