Tạo khách hàng
Scope yêu cầu: customer:write. Agent gắn với key cần quyền tạo (crm.customer → create). Response chỉ trả về customerId vừa tạo — gọi Chi tiết khách hàng để lấy đầy đủ dữ liệu.
Headers
Request
Mã giai đoạn hành trình — tenant có thể tự cấu hình (xem Cấu hình khách hàng → Hành trình). Mẫu mặc định: subscriber (Đăng ký), lead (Tiềm năng), qualifiedLead (Đủ điều kiện), opportunity (Cơ hội bán hàng), official (Chính thức), evangelist (Trung thành), other (Khác).
Mã trạng thái khách hàng — tenant có thể tự cấu hình (xem Cấu hình khách hàng → Trạng thái). Tuỳ chọn khi tạo mới — bỏ trống sẽ lấy trạng thái đầu tiên theo cấu hình của tenant. Mẫu mặc định: active (Hoạt động), inactive (Không hoạt động), atRisk (Rủi ro), lost (Rời bỏ).
Định dạng E.164.
Mã giá trị lựa chọn của thuộc tính Giới tính.
Mã giá trị lựa chọn của thuộc tính Nguồn khách hàng.
Ghi chú.
Thuộc tính tuỳ chỉnh của tenant, khoá theo fieldCode (mã thuộc tính — không phải slot lưu trữ nội bộ valueKey). Mã không tồn tại hoặc gửi thẳng slot thô → 422 CUSTOMER_ATTRIBUTE_UNKNOWN.
uid của agent phụ trách. Bỏ trống khi tạo mới = khách hàng chưa gán cho ai (key của agent có phạm vi dữ liệu MINE/GROUP sau đó sẽ không đọc lại được khách hàng này).
Mã tham chiếu ngoài.
Response
Đã tạo — {customerId, success}.