1. 接口说明 #

用于分页查询当前登录账号下的语音通知任务列表，支持按任务关键字、任务状态、话术类型、话术标识和手机号等维度筛选。

• 请求方式：POST

• 接口地址：https://cloud-vms.volcengineapi.com?Action=QueryTaskList&Version=2022-01-01

Header

Query

2. Body（form-data） #

2.1 State 取值说明 #

2.2 ResourceType 取值说明 #

3. 请求示例 #

{
  "Limit": 10,
  "Offset": 0,
  "Keyword": "task_202608",
  "State": [1, 3],
  "ResourceType": 1,
  "Resource": "tts_tpl_123456",
  "Phone": "13800138000"
}

4. 返回说明 #

Result.Records 中每条记录的核心字段通常包括：

5. 返回示例 #

{
  "Code": 0,
  "Message": "success",
  "Result": {
    "Limit": 10,
    "Offset": 0,
    "Total": 1,
    "Records": [
      {
        "TaskOpenId": "v_task_xxxxx",
        "Name": "8月回访任务",
        "Resource": "tts_tpl_123456",
        "ResourceType": 1,
        "ResourceName": "回访模板A",
        "State": 1,
        "StartTime": "2026-08-12 10:00:00",
        "EndTime": "2026-08-12 18:00:00",
        "ListNum": 100,
        "CalledNum": 60,
        "ThroughNum": 25,
        "ThroughRate": 0.4167,
        "FinishRate": 0.6
      }
    ]
  }
}

6. 使用说明与注意事项 #

1. Keyword 不是模糊组合搜索，而是服务端先按任务 ID 查询，未命中时再按任务名称查询。
2. Phone 查询依赖号码加密后的精确匹配；如果手机号不存在于当前账号的任务中，会直接返回空列表。
3. body实际接入时应传 {} 或完整请求体，不建议传空请求。