知识中心
所有文章
帮助中心
AI客户联络中心 升级日志
API文档
AI客户联络
API接口
【新】云节点列表
话术分组
iFrame嵌套
白标接口及地址
批量查询任务拨打进度
最后更新于 2022/11/03   阅读数 118

批量查询任务拨打进度


  • 此接口【v1.2.31版本有变动】 查看变更日志

  • 方式一

  • 请求接口 agent-api/batch/task_progress

  • 请求方式 GET

  • 路由参数

参数

类型

示例

解释

必填

task_ids

array

[“2d731938-03af-4949-b318-9348217f1df3”,“289b4a84-5648-4c92-8173-6addd8359d70”]

任务id

  • 示例

    //已废弃
    {
    	"task_ids":["2d731938-03af-4949-b318-9348217f1df","289b4a84-5648-4c92-8173-6addd8359d70"] //最多10个
    } 
  • 返回结果

  {//已废弃
      "code": 200,
      "status": "success",
      "message": "批量获取任务进度成功",
      "data": [
          {
              "task_id": "2d731938-03af-4949-b318-9348217f1df3",
              "progress": {
                  "total": 54,     //任务号码总数
                  "progress": 38,  //已拨打号码数
                  "percent": 70     //百分比
              }
          },
          {
              "task_id": "289b4a84-5648-4c92-8173-6addd8359d70",
              "progress": {
                  "total": 5,
                  "progress": 0,
                  "percent": 0
              }
          }
      ]
  }

  • 方式2

  • 请求接口 /agent-api/user/{user_id}/batch/task_progress

  • 请求方式 GET

  • 参数

参数

类型

示例

解释

必填

user_id

string

ff33acc2-2e7b-46d6-8965-f3826d19bf40

用户id

task_ids

array

["2d731938-03af-4949-b318-9348217f1df","289b4a84-5648-4c92-8173-6addd8359d70"]

任务id

  • 示例

    {
    	"task_ids":["289b4a84-5648-4c92-8173-6addd8359d70"]
    }
  • 返回参数

    {
            "code": 200,
            "status": "success",
            "message": "批量获取任务进度成功",
            "data": [
                {
                    "task_id": "2d731938-03af-4949-b318-9348217f1df3",
                    "progress": {
                        "total": 54,     //任务号码总数
                        "progress": 38,  //已拨打号码数
                        "percent": 70     //百分比
                    }
                }
            ]
        }
  • 此接口跟方式1的接口区别在于,方式2的接口中传的参数task_ids中如果传了不存在的任务ID则会过滤掉不存在的任务,返回存在的任务的拨打进度,

    方式1的接口则会抛出错误,返回不存在的任务ID,不会返回任务的拨打进度。

未能解决您的问题?请联系
本篇目录

批量查询任务拨打进度