Thêm mới cơ hội

Endpoint

POST /api/v6.1/opportunity

Cách gọ API

curl --location 'https://linhpq.getflycrm.com/api/v6.1/opportunity' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Cookie: v6_getflycrm_session=YOUR_SESSION_TOKEN' \
--data-raw '{
    "campaign_code": "CD0008",
    "account_code": "KH/2024/119270",
    "account_name": "Tên khách hàng",
    "account_phone": "0123456789",
    "account_email": "[email protected]",
    "contact_name": "Tên người liên hệ",
    "contact_email": "[email protected]",
    "contact_phone": "0987654321",
    "recipient_username": "tennguoiduocphancong",
    "opportunity_status": 31,
    "attachment_uploads": ["4f584a73716e736d376f4f2f31756248666a75684f67535136684771544c523865395774732b586f73626a616d44424f4c373365523170586767564935424349376b614e535a435969434a6e35427753634f5946574a51617764447459704b3157555254574a5246674d673d"],
    "define_fields": {
        "text_input": "JPSKW",
        "number_input": 12,
        "text_area": "<p>hihi</p>",
        "checkbox_don": 1,
        "check_box_nhieu": [
            "cb1",
            "cb3"
        ],
        "select_don": "sl2",
        "select_nhieu": [
            "sln2",
            "sln3"
        ]
    }
}'

Tham số trong body

Trường	Kiểu	Bắt buộc	Mô tả
campaign_id	integer	Có*	ID chiến dịch liên quan
campaign_code	string	Có*	Mã chiến dịch liên quan
account_code	string	Không	Mã khách hàng nếu có sẵn
account_name	string	Có	Tên khách hàng
account_phone	string	Có	Số điện thoại khách hàng
account_email	string	Không	Email khách hàng
contact_name	string	Có	Tên người liên hệ
contact_email	string	Không	Email liên hệ
contact_phone	string	Có	Số điện thoại liên hệ
recipient_username	string	Có	Tên user nhận xử lý
opportunity_status	integer	Không	ID giai đoạn cơ hội trong chiến dịch (lấy từ API Trạng thái chiến dịch)
opportunity_status_name	string	Không	Tên giai đoạn cơ hội (thay thế cho opportunity_status)
amount	numeric	Không	Giá trị cơ hội
probability	numeric	Không	Xác suất chốt đơn (%)
est_finish_date	timestamp	Không	Ngày dự kiến hoàn thành
description	string	Không	Mô tả cơ hội
define_fields	object	Không	Các trường dữ liệu tự định nghĩa (đối với select và check box nhiều giá trị, có thể truyền giá trị hoặc ID)
attachment_uploads	array	Không	Danh sách file upload vào cơ hội

Lưu ý: Chỉ cần cung cấp một trong hai: campaign_id hoặc campaign_code để xác định chiến dịch.

Để biết danh sách các giai đoạn (opportunity_status) có trong chiến dịch, dùng API Trạng thái chiến dịch.

Phản hồi mẫu

{
  "message": "Thêm mới thành công",
  "data": {
    "id": 2055057,
    "define_fields": {
      "text_input": "JPSKW",
      "number_input": 12,
      "text_area": "<p>hihi</p>",
      "checkbox_don": 1,
      "check_box_nhieu": [
        1,
        3
      ],
      "select_don": 5,
      "select_nhieu": [
        8,
        9
      ]
    },
    "updated_at": 1751013849,
    "account_id": 11973,
    "contact_id": 9753,
    "opportunity_name": "Tên người liên hệ - Tên khách hàng",
    "recipient": 2,
    "create_user": 0,
    "campaign_id": 8,
    "amount": 0,
    "probability": 0,
    "receipt_date": 1751013849,
    "opportunity_status": 31,
    "created_at": 1751013849,
    "opportunity_code": "CH2055057"
  }
}