Facebook Lead Ads

Facebook không cho phép tự động bắn lead thẳng sang hệ thống ngoài — cần một cầu nối để lấy lead từ Form quảng cáo (Lead Ads) rồi đưa về CRM. Có 2 cách:

Cách A — Qua Zapier

Chuẩn bị: đã tạo 1 nguồn dữ liệu (có API key + endpoint); tài khoản Zapier; quyền admin Trang FB + tài khoản quảng cáo.

1. Tạo Zap mới → Trigger: app Facebook Lead Ads → event New Lead.
2. Kết nối tài khoản Facebook, chọn Trang (Page) và Form quảng cáo muốn thu lead.
3. Action: app Webhooks by Zapier → hành động POST.
4. URL: https://api-cms.abaoson.vn/api/v2/crm/ingest · Payload Type: Json.
5. Data (map trường form FB → key CRM): full_name → name, phone_number → phone, email → email. Có thể thêm capture_form = tên form, utm_source = facebook.
6. Headers: x-api-key = API key của nguồn; Content-Type = application/json.
7. Bấm Test → kiểm tra tab Nhật ký + Danh sách contact → OK thì Publish/Turn on Zap.

• Tên trường trong form FB có thể khác nhau (full_name, phone_number...) — cứ map đúng sang name/phone/email.
• Make.com tương tự: module Facebook Lead Ads → Watch Leads rồi HTTP → Make a request.

Cách B — Kết nối trực tiếp trong CMS (không cần Zapier)

Vào Quản lý nguồn dữ liệu → tab Kết nối Facebook. Lead từ Form quảng cáo sẽ tự chảy về, không qua bên thứ 3.

Bước 1 — Tạo App Meta

1. Vào developers.facebook.com → My Apps → Create App.
2. Chọn loại Business → đặt tên (ví dụ "songtute_crm") → tạo. App ở chế độ Development là dùng được cho Trang của bạn.

Bước 2 — Cấu hình Webhook (chọn đúng đối tượng Page)

1. Menu trái → Webhooks.
2. Ở dropdown "Chọn sản phẩm" trên cùng → chọn Page (KHÔNG chọn "User").
3. Điền:

   Callback URL: https://api-cms.abaoson.vn/api/v2/crm/fb/webhook
   Verify Token: baoson_crm_fb_2026

   Bấm Xác minh và lưu — hệ thống trả 200 → lưu thành công.
4. Trong danh sách Trường webhook → tìm leadgen → gạt Đăng ký (Subscribe). Chỉ cần leadgen.

Bước 3 — Lấy Page Access Token

1. Mở Graph API Explorer: developers.facebook.com/tools/explorer
2. Góc phải, mục Meta App → chọn đúng App của bạn.
3. Mục User or Page → để User Token trước.
4. Bấm Add a Permission → tick đủ 4 quyền: pages_show_list · pages_read_engagement · pages_manage_metadata · leads_retrieval
5. Bấm Generate Access Token → đăng nhập → đồng ý cấp quyền → chọn Trang cần thu lead.
6. Gõ vào ô truy vấn me/accounts?fields=id,name,access_token → Submit. Kết quả trả mảng, mỗi Trang có id (= Page ID) và access_token (= Page Access Token) — copy đúng dòng Trang của bạn.

   { "data": [ { "id": "1029384...", "name": "Trang cua ban", "access_token": "EAAG..." } ] }

7. (Khuyến nghị) Đổi token dài hạn: mở Access Token Debugger (developers.facebook.com/tools/debug/accesstoken) → dán token → Extend Access Token → copy token mới. Bỏ qua thì token hết hạn sau ~1-2 tháng.

Bước 4 — Kết nối trong CMS

1. CMS → Quản lý nguồn dữ liệu → tab Kết nối Facebook.
2. Bấm "Đăng nhập Facebook để kết nối" → đăng nhập bằng tài khoản quản trị Trang → chọn Trang cần thu lead → đồng ý cấp quyền.
3. CMS tự đăng ký nhận lead/tin nhắn cho Trang. Thấy Trang xuất hiện ở bảng "Trang Facebook đã kết nối" là xong — chọn Trạng thái mặc định của lead (thường là Lead mới) ngay trên bảng.

Bước 5 — Tạo biểu mẫu (Instant Form) & Test

Muốn test cần có ít nhất 1 biểu mẫu tức thì (Instant Form) trên Trang. Nếu tool báo "This page has no form associated" nghĩa là Trang chưa có form → tạo mới:

1. Bấm "Go To Instant Forms" (trong tool), hoặc vào business.facebook.com → chọn Trang → Công cụ khác → Biểu mẫu tức thì.
2. Bấm Tạo biểu mẫu → đặt tên (ví dụ "Form Test CRM").
3. Phần Câu hỏi: bật Họ tên, Số điện thoại, Email.
4. Phần Chính sách quyền riêng tư: dán 1 đường link bất kỳ (BẮT BUỘC) — không có sẽ không lưu được form.
5. Bấm Hoàn tất / Xuất bản.
6. Quay lại Lead Ads Testing Tool (developers.facebook.com/tools/lead-ads-testing): chọn lại Trang → Product Lead Retrieval → mục Mẫu hiện form vừa tạo → chọn → bấm Tìm kiếm khách hàng tiềm năng (tạo lead giả).
7. Kiểm tra CMS → Nhật ký + Danh sách contact.

Ở chế độ Dev, dùng được ngay cho Trang của bạn mà chưa cần App Review. Muốn dùng cho nhiều Trang/khách khác → cần Meta duyệt quyền leads_retrieval.