1. Home
  2. Docs
  3. Hướng dẫn sử dụng FasterC...
  4. API
  5. Import khách hàng từ API

Import khách hàng từ API

HTTP request:

  • URL: https://demov4.fastercrm.com/api/import_from_json
  • Phương thức: POST
  • Content Type: application/json
  • Authorization: Bearer <TOKEN_API>
{
  "user_id": 1,
  "data": [
    {
      "ten_kh": "",
      "sdt": "",
      "ngay_phat_sinh": "",
      "sdt2": "",
      "nhom_kh": "",
      "trang_thai_kh": "",
      "dich_vu": "",
      "ghi_chu": "",
      "ghi_chu_2": "",
      "tinh_tp": "",
      "sinh_nhat": "",
      "gioi_tinh": "",
      "tuoi": "",
      "chi_nhanh": "",
      "dia_chi": "",
      "chien_dich": "",
      "nguon": "",
      "noi_dung": "",
      "link": "",
      "ngay_chuyen": "",
      "tg_cs_tiep_theo": "",
      "ngay_tao": "",
      "nguoi_tao": "",
      "ngay_dat_lich": "",
      "ngay_tuong_tac_gan_nhat": "",
      "ngay_goi_moi_nhat": "",
      "text": ""
    }
  ]
}

Bảng tham số

Tham sốField gốc
ten_khTên KH(Bắt buộc)
sdtSĐT(Bắt buộc)
ngay_phat_sinhNgày phát sinh (mm/dd/yyyy)
sdt2SDT2
nhom_khNhóm KH
trang_thai_khTrạng thái KH
dich_vuDịch vụ
ghi_chuGhi chú
ghi_chu_2Ghi chú 2
tinh_tpTỉnh/TP
sinh_nhatSinh nhật (mm/dd/yyyy)
gioi_tinhGiới tính
tuoiTuổi
chi_nhanhChi nhánh
dia_chiĐịa chỉ
chien_dichChiến dịch
nguonNguồn
noi_dungNội dung
linkLink
ngay_chuyenNgày chuyển (mm/dd/yyyy)
tg_cs_tiep_theoTG CS tiếp theo (mm/dd/yyyy)
ngay_taoNgày tạo (mm/dd/yyyy)
nguoi_taoNgười tạo
ngay_dat_lichNgày đặt lịch (mm/dd/yyyy)
ngay_tuong_tac_gan_nhatNgày tương tác gần nhất (mm/dd/yyyy)
ngay_goi_moi_nhatNgày gọi mới nhất
texttext

Chia khách cho phòng ban

Mỗi khách mới được chia cho từng phòng ban giống form thêm khách:

  1. Có ghi nhân viên của phòng ban trong dữ liệu (tham số bên dưới, giá trị là Email hoặc tên nhân viên) → giao đúng người đó.
  2. Phòng ban bật Nhận data tự động → chia tự động theo cấu hình chia data (tỉ lệ, khung giờ, chi nhánh, dịch vụ). Khách có chi nhánh thì chi nhánh phải bật tự động nhận Lead.
  3. Còn lại → nhân viên nhận data mặc định của phòng ban.
Phòng banTham sốChia tự động
Telesalesdepart_59Có
TVOLdepart_61Không

Mỗi lần gửi tối đa 200 khách (FasterCRM cấu hình theo gói dịch vụ). Khách trùng SĐT (cả SĐT 2) được bỏ qua và trả về trong duplicate_phones; kết quả chia nằm trong assignments.

Mẫu code PHP:

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://demov4.fastercrm.com/api/import_from_json',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"user_id": 1,
"data": [
{
"ten_kh": "",
"sdt": "",
"ngay_phat_sinh": "",
"sdt2": "",
"nhom_kh": "",
"trang_thai_kh": "",
"dich_vu": "",
"ghi_chu": "",
"ghi_chu_2": "",
"tinh_tp": "",
"sinh_nhat": "",
"gioi_tinh": "",
"tuoi": "",
"chi_nhanh": "",
"dia_chi": "",
"chien_dich": "",
"nguon": "",
"noi_dung": "",
"link": "",
"ngay_chuyen": "",
"tg_cs_tiep_theo": "",
"ngay_tao": "",
"nguoi_tao": "",
"ngay_dat_lich": "",
"ngay_tuong_tac_gan_nhat": "",
"ngay_goi_moi_nhat": "",
"text": ""
}
]
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer <TOKEN_API>'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;