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.
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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/contacts | Lấy danh sách liên hệ |
Tham số truy vấn (Query Parameters)
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
page | integer | 1 | Số thứ tự trang |
per_page | integer | 20 | Số bản ghi mỗi trang (tối đa 100) |
q | string | Không | Tìm theo tên, email hoặc số điện thoại |
company_id | string | Không | Lọc liên hệ thuộc một công ty |
lifecycle_stage | string | Không | lead, prospect, customer, churned |
tag | string | Không | Lọc theo nhãn gắn trên liên hệ |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/contactsKiểm thử tại chỗ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
}
}
}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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/contacts | Lấy danh sách liên hệ |
Tham số truy vấn (Query Parameters)
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
page | integer | 1 | Số thứ tự trang |
per_page | integer | 20 | Số bản ghi mỗi trang (tối đa 100) |
q | string | Không | Tìm theo tên, email hoặc số điện thoại |
company_id | string | Không | Lọc liên hệ thuộc một công ty |
lifecycle_stage | string | Không | lead, prospect, customer, churned |
tag | string | Không | Lọc theo nhãn gắn trên liên hệ |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/contactsKiểm thử tại chỗ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
}
}
}