Nhập dữ liệu (Import)

Nhập dữ liệu vào HiTechCloud CRM: tải hàng loạt liên hệ và công ty từ tệp CSV qua tác vụ nền (job) bất đồng bộ, theo dõi tiến độ qua API.

Xem Markdown

Để nhập khối lượng lớn, hãy tải lên tệp CSV và theo dõi tiến độ qua tác vụ nền. Hệ thống sẽ ánh xạ cột và báo cáo số dòng thành công/thất bại.

Endpoints

MethodEndpointMô tả
POST/v1/importsTạo tác vụ nhập từ CSV (multipart)
GET/v1/imports/{id}Theo dõi tiến độ tác vụ nhập

Kiểm thử tại chỗ

POSThttps://crm-gateways.hitechcloud.vn/v1/imports

Gửi thử sẽ ghi dữ liệu thật trên môi trường được chọn. Nên thử trên Sandbox trước. Token không được lưu lại.

Body
cURL tạo tác vụ nhập
curl -X POST "https://crm-gateways.hitechcloud.vn/v1/imports" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@contacts.csv" \
  -F "entity=contact"
Phản hồi (202 Accepted)
{
  "status": "success",
  "data": {
    "id": "imp_55aa22bb",
    "entity": "contact",
    "state": "processing",
    "total_rows": 1200,
    "processed": 0,
    "created_at": "2026-10-31T11:00:00+07:00"
  }
}
Khi tác vụ hoàn tất, hệ thống phát webhook import.completed (nếu đã đăng ký) và state chuyển thành completed kèm số dòng succeeded/failed.