Danh sách đầu số Trunk (GetTrunkList)

Lấy danh sách các đầu số SIP Trunk của khách hàng để cấu hình gọi ra cho chiến dịch Autocall.

POSThttps://apiai.cloudfone.vn/api/Autocall/GetTrunkList

Tra cứu danh sách các đầu số SIP Trunk đã đăng ký và gán quyền cho gói dịch vụ Autocall của doanh nghiệp. Giá trị tên Trunk nhận được từ API này sẽ được điền vào tham số Trunk khi tạo chiến dịch qua 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.

Ví dụ request

curl -X POST "https://apiai.cloudfone.vn/api/Autocall/GetTrunkList" \
  -H "Content-Type: application/json" \
  -d '{
    "ServiceCode": "YOUR_SERVICE_CODE",
    "AuthUser": "YOUR_AUTH_USER",
    "AuthKey": "YOUR_AUTH_KEY"
  }'

Response mẫu

{
  "result": "success",
  "message": "",
  "data": [
    {
      "trunkName": "CF-BS0000003",
      "phoneNumber": "02873007788",
      "telco": "ODS"
    }
  ]
}

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`	array	Danh sách các Trunk gọi ra khả dụng của khách hàng.
`data[].trunkName`	string	Tên định danh của Trunk (dùng để điền vào trường `Trunk` khi tạo chiến dịch).
`data[].phoneNumber`	string	Số điện thoại hiển thị khi gọi ra tới khách hàng.

Lưu ý quan trọng

Áp dụng Trunk chính xác: Tên Trunk trả về (ví dụ: CF-BS0000003) phải được truyền chính xác vào trường Trunk của API StartCampaign.
Quyền hạn đầu số: Đảm bảo đầu số Trunk đã được khai báo và cấp hạn mức số cuộc gọi đồng thời (Concurrent Calls) tương ứng với quy mô chiến dịch.

Danh sách đầu số Trunk (GetTrunkList)

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

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

Tạo âm thanh TTS

Danh sách đầu số Trunk (GetTrunkList)

400 Bad Request / result: failed

Danh sách data rỗng []

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

Tạo âm thanh TTS