📘 Hướng dẫn tạo app Meta & kết nối Auto Ads

Tổng thời gian ~10 phút, kèm ảnh chụp từng bước thực tế (bấm vào ảnh để phóng to). Làm một lần, dùng mãi — xong bạn sẽ có MCP link để dán vào Claude / ChatGPT / Cursor.

1Vào trang tạo ứng dụng Meta

  1. Đăng nhập Facebook, mở developers.facebook.com → bấm Ứng dụng của tôi góc phải trên. (Lần đầu sẽ được yêu cầu đăng ký làm developer — bấm đồng ý là xong.)
Trang chủ developers.facebook.com
B1. Trang developers.facebook.com — bấm "Ứng dụng của tôi" ở góc phải trên.
  1. Ở trang danh sách ứng dụng, bấm nút Tạo ứng dụng (góc phải).
Danh sách ứng dụng - nút Tạo ứng dụng
B2. Bấm nút xanh "Tạo ứng dụng". (Mỗi tài khoản tạo được tối đa 15 app chưa gắn business đã xác minh.)
  1. Chi tiết ứng dụng: đặt tên tuỳ ý (vd "Auto Ads IM") + email liên hệ → Tiếp.
Nhập tên ứng dụng và email
B3. Nhập tên ứng dụng + email bạn hay kiểm tra, rồi bấm "Tiếp".

2Chọn trường hợp sử dụng (use case)

Đây là bước quan trọng nhất — quyết định app của bạn được cấp những quyền gì. Ở màn "Thêm trường hợp sử dụng", lọc theo nhóm bên trái và tick:

Use case nhóm Quảng cáo và kiếm tiền
B4a. Lọc "Quảng cáo và kiếm tiền" → tick 2 use case API Marketing (bắt buộc) + API Danh mục (khuyến nghị).
Use case nhóm Quản lý nội dung
B4b. Lọc "Quản lý nội dung" → tick "Quản lý mọi thứ trên Trang" (cần cho boost bài viết) + Instagram nếu muốn.
Use case nhóm Nhắn tin doanh nghiệp
B4c. (Tuỳ chọn) Lọc "Nhắn tin doanh nghiệp" → tick Messenger nếu sau này muốn quản lý tin nhắn. Xong bấm "Tiếp".
⚠️ Use case đã thêm thì KHÔNG gỡ được — nhưng thêm mới (tương thích) thì được, nên cứ tick dư còn hơn thiếu.

3Doanh nghiệp & hoàn tất tạo app

  1. Doanh nghiệp: chọn Business portfolio của bạn nếu có (giúp nâng hạn mức app), hoặc chọn "Tôi chưa muốn kết nối hồ sơ doanh nghiệp" → Tiếp.
Chọn hồ sơ doanh nghiệp
B5. Chọn BM (nếu có) hoặc bỏ qua — kết nối sau cũng được.
  1. Yêu cầu: thường báo "Không xác định thấy yêu cầu nào" (nghĩa là không cần App Review) → Tiếp.
Yêu cầu phát hành - không có
B6. Không có yêu cầu App Review nào — đúng như mong đợi vì mình chỉ quản lý tài khoản của chính mình.
  1. Tổng quan: xem lại → bấm Tạo ứng dụng (nhập mật khẩu Facebook nếu được hỏi).
Tổng quan - Tạo ứng dụng
B7. Màn tổng quan — bấm "Tạo ứng dụng" để hoàn tất.

4Điền thông tin cơ bản + lấy App ID & App Secret

Vào Cài đặt ứng dụng → Thông tin cơ bản (App settings → Basic), điền các trường sau — 3 URL pháp lý chúng tôi đã làm sẵn, bạn chỉ việc copy:

Trường trong form MetaGiá trị điền
Miền ứng dụng (App Domains)autoads.hoiai.net
URL chính sách quyền riêng tư
https://autoads.hoiai.net/privacy.html
URL Điều khoản dịch vụ
https://autoads.hoiai.net/terms.html
Xóa dữ liệu người dùngChọn "URL hướng dẫn xóa dữ liệu" rồi dán:
https://autoads.hoiai.net/data-deletion.html
Hạng mục (Category)Chọn Kinh doanh và trang (Business and pages)
Settings Basic - điền các URL
B8. Cài đặt ứng dụng → Thông tin cơ bản: điền Miền ứng dụng + 3 URL pháp lý như mũi tên.
Save Changes cuối trang
B9. Kéo xuống cuối trang bấm Save Changes — đừng quên bước này!

Sau khi lưu, ghi lại 2 giá trị ở đầu trang này:

Lấy App ID và App Secret
B10. App ID ở ô trái, App Secret bấm "Hiển thị" ở ô phải để copy.
⚠️ App Secret là bí mật tuyệt đối — chỉ nhập vào form của Auto Ads (được lưu server-side, không bao giờ trả về trình duyệt/AI). Đừng gửi qua chat/email công khai.

5Khai báo Redirect URI cho Facebook Login (cách kết nối OAuth)

Bước này để bấm nút "Đăng nhập Facebook" trên Auto Ads là kết nối được. Nếu bạn định dùng cách dán token (xem phụ lục cuối trang) thì có thể bỏ qua.

  1. Menu trái → Đăng nhập bằng Facebook → Cài đặt. (Facebook Login thường đã được thêm sẵn theo use case; nếu chưa có thì vào Bảng điều khiển → Thêm sản phẩm.)
  2. Tìm mục URI chuyển hướng OAuth hợp lệ (Valid OAuth Redirect URIs) — không phải ô "Chuyển hướng URI để kiểm tra" ở đầu trang — dán vào rồi nhấn Enter:
    https://autoads.hoiai.net/callback.php
  3. Bấm Save Changes cuối trang.
