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.
Để 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
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/imports | Tạ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ỗ
POST
https://crm-gateways.hitechcloud.vn/v1/importsKiểm thử tại chỗ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.Để 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
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/imports | Tạ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ỗ
POST
https://crm-gateways.hitechcloud.vn/v1/importsKiểm thử tại chỗ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
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.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"
}
}