Liên hệ (Contacts) — Danh sách

Liệt kê và lọc danh bạ liên hệ khách hàng cá nhân với phân trang.

Xem Markdown

Endpoint GET /v1/contacts trả về danh sách liên hệ của bạn, hỗ trợ lọc theo từ khoá, giai đoạn vòng đời, công ty và thẻ.

Endpoint

MethodEndpointMô tả
GET/v1/contactsLấy danh sách liên hệ

Tham số truy vấn (Query Parameters)

Tham sốKiểuMặc địnhMô tả
pageinteger1Số thứ tự trang
per_pageinteger20Số bản ghi mỗi trang (tối đa 100)
qstringKhôngTìm theo tên, email hoặc số điện thoại
company_idstringKhôngLọc liên hệ thuộc một công ty
lifecycle_stagestringKhônglead, prospect, customer, churned
tagstringKhôngLọc theo nhãn gắn trên liên hệ

Kiểm thử tại chỗ

GEThttps://crm-gateways.hitechcloud.vn/v1/contacts

Nhập Access Token rồi bấm Gửi thử để gọi trực tiếp crm-gateways.hitechcloud.vn. Token không được lưu lại.

Query
cURL lấy danh sách liên hệ
curl -X GET "https://crm-gateways.hitechcloud.vn/v1/contacts?lifecycle_stage=customer&per_page=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
Phản hồi (200 OK)
{
  "status": "success",
  "data": [
    {
      "id": "con_8f2a1c9d",
      "first_name": "Nguyen",
      "last_name": "Van A",
      "email": "vana@example.com",
      "phone": "0901234567",
      "company_id": "co_4b7e2f10",
      "lifecycle_stage": "customer",
      "tags": ["vip", "khu-vuc-hcm"],
      "owner_id": "usr_12",
      "created_at": "2026-09-01T08:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": {
      "total": 248,
      "per_page": 20,
      "current_page": 1,
      "last_page": 13,
      "has_more": true
    }
  }
}