Valid OAuth Redirect URIs
B11. Đăng nhập bằng Facebook → Cài đặt → dán callback.php vào "URI chuyển hướng OAuth hợp lệ" → Save Changes.
💡 App ở chế độ Development ("Đã hủy đăng") vẫn dùng bình thường — vì bạn là admin của app. Không cần bấm Đăng/Publish, không cần App Review. Muốn đồng nghiệp dùng chung app: Vai trò trong ứng dụng → thêm họ làm Developer/Tester.

6Kết nối vào Auto Ads

  1. Đăng nhập autoads.hoiai.net bằng email (OTP 4 số).
  2. Tab Kết nối → nhập App ID + App Secret (lấy ở bước 4).
  3. Chọn 1 trong 2: 🔑 Đăng nhập Facebook (OAuth — cần bước 5) hoặc 📋 Dán Access Token (lấy token theo phụ lục cuối trang).
  4. Xong! Dashboard hiện MCP link dạng https://autoads.hoiai.net/mcp/sse?token=meta_... + danh sách ad account — copy link dán vào Claude / ChatGPT / Cursor (mục Connectors / Custom MCP).
Form kết nối trên Auto Ads
B12. Form Kết nối trên Auto Ads: nhập App ID + App Secret → bấm "Đăng nhập Facebook" (hoặc chuyển tab "Dán Access Token").
→ Vào dashboard kết nối ngay

7Sự cố thường gặp

Hiện tượngNguyên nhân & cách xử lý
OAuth báo "Invalid Scopes"App thiếu use case tương ứng với quyền được xin. Auto Ads chỉ xin các quyền chuẩn của use case Marketing API nên hiếm gặp; nếu gặp → dùng cách dán token.
OAuth báo "App not active / không dùng được ứng dụng này"App ở Development mode và tài khoản Facebook đang đăng nhập không có role trong app. Đăng nhập đúng tài khoản tạo app, hoặc thêm role (Vai trò trong ứng dụng), hoặc dùng cách dán token.
OAuth báo "URL bị chặn / redirect_uri không hợp lệ"Chưa khai https://autoads.hoiai.net/callback.php trong "URI chuyển hướng OAuth hợp lệ" (bước 5) — lưu ý dán vào đúng ô danh sách, không phải ô "kiểm tra URI" ở đầu trang.
Kết nối xong nhưng "Chưa thấy ad account nào"Token thiếu quyền ads_read/ads_management, hoặc tài khoản Facebook không có quyền trên ad account nào. Tạo lại token với đủ permissions.
Được cấp thêm quyền tài khoản ads mới sau khi kết nốiVào dashboard → kết nối tương ứng → bấm 🔄 Làm mới để cập nhật danh sách (AI thực ra dùng được ngay, nút này để đồng bộ hiển thị).
Token hết hạn sau ~60 ngàyBình thường với token user. Dashboard sẽ cảnh báo trước — bấm kết nối lại, hoặc chuyển sang System User token (không hết hạn).
AI báo lỗi rate limit (code 17 / 80004)App mới ở tier thấp của Marketing API — giới hạn số call/giờ theo ad account. Chờ 5-15 phút rồi thao tác tiếp; hạn mức tự tăng khi app hoạt động ổn định.

✚Phụ lục: Lấy access token thủ công (cách "Dán token")

Dùng khi bạn không muốn/không dùng được OAuth. Lấy token xong quay lại tab Kết nối → chọn "📋 Dán Access Token".

Cách nhanh — Graph API Explorer (token user ngắn hạn, hệ thống tự đổi sang bản ~60 ngày khi bạn dán vào)

  1. Mở developers.facebook.com/tools/explorer.
  2. Góc phải: Meta App → chọn app bạn vừa tạo.
  3. User or Page → chọn User Token → mục Permissions thêm: ads_management, ads_read, business_management, pages_show_list, pages_read_engagement. (Nếu app của bạn cho phép, thêm pages_manage_engagement để dùng tool trả lời/ẩn bình luận — không có cũng không ảnh hưởng các tool ads.)
  4. Bấm Generate Access Token → đăng nhập/đồng ý → copy chuỗi token.

Cách bền — System User token trong Business Manager (KHÔNG hết hạn — khuyên dùng để chạy lâu dài)

  1. Vào business.facebook.com/settings → Người dùng → Người dùng hệ thống (System users) → Thêm (vai trò Admin).
  2. Chọn system user vừa tạo → Thêm tài sản (Assign assets) → gán Tài khoản quảng cáo (full control / Quản lý chiến dịch) + Trang nếu cần boost bài viết.
  3. Bấm Tạo token (Generate token) → chọn app của bạn → thời hạn chọn Không bao giờ hết hạn (Never) → tick các quyền: ads_management, ads_read, business_management, pages_show_list, pages_read_engagement → tạo và copy token ngay (Meta chỉ hiện 1 lần).
💡 Điều kiện: app phải được gắn vào Business Manager này (lúc tạo app đã chọn BM, hoặc thêm sau trong BM Settings → Tài khoản → Ứng dụng). Token System User đại diện cho "người dùng hệ thống" chứ không phải cá nhân bạn — chỉ thao tác được trên các tài sản đã gán ở bước 2.