Danh bạ và phân khúc

Liên hệ theo số điện thoại, thuộc tính để cá nhân hóa, phân khúc để gửi chiến dịch. Địa chỉ gốc: https://app.zapro.vn/v1.

Như Contacts của Resend, nhưng định danh bằng số điện thoại. Mỗi số là một liên hệ duy nhất trong công ty: thêm lại cùng số thì cập nhật, gộp thuộc tính. Liên hệ có unsubscribed: true không nhận chiến dịch và tin của tự động hóa; tin giao dịch gửi qua POST /v1/messages vẫn đi.

Liên hệ

POST/v1/contacts Body { "phone": "0901234567", "name": "Lan", "properties": { "dich_vu": "Gội đầu" }, "segments": ["Khách VIP"] }. Trả 201 khi tạo mới, 200 khi cập nhật. Phân khúc chưa có sẽ được tạo. Key "chỉ gửi tin" cũng gọi được, để form trên website thêm liên hệ.

GET/v1/contacts?segment=&q=&unsubscribed=&limit=&before=

GET/v1/contacts/{id hoặc số điện thoại}

PATCH/v1/contacts/{id hoặc số điện thoại} Body { "name": "…", "properties": { … }, "unsubscribed": true }.

DELETE/v1/contacts/{id hoặc số điện thoại}

Phân khúc

GET/v1/segments

POST/v1/segments Body { "name": "Khách VIP" }. Gói Miễn phí tối đa 3 phân khúc.

POST/v1/segments/{id hoặc tên}/contacts Body { "contacts": ["0901234567", "ct_…"] }, tối đa 1.000 mỗi lần.

DELETE/v1/segments/{id hoặc tên}/contacts/{liên hệ}

DELETE/v1/segments/{id hoặc tên}

Nhập CSV

Trên bảng điều khiển: Danh bạ → Nhập CSV. Cần một cột số điện thoại (phone, so_dien_thoai, sdt), có thể có cột tên (ten, ho_ten). Các cột khác thành thuộc tính.