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
email	string			Email
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ệ
email	string			Email
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": "[email protected]",
    "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": "[email protected]",
      "phone_home": "0944344333",
      "title": "Giám đốc"
    },
    {
      "first_name": "Nguyễn Đình Đạt",
      "email": "[email protected]",
      "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
  }
}