SaleHay Docs

Appearance

🔌 API Reference - Tích Hợp ​

Thông tin nhanh

  • Base URL: https://api.salehay.com
  • Xác thực API Nội bộ (Admin): Mọi endpoint GET/POST /api/leads, /api/queue/... yêu cầu gửi kèm JWT Token thông qua Header Authorization: Bearer <TOKEN>.
  • Xác thực API Công khai (Public): Dùng cho hệ thống ngoài, truyền header X-API-Key.
  • Response luôn trả về định dạng application/json.

1. Mở Cổng Nhận Lead (Public Endpoint) ​

Tạo Lead mới trên CRM từ các hệ thống bên ngoài (như Landing Page, Chatbot) mà không cần đăng nhập session Admin. Bạn chỉ cần truyền một API Key hợp lệ.

Endpoint: POST /api/public/leads

Tham Số Quan TrọngKiểuBắt buộcDiễn giải
phoneStringCÓSố điện thoại của Lead.
nameStringKhôngTên khách hàng (nếu trống sẽ lấy mặc định là Khách mới).
utm_sourceStringKhôngNguồn quảng cáo. VD: fb_ads, google_search.
click_idsObjectKhôngLưu trữ mã tracking như fbclid hay gclid. VD: {"fbclid": "..."}.
sourceStringKhôngKênh tương tác (Mặc định: website).

Ví dụ gọi API (cURL): ​

bash
curl -X POST https://api.salehay.com/api/public/leads \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_<KÈM_API_KEY_CỦA_BẠN>" \
  -d '{
    "phone": "0999888777",
    "name": "Test Lead",
    "source": "facebook",
    "utm_source": "fb_ads"
}'

Kết quả trả về thành công:

json
{
  "ok": true,
  "lead_id": "9xxyz...",
  "customer_id": "00xyz..."
}

2. Đo lường UTM tự động bằng Tracking Snippet ​

Chỉ cần gắn thẻ script này vào thẻ <head> của Landing Page. Script này sẽ tự động bắt toàn bộ tham số UTM hoặc mã click (fbclid, gclid) từ URL, lưu vào Local Storage. Khi khách để lại thông tin, các dữ liệu tracking này được tự động bóc tách và gửi kèm qua CRM.

html
<script src="https://api.salehay.com/tracking.min.js" data-api-key="<MÃ_API_KEY_CỦA_BẠN>"></script>

Mẹo dev: Bạn có thể kiểm tra dữ liệu Tracking đang được lưu trữ trên trình duyệt bằng cách gọi lệnh sau ở Console: window.SaleHayCRM.getTracking().

SaleHay CRM Documentation

© 2026 SaleHay