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.

Xem Markdown

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

MethodEndpointMô tả
GET/v1/tagsDanh sách nhãn đang dùng
POST/v1/contacts/{id}/tagsGắ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/segmentsDanh sách phân khúc
GET/v1/segments/{id}/contactsLiên hệ thuộc một phân khúc

Kiểm thử tại chỗ

POSThttps://crm-gateways.hitechcloud.vn/v1/contacts/{id}/tags

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
    }
  ]
}