Tích hợp tạo Lead (CRM)

1. Tổng quan

API CRM Alohub cho phép đối tác và hệ thống bên ngoài tạo lead trực tiếp vào CRM mà không cần thao tác thủ công trên giao diện.

Thông số	Giá trị
Base URL	{{base_url}}/api — Liên hệ Alohub để nhận thông tin
Xác thực	Header Authorization: {{apiKey}}
Content-Type	application/json

2. Tạo Lead

POST /crm/lead

Tạo lead mới trong hệ thống CRM. Nếu số điện thoại đã tồn tại, hệ thống sẽ cập nhật thông tin thay vì tạo mới.

Headers

Header	Giá trị
accept	*/*
Content-Type	application/json
Authorization	{{apiKey}}

Body

{
  "phone": "0868793800",
  "email": "bang@gmail.com",
  "name": "bang do"
}

Tham số

Param	Kiểu	Bắt buộc	Mô tả
phone	string	Có	Số điện thoại khách hàng
email	string	Không	Email khách hàng
name	string	Không	Họ tên khách hàng

Định dạng số điện thoại: Hỗ trợ định dạng Việt Nam — bắt đầu bằng 0xxx (ví dụ: 0868793800) hoặc +84xxx (ví dụ: +84868793800).

Code mẫu

curl -X POST "{{base_url}}/api/crm/lead" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: {{apiKey}}" \
  -d '{
    "phone": "0868793800",
    "email": "bang@gmail.com",
    "name": "bang do"
  }'

const axios = require('axios')

const response = await axios.post(
  '{{base_url}}/api/crm/lead',
  {
    phone: '0868793800',
    email: 'bang@gmail.com',
    name: 'bang do'
  },
  {
    headers: {
      'Content-Type': 'application/json',
      'Authorization': '{{apiKey}}'
    }
  }
)

console.log(response.data)

import requests

response = requests.post(
    "{{base_url}}/api/crm/lead",
    json={
        "phone": "0868793800",
        "email": "bang@gmail.com",
        "name": "bang do"
    },
    headers={
        "Content-Type": "application/json",
        "Authorization": "{{apiKey}}"
    }
)

print(response.json())

3. Ứng dụng thực tế

Kịch bản	Mô tả
Landing page / Form đăng ký	Khi khách hàng submit form trên website, gọi API tạo lead ngay lập tức để đội sales xử lý nhanh.
Sync từ website / app	Đồng bộ dữ liệu khách hàng từ hệ thống nội bộ (ERP, e-commerce) vào CRM Alohub.
Chatbot tạo lead tự động	Khi chatbot thu thập đủ thông tin khách hàng, tự động gọi API tạo lead mà không cần nhân viên nhập tay.

4. Lưu ý quan trọng

Trùng số điện thoại: Mỗi số điện thoại chỉ tạo 1 lead duy nhất. Nếu SĐT đã tồn tại trong hệ thống, API sẽ cập nhật thông tin (email, name) thay vì tạo lead mới.

API Key: Mỗi API key được cung cấp riêng. Liên hệ Alohub để nhận API key. Mỗi key có phạm vi quyền cụ thể. Không chia sẻ API key cho bên thứ ba.

Bảo mật: Luôn gọi API từ server-side (backend). Không nhúng API key trực tiếp trong mã nguồn frontend hoặc mobile app.