Cách tự động tạo khách hàng thông qua API & Webhooks

Tổng quan
Tự động hóa quá trình tạo khách hàng mới bằng cách đẩy dữ liệu từ hệ thống bên ngoài (như website, phần mềm thanh toán) vào Laywork.

Các bước thực hiện:

1. Vào Settings → API & Webhooks.

2. Ở phần API Keys, nhấn Generate Key và lưu lại khóa API một cách an toàn.

3. Trong Webhooks, nhấn New Webhook, chọn sự kiện Client Created, và nhập URL endpoint của bạn.

4. Từ ứng dụng bên ngoài, gửi một yêu cầu POST tới:
   https://app.laywork.com/api/clients
   với payload dạng JSON chứa các trường giống form “Add Client”, và đính kèm API key trong phần header.

5. Kiểm tra xem khách hàng mới đã hiển thị trong Customer Management → Clients chưa.

Mẹo & Thực hành tốt:

• Kiểm tra cấu trúc payload với các trường mẫu như: Salutation, Name, Email, Category,… để đảm bảo không thiếu dữ liệu.

• Sử dụng HTTPS cho endpoint và kiểm tra API key ở mỗi request để đảm bảo an toàn.

• Ghi log tất cả các webhook gửi đi và lỗi để dễ dàng xử lý sự cố.

Khắc phục sự cố / Câu hỏi thường gặp:

• 401 Unauthorized: Kiểm tra API key chính xác và còn hiệu lực.

• Khách hàng không được tạo: Xem lại log webhook để phát hiện lỗi, và kiểm tra lại cấu trúc payload.

• Khách hàng bị trùng: Sử dụng identifier duy nhất (ví dụ: email) để áp dụng cơ chế upsert thay vì luôn tạo mới.