Nhãn & Phân khúc (Tags / Segments)
Gắn nhãn cho liên hệ và tạo phân khúc động theo điều kiện lọc để phục vụ chiến dịch.
Nhãn (tag) là từ khoá tự do gắn vào liên hệ. Phân khúc (segment) là tập liên hệ được định nghĩa bằng điều kiện lọc và tự cập nhật khi dữ liệu thay đổi.
Endpoints
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/tags | Danh sách nhãn đang dùng |
POST | /v1/contacts/{id}/tags | Gắn nhãn cho một liên hệ |
DELETE | /v1/contacts/{id}/tags/{tag} | Gỡ nhãn khỏi liên hệ |
GET | /v1/segments | Danh sách phân khúc |
GET | /v1/segments/{id}/contacts | Liên hệ thuộc một phân khúc |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}/tagsKiểm thử tại chỗGửi thử sẽ gắn nhãn thật cho liên hệ. Token không được lưu lại.
Tham số đường dẫn
Body
cURL gắn nhãn cho liên hệ
curl -X POST "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d/tags" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "tags": ["vip", "khu-vuc-hcm"] }'Phản hồi phân khúc (GET /v1/segments)
{
"status": "success",
"data": [
{
"id": "seg_vip_hcm",
"name": "Khach VIP HCM",
"filter": { "tags": ["vip"], "lifecycle_stage": "customer" },
"contact_count": 42
}
]
}Nhãn (tag) là từ khoá tự do gắn vào liên hệ. Phân khúc (segment) là tập liên hệ được định nghĩa bằng điều kiện lọc và tự cập nhật khi dữ liệu thay đổi.
Endpoints
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/tags | Danh sách nhãn đang dùng |
POST | /v1/contacts/{id}/tags | Gắn nhãn cho một liên hệ |
DELETE | /v1/contacts/{id}/tags/{tag} | Gỡ nhãn khỏi liên hệ |
GET | /v1/segments | Danh sách phân khúc |
GET | /v1/segments/{id}/contacts | Liên hệ thuộc một phân khúc |
Kiểm thử tại chỗ
POST
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}/tagsKiểm thử tại chỗGửi thử sẽ gắn nhãn thật cho liên hệ. Token không được lưu lại.
Tham số đường dẫn
Body
cURL gắn nhãn cho liên hệ
curl -X POST "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d/tags" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "tags": ["vip", "khu-vuc-hcm"] }'Phản hồi phân khúc (GET /v1/segments)
{
"status": "success",
"data": [
{
"id": "seg_vip_hcm",
"name": "Khach VIP HCM",
"filter": { "tags": ["vip"], "lifecycle_stage": "customer" },
"contact_count": 42
}
]
}