Chi tiết nhóm danh bạ (GetContactGroupDetailList)

Tra cứu danh sách các khách hàng nằm trong một nhóm danh bạ Autocall cụ thể.

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

Lấy danh sách các liên hệ (số điện thoại, tên khách hàng) đang thuộc về một nhóm danh bạ nhất định, hỗ trợ tìm kiếm và phân trang.

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ó	Mã ID của nhóm danh bạ cần xem chi tiết.
`Key`	string	Không	Từ khóa tìm kiếm theo tên hoặc số điện thoại.
`PageIndex`	number	Không	Số thứ tự trang hiện tại (mặc định là `1`).
`PageSize`	number	Không	Số lượng bản ghi trên một trang (mặc định là `20`).

Ví dụ request

curl -X POST "https://apiai.cloudfone.vn/api/Contact/GetContactGroupDetailList" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceCode": "YOUR_SERVICE_CODE",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY",
    "ContactGroupID": 1006,
    "Key": "",
    "PageIndex": 1,
    "PageSize": 20
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "total": 150,
  "data": [
    {
      "contactId": 1052,
      "phone": "0900000000",
      "contactName": "Nguyen Van A",
      "company": "ODS JSC",
      "email": "[email protected]"
    }
  ]
}

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`).
`total`	number	Tổng số lượng liên hệ trong nhóm.
`data`	array	Danh sách thông tin chi tiết từng khách hàng trong nhóm.
`data[].contactId`	number	Mã định danh duy nhất của liên hệ.
`data[].phone`	string	Số điện thoại khách hàng.
`data[].contactName`	string	Tên định danh của liên hệ.
`data[].company`	string	Tên công ty / tổ chức.
`data[].email`	string	Địa chỉ email của liên hệ.

Lưu ý quan trọng

Kiểm tra danh bạ trước khi chạy chiến dịch: Sử dụng endpoint này để rà soát danh sách số điện thoại trong nhóm, loại bỏ các số không hợp lệ trước khi kích hoạt gọi tự động.
Phân trang: PageIndex và PageSize giúp duyệt các nhóm có số lượng liên hệ lớn (hàng nghìn số).

Chi tiết nhóm danh bạ (GetContactGroupDetailList)

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

Xóa liên hệ khỏi nhóm

Danh sách nhóm danh bạ

Chi tiết nhóm danh bạ (GetContactGroupDetailList)

400 Bad Request / result: failed

Nhóm rỗng data []

Xóa liên hệ khỏi nhóm

Danh sách nhóm danh bạ