Danh sách hành động phím bấm (GetListAction)

Lấy danh mục các hành động rẽ nhánh IVR khi khách hàng bấm phím trong chiến dịch Autocall.

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

Tra cứu danh sách các mã hành động (Action codes) được hỗ trợ trên hệ thống tổng đài để cấu hình cho tham số Keypress khi tạo chiến dịch Autocall (ví dụ: chuyển tiếp gặp tổng đài viên, nghe lại thông báo, gọi API, kết thúc cuộc gọi).

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/GetListAction" \
  -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": [
    {
      "actionId": "1",
      "actionName": "Phát thông báo âm thanh"
    },
    {
      "actionId": "2",
      "actionName": "Chuyển tiếp đến số máy nhánh"
    },
    {
      "actionId": "3",
      "actionName": "Chuyển tiếp vào nhóm tổng đài viên"
    },
    {
      "actionId": "4",
      "actionName": "Nghe lại nội dung hướng dẫn"
    },
    {
      "actionId": "5",
      "actionName": "Gọi Webhook API của khách hàng"
    }
  ]
}

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 hành động cấu hình phím bấm khả dụng.
`data[].actionId`	string	Mã ID của hành động (dùng điền vào `Action` trong mảng `Keypress`).
`data[].actionName`	string	Tên mô tả hành động nghiệp vụ trên hệ thống.

Lưu ý quan trọng

Áp dụng trong kịch bản IVR: Khi gọi API StartCampaign, các giá trị actionId trả về từ API này sẽ được gán vào trường Action tương ứng với từng phím bấm Key (từ 0 đến 9, *, #).

Danh sách hành động phím bấm (GetListAction)

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 hành động phím bấm (GetListAction)

400 Bad Request / result: failed

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

Tạo âm thanh TTS