Chuyển tới nội dung chính

Tạo mới chiến dịch

Endpoint

POST /api/v6.1/campaign

Ví dụ yêu cầu

curl --location 'https://demo.getflycrm.com/api/v6.1/campaign' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: ADP8QgZR2f0dd6ryjfrXQhtM38Z7MP' \
--header 'Cookie: v6_getflycrm_session=utvHrfLkNPOhNIF34iyKhtbCqpRf2Ji2CGCUlYBJ' \
--data '{
"campaign_name": "Chiến dịch nhìn ngày nhìn mưa vội vàng",
"campaign_code": "YEUDI",
"responsible_username": "linhvidai",
"description": "Nhìn ngày nhìn mưa vội vàng,...ai ngập tràn",
"time_registed": 0,
"auto_divide_opp": 1,
"hide_info": 0,
"is_lock": 0,
"allow_duplicate_opp": 1,
"related_users": [
{ "user_username": "linhvidai", "accept_opp": 1 },
{ "user_username": "sangkhanh", "accept_opp": 1 }
],
"opportunity_status": [
{ "status_id": 29, "name": "Đi gặp chào nhau cái", "description": "", "order": 1 },
{ "status_id": 30, "name": "Lấy đầy đủ thông tin của nhau", "description": "", "order": 2 },
{ "status_id": 31, "name": "Trò chuyện thân thiết", "description": "", "order": 3 },
{ "status_id": 32, "name": "Tham dò đối phương, chờ tín hiệu", "description": "", "order": 4 },
{ "status_id": null, "name": "Tỏ tềnh hêhehehehe", "description": "", "order": 4 }
]
}'

Trường dữ liệu yêu cầu (body JSON)

TrườngKiểuBắt buộcMô tả
campaign_namestring✔️Tên chiến dịch
campaign_codestring✔️Mã chiến dịch duy nhất
responsible_usernamestring✔️Tên đăng nhập người phụ trách
descriptionstring✖️Mô tả chiến dịch
time_registedint✖️Thời gian đăng ký (mặc định = 0)
auto_divide_oppint✖️Tự động chia cơ hội (1 = có)
hide_infoint✖️Ẩn thông tin chiến dịch (1 = có)
is_lockint✖️Khóa chiến dịch (1 = có)
allow_duplicate_oppint✖️Cho phép trùng cơ hội (1 = có)
related_usersarray✔️Danh sách người liên quan
opportunity_statusarray✔️Danh sách các bước cơ hội trong pipeline
TrườngKiểuMô tả
user_usernamestringTên đăng nhập người liên quan
accept_oppintCó nhận cơ hội không (1 = có)

Đối tượng opportunity_status

TrườngKiểuMô tả
status_idint hoặc nullID trạng thái (null nếu mới)
namestringTên bước xử lý
descriptionstringMô tả (tùy chọn)
orderintThứ tự hiển thị

Phản hồi mẫu

{
"message": "Thêm mới thành công",
"data": {
"id": 29,
"campaign_name": "Chiến dịch nhìn ngày nhìn mưa vội vàng",
"campaign_code": "YEUDI",
"description": "Nhìn ngày nhìn mưa vội vàng,...ai ngập tràn",
"responsible": 2,
"create_user": 1,
"time_registed": 0,
"auto_divide_opp": 1,
"hide_info": 0,
"is_lock": 0,
"allow_duplicate_opp": 1,
"token_api": "GQKeucYQgm",
"created_at": 1751012986,
"updated_at": 1751012986,
"topic_id": 29,
"related_users": [
{ "accept_opp": 1, "user_id": 2 },
{ "accept_opp": 1, "user_id": 1 }
],
"opportunity_status": [
{ "status_id": 29, "name": "Đi gặp chào nhau cái", "order": 1 },
{ "status_id": 30, "name": "Lấy đầy đủ thông tin của nhau", "order": 2 },
{ "status_id": 31, "name": "Trò chuyện thân thiết", "order": 3 },
{ "status_id": 32, "name": "Tham dò đối phương, chờ tín hiệu", "order": 4 },
{ "status_id": null, "name": "Tỏ tềnh hêhehehehe", "order": 4 }
]
}
}

Ghi chú

  • Nếu status_idnull, hệ thống sẽ tự tạo mới bước đó.
  • token_api là mã dùng để kết nối đến các hệ thống liên quan hoặc truy xuất nhanh chiến dịch.
  • Mỗi chiến dịch phải có ít nhất 1 người liên quan và 1 bước cơ hội.