API ReferenceAPI AutocallDanh bạ & Nhóm
Thêm liên hệ vào nhóm (AddContactToGroup)
Gán một hoặc nhiều liên hệ vào nhóm danh bạ Autocall.
POST
https://apiai.cloudfone.vn/api/Contact/AddContactToGroupGán danh sách các liên hệ khách hàng vào một nhóm danh bạ cụ thể để sẵn sàng cho chiến dịch gọi tự động.
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. |
ContactGroupID | number / string | Có | ID của nhóm danh bạ muốn thêm liên hệ vào. |
ContactId | array | Có | Mảng chứa danh sách các mã ContactId của khách hàng (ví dụ: ["1051", "1052"]). |
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 thực thi (success hoặc failed). |
message | string | Thông báo phản hồi từ hệ thống. |
Lưu ý quan trọng
- Thêm hàng loạt: Mảng
ContactIdhỗ trợ truyền nhiều mã liên hệ cùng lúc (ví dụ:["1051", "1052", "1053"]). - Một liên hệ có thể thuộc về nhiều nhóm danh bạ khác nhau tùy theo phân loại chiến dịch của bạn.
Lỗi thường gặp
- Sai thông tin xác thực
AuthUserhoặcAuthKey. ContactGroupIDkhông tồn tại.- Một hoặc nhiều
ContactIdtrong mảng không hợp lệ hoặc đã bị xóa.