Thêm mới
Thêm mới một khách hàng
HTTP Request
POST /api/v3/account
Dữ liệu truyền sang gồm 3 phần
- account: Thông tin khách hàng (Tên, Số ĐT, Email, Giới tính, Địa chỉ, Ngày sinh, Nhóm khách hàng, Ngành kinh doanh)
- contacts: Mảng chứa thông tin người liên hệ của khác hàng đó bao gồm (Tên, Email, Số điện thoại)
- referer: Nguồn khách hàng đến từ đâu
- custom_fields: Các dữ liệu định nghĩa thêm, vui lòng tham khảo mục Custom Fields
mẹo
Dữ liệu account
bắt buộc phải nhập. Thông tin về contacts
, referer
nếu không có thì không truyền sang.
Mô tả thông tin khách hàng (account)
Parameter | Type | Default | Require | Description |
---|---|---|---|---|
account_name | string | yes | Tên khách hàng | |
phone_office | string | Số điện thoại | ||
string | ||||
gender | int | Giới tính (1: Nữ, 2: Nam) | ||
billing_address_street | string | Địa chỉ | ||
birthday | string | Ngày sinh (d/m/Y) | ||
account_type | string | Nhóm khách hàng (Nếu nhiều nhóm cách nhau bằng dấu ’,’) | ||
industry | int | Ngành kinh doanh | ||
country_id | int | Mã quốc gia | ||
province_id | int | Mã tỉnh/ TP | ||
district_id | int | Mã quận/ huyện |
Mô tả người liên hệ (contacts)
Parameter | Type | Default | Require | Description |
---|---|---|---|---|
first_name | string | yes | Tên người liên hệ | |
string | ||||
phone_home | string | Số điện thoại liên hệ, | ||
title | string | Chức vụ người liên hệ |
Mô tả người định nghĩa dự liệu truyền sang (custom_fields)
Dữ liệu được truyền sang là một mảng dữ liệu bao gồm {key: value} Trong đó
- key: là field_name trong định nghĩa dữ liệu
- value: giá trị cần lưu. Có 2 trường hợp đặc biệt cần lưu ý
mẹo
- Đối với dữ liệu thuộc dạng select thì nó là
list_option_id
- Đối với dữ liệu thuộc sang checkbox thì có 2 giá trị
(0 và 1)
tương ứng với(false, true)
Body
{
"account": {
"account_name": "GetFly CRM",
"phone_office": "0944344333",
"email": "contact@getfly.vn",
"gender": 1,
"billing_address_street": "107 Vĩnh Hưng, Hoàng Mai, Hà Nội",
"birthday": "14/12/1984",
"account_type": 1,
"industry": "2,3",
"country_id": 1,
"province_id": 1,
"district_id": 1
},
"contacts": [
{
"first_name": "Vũ Hoàng Duy",
"email": "vuhoangduy@getflycrm.com",
"phone_home": "0944344333",
"title": "Giám đốc"
},
{
"first_name": "Nguyễn Đình Đạt",
"email": "nguyendinhdat@getflycrm.com",
"phone_home": "",
"title": "Nhân viên"
}
],
"referrer": {
"utm_source": "https://getfly.vn",
"utm_campaign": "GetflyWebsite"
},
"custom_fields": {
"ngay_ky_hd": "14/12/1984",
"so_thich": 41
}
}