Chuyển đổi khách hàng tiềm năng thành giao dịch thông qua API

Tổng quan:
Xây dựng các tích hợp tùy chỉnh hoặc script để chuyển đổi các lead thành các deal một cách tự động thông qua REST API của Laywork.

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

1. Lấy API token tại Profile → API Keys.

2. Lấy thông tin của lead bạn muốn chuyển đổi bằng lệnh GET:
   GET /api/v1/lead-contacts/{lead_id}.

3. Gửi một yêu cầu POST đến /api/v1/deals với payload dạng JSON, ánh xạ các trường từ lead vào deal như sau:

{
  "lead_id": "123",
  "name": "Deal for John Doe",
  "pipeline_id": 1,
  "stage_id": 2,
  "value": 5000,
  "close_date": "2025-06-30"
}

4. Tùy chọn: gọi PATCH để cập nhật trạng thái của lead thành “Converted”:

PATCH /api/v1/lead-contacts/{lead_id}

5. Kiểm tra xem deal đã xuất hiện trong Leads → Deals và lịch sử của lead có hiển thị việc chuyển đổi hay không.

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

• Sử dụng quy ước đặt tên nhất quán cho tên các deal (ví dụ: “LeadName – Products”) để dễ dàng tham chiếu.

• Xử lý lỗi API (ví dụ: thiếu trường dữ liệu) bằng cách ghi lại lỗi và thử lại với dữ liệu đã được sửa.

• Bảo mật API token và thay đổi token định kỳ để duy trì sự bảo mật cho tích hợp.