API nhận data khách hàng mới

Download Postman example PEROB CRM-ADS.postman_collection.json

Là API dùng cho việc nhận thông tin khách hàng từ các nguồn quảng cáo hoặc đối tác quảng cáo.

Lưu ý, khi gửi data vào CRM, data sẽ được xử lý theo các bước như sau:

1. Bước 1. Lấy thông tin UTM từ trường link nếu lấy được thông tin UTM thì bỏ qua bước 2, thực hiện bước 3.
2. Bước 2. Lấy thông tin UTM từ các trường utm_* mà API nhận được.
3. Bước 3. Tìm Chiến dịch marketing tương ứng với các UTM lấy được sau 2 bước trên.
   1. Nếu tìm thấy chiến dịch marketing gắn chiến dịch và Nguồn marketing của chiến dịch đó cho data khách hàng. Thực hiện bước 5.
   2. Nếu không tìm thấy chiến dịch marketing tương ứng thì thực hiện bước 4.
4. Bước 4. Tạo chiến dịch marketing mới với các thông tin utm fields ở bước 2 và sản phẩm tương ứng với mã sản phẩm trong CRM.
5. Bước 5.
   1. Nếu thông tin khách hàng chưa tồn tại trong hệ thống với label L0 thì trả response thành công và hiển thị thông tin khách hàng trong danh sách khách hàng tiềm năng với label L0.
   2. Nếu thông tin khách hàng đã tồn tại trong hệ thống cũng với label L0 thì sẽ trả response thông báo lỗi trùng lặp dữ liệu, không tạo mới.

• Request:

POST /crm/v1/single_product_potential_customers/ HTTP/1.1

• Headers:

Authorization: Token {{API_TOKEN}}

Content-Type: application/json

• Data:

{
"name": "Nguyen Van Test",
"phone": "0999999990",
"product_code": "ich-mau",
"reference_id": "reference_id",
"form_id": "form_id",
"address": "address",
"message": "this is test phone number, do not call",
"note": "note",
"extra1": "extra11",
"extra2": "extra12",
"extra3": "extra13",
"link": "http://tinhhau.tinhhaubienob.info/?utm_source=utm_source5&utm_medium=utm_medium&utm_campaign=utm_campaign&utm_content=utm_content&fid=fid1",
"utm_content": "utm_content (option)",
"utm_campaign": "utm_campaign (option)",
"utm_source": "utm_source (option)",
"utm_medium": "utm_medium (option)"
}

• Mô tả tham số

• Response:
  • Thành công:

{
"success": true,
"data": {
"created_ids": [7528]
}
}

{
"success": false,
"error_message": "{\"non_field_errors\": [\"Khách hàng này đã tồn tại\"]}"
}

{
"success": false,
"error_message": "Thông báo lỗi"
}