Tạo nhóm danh bạ (AddContactGroup)

POSThttps://apiai.cloudfone.vn/api/Contact/AddContactGroup

Tạo mới một nhóm danh bạ trống để gom cụm các số điện thoại khách hàng theo từng phân khúc hoặc từng đợt chiến dịch. Mã ID trả về sẽ được dùng làm ContactID trong StartCampaign.

Tham số request

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả chi tiết
`ServiceCode`	string	Có	Mã dịch vụ Autocall (ví dụ: `CF-XXXXX`).
`AuthUser`	string	Có	Mã tài khoản khách hàng.
`AuthKey`	string	Có	Khóa bí mật API do ODS cấp.
`ContactGroupName`	string	Có	Tên của nhóm danh bạ cần tạo (ví dụ: `Khách hàng VIP Tháng 10`).

Ví dụ request

curl -X POST "https://apiai.cloudfone.vn/api/Contact/AddContactGroup" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceCode": "YOUR_SERVICE_CODE",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY",
    "ContactGroupName": "Khach hang VIP Thang 10"
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "data": 1006
}

Cấu trúc phản hồi

Bảng mô tả trường

Trường	Kiểu dữ liệu	Mô tả
`result`	string	Trạng thái xử lý (`success` hoặc `failed`).
`data`	number	Mã `ContactGroupID` của nhóm vừa tạo.

Lưu ý quan trọng

Liên kết chiến dịch: Mã số trả về trong data (ví dụ: 1006) chính là ContactGroupID. Mã này được truyền vào tham số ContactID khi tạo chiến dịch qua StartCampaign.
Sau khi tạo nhóm, bạn cần tiếp tục thêm danh bạ vào nhóm qua API AddContactToGroup.

Tạo nhóm danh bạ (AddContactGroup)

Tham số request

Cấu trúc phản hồi

Bảng mô tả trường

Lưu ý quan trọng

Lỗi thường gặp

Bài viết liên quan

Thêm liên hệ vào nhóm

Khởi chạy chiến dịch

Tạo nhóm danh bạ (AddContactGroup)

400 Bad Request / result: failed

Thêm liên hệ vào nhóm

Khởi chạy chiến dịch