Kết nối nguồn dữ liệu

Dành cho: Admin & Đại sứ

"Nguồn dữ liệu" là một kênh đổ lead vào kho Data tự động. Cơ chế: bạn tạo một nguồn → hệ thống cấp 1 API key riêng + 1 đường dẫn (endpoint). Bất cứ landing page / form / công cụ nào (Google Form, Zapier, Facebook Lead Ads...) chỉ cần gửi dữ liệu khách về endpoint đó kèm API key là lead tự xuất hiện trong Danh sách contact.

Các bước kết nối

Vào Quản lý nguồn dữ liệu → tab Kênh kết nối — màn hình hiện lưới thẻ kênh (Facebook, Landing Page, Website, Google, TikTok, Zalo OA...). Mỗi thẻ hiện số nguồn đã kết nối + số lead đã thu.
Bấm vào thẻ kênh bạn muốn thu lead. Với Facebook: bấm nút Đăng nhập Facebook là xong. Với kênh khác: đặt tên nguồn (ví dụ "Landing FB Tháng 7") → bấm + Kết nối. Trạng thái mặc định của lead là Lead mới.
Ở bảng nguồn của kênh, bấm "Cách kết nối" để xem hướng dẫn dán vào đúng kênh đó; bấm "Hiện key" khi cần copy API key. Bản chất kỹ thuật: kênh gửi HTTP POST tới endpoint kèm header x-api-key, body JSON thông tin khách.
Test thử rồi kiểm tra cột Lead thu / Lead cuối của nguồn, tab Nhật ký thu lead và màn Kho Data.

Endpoint chung

POST https://api-cms.abaoson.vn/api/v2/crm/ingest

Các trường gửi trong body (JSON)

Trường	Bắt buộc	Ý nghĩa
`phone`	Nên có	SĐT khách — dùng để chống trùng (dedupe)
`name`	Không	Tên khách
`email`	Không	Email khách
`ref_code`	Không	Mã đại sứ sở hữu lead (ghi đè mặc định của nguồn)
`utm_source`	Không	Nguồn quảng cáo (facebook, google...)
`utm_medium`	Không	Hình thức (cpc, organic...)
`utm_campaign`	Không	Tên chiến dịch
`ad_id`	Không	ID quảng cáo
`capture_form`	Không	Tên form/landing thu lead

Endpoint tự bỏ qua các field lạ (ví dụ LadiPage tự thêm link) nên bạn map thoải mái không sợ lỗi. Các trường phụ như message/note/address/content được gộp vào ghi chú của lead.

💡 Nguyên tắc: mỗi kênh tạo 1 nguồn riêng (API key + phân loại riêng) → dễ phân loại nguồn khách & theo dõi hiệu suất từng kênh trong Báo cáo CRM.

Nhật ký thu lead khác gì Kho Data?

Nhật ký thu lead ghi mọi lần dữ liệu được gửi tới hệ thống — kể cả thất bại, trùng số — để bạn kiểm tra kênh có đang chạy không (bung "Xem dữ liệu gốc" khi cần truy vết). Còn Kho Data là nơi quản lý khách hàng: mỗi khách 1 hồ sơ, có trạng thái và tác nghiệp. Hai màn bổ trợ nhau, không thay thế nhau.

Chống trùng (dedupe)

Nếu SĐT đã tồn tại trong kho Data, lead vẫn được ghi nhận nhưng được đánh dấu Trùng SĐT trong nhật ký để bạn rà soát.

Đại sứ tự tạo nguồn riêng

Đại sứ đăng nhập cổng của mình → menu Nguồn dữ liệu → tạo nguồn cá nhân (landing/social riêng). Lead về từ nguồn này tự gắn là nguồn "Tự kiếm" và thuộc về đại sứ đó.

Bài tiếp theo

Thu lead qua Website / API — nhúng form, gọi API, cURL test.
Cấu hình LadiPage — từng bước tích hợp API.
Facebook Lead Ads — kết nối native hoặc qua Zapier.
Google Lead Form — webhook native.