Danh sách tệp âm thanh (GetAudioList)

Tra cứu danh sách các tệp âm thanh TTS và file ghi âm đã tạo trên hệ thống Autocall.

POSThttps://apiai.cloudfone.vn/api/Audio/GetAudioList

Lấy danh sách các tệp âm thanh hiện có trong kho dữ liệu của doanh nghiệp, hỗ trợ phân trang và tìm kiếm theo tên tệp để lấy mã AudioId cấu hình cho chiến dịch.

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.
`Key`	string	Không	Từ khóa tìm kiếm theo tên tệp âm thanh.
`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/Audio/GetAudioList" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceCode": "YOUR_SERVICE_CODE",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY",
    "Key": "",
    "PageIndex": 1,
    "PageSize": 20
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "total": 5,
  "data": [
    {
      "id": 41,
      "audioName": "Loi chao CSKH",
      "type": "FPT",
      "voiceType": "female",
      "createdDate": "2026-10-13 08:30:00"
    }
  ]
}

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 file âm thanh tìm thấy.
`data`	array	Danh sách thông tin chi tiết từng tệp âm thanh.
`data[].id`	number	Mã ID tệp âm thanh (dùng trong chiến dịch Autocall).
`data[].audioName`	string	Tên định danh của tệp âm thanh.
`data[].type`	string	Loại âm thanh (`Google`, `FPT`, `VBEE`, `VTCC`, `File`).
`data[].voiceType`	string	Mã kiểu giọng đọc đã cấu hình.
`data[].createdDate`	string	Thời điểm tạo file âm thanh.

Lưu ý quan trọng

Lấy danh sách mã tệp: Sử dụng trường data[].id để gán vào thuộc tính ActionParam trong mảng Audios khi thiết lập kịch bản cuộc gọi qua API StartCampaign.
Phân trang: Sử dụng PageIndex và PageSize để duyệt toàn bộ danh sách khi kho âm thanh có nhiều tệp.

Danh sách tệp âm thanh (GetAudioList)

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

Tạo âm thanh TTS

Xóa tệp âm thanh

Danh sách tệp âm thanh (GetAudioList)

400 Bad Request / result: failed

Danh sách data rỗng []

Tạo âm thanh TTS

Xóa tệp âm thanh