Đổi giai đoạn cơ hội

API dùng để thay đổi giai đoạn pipeline (opportunity_status) của một cơ hội trong chiến dịch, mà không cần cập nhật toàn bộ thông tin cơ hội.

Endpoint

PUT /api/v6.1/opportunity/stage

Cách gọi API

curl --location --request PUT 'https://demo.getflycrm.com/api/v6.1/opportunity/stage' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--data-raw '{
    "campaign_code": "CD0008",
    "opportunity_code": "CH2055057",
    "opportunity_status_name": "Bán hàng"
}'

Tham số trong body

Trường	Kiểu	Bắt buộc	Mô tả
opportunity_id	integer	Có*	ID cơ hội cần đổi giai đoạn
opportunity_code	string	Có*	Mã cơ hội cần đổi giai đoạn (thay thế cho opportunity_id)
campaign_id	integer	Có*	ID chiến dịch chứa cơ hội
campaign_code	string	Có*	Mã chiến dịch chứa cơ hội (thay thế cho campaign_id)
opportunity_status	integer	Có*	ID giai đoạn mới (lấy từ API Trạng thái chiến dịch)
opportunity_status_name	string	Có*	Tên giai đoạn mới (thay thế cho opportunity_status)

Lưu ý:

• Chỉ cần cung cấp một trong hai: opportunity_id hoặc opportunity_code.
• Chỉ cần cung cấp một trong hai: campaign_id hoặc campaign_code.
• Chỉ cần cung cấp một trong hai: opportunity_status (ID) hoặc opportunity_status_name (tên).

Phản hồi mẫu

{
  "message": "Cập nhật thành công",
  "data": {
    "id": 2055057,
    "opportunity_code": "CH2055057",
    "opportunity_name": "Người liên hệ A - Khách hàng XYZ",
    "opportunity_status": 35,
    "campaign_id": 8,
    "account_id": 11973,
    "contact_id": 9753,
    "recipient": 2,
    "status": 0,
    "amount": 0,
    "probability": 0,
    "updated_at": 1751020000
  }
}

Ghi chú

• Để xem danh sách các giai đoạn hợp lệ trong chiến dịch, dùng API Trạng thái chiến dịch.
• API này chỉ cập nhật giai đoạn pipeline (opportunity_status). Để đổi trạng thái kết quả (thành công/thất bại/hủy), dùng API cập nhật cơ hội thông thường.
• Giai đoạn truyền vào phải thuộc chiến dịch được chỉ định, nếu không sẽ trả về lỗi validation.