Câu hỏi thường gặp

Giải đáp nhanh khi tích hợp HiTechCloud CRM: xác thực OAuth2, phân trang, webhook, nhập và xuất dữ liệu cùng các sự cố thường gặp.

Xem Markdown

Access Token sống bao lâu?

Mặc định 3600 giây (1 giờ). Hãy cache token và tự động lấy token mới trước khi hết hạn thay vì gọi /v1/oauth/token ở mỗi request.

Làm sao tránh tạo trùng liên hệ?

Gửi kèm email và tham số dedupe=true khi tạo liên hệ. Nếu email đã tồn tại, API trả về liên hệ hiện có kèm header X-Contact-Deduped: true thay vì tạo bản ghi mới.

Tôi có thể di chuyển cơ hội giữa hai pipeline không?

Có. Dùng PATCH /v1/deals/{id} và gửi cả pipeline_id lẫn stage_id mới. Giai đoạn phải thuộc pipeline đích, nếu không sẽ nhận lỗi VALIDATION_ERROR.

Webhook có thể gửi trùng không?

Có, cơ chế là at-least-once. Hãy khử trùng lặp theo id sự kiện (evt_...) và xác thực header X-CRM-Signature trước khi xử lý.

Dữ liệu Sandbox có ảnh hưởng tới Production không?

Không. Sandbox (crm-gateways-sandbox.hitechcloud.vn) hoàn toàn tách biệt; token Sandbox không gọi được Production và ngược lại.