查询外呼任务详情（QueryOutboundTaskDetail）-服务数字员工(Outbound AI employee)-阿里云帮助中心

前提条件

已安装SDK。
已获取并使用AccessKey的方式，请参考获取AccessKey并配置到环境变量。
已获取TaskId（任务ID）。调用CreateOutboundTask创建外呼任务时，从返回参数Data.TaskId获取；或调用QueryOutboundTaskList查询已有任务列表获取。

请求参数

名称	类型	必填	描述	示例值
Action	String	是	要执行的操作。取值：QueryOutboundTaskDetail。	QueryOutboundTaskDetail
Version	String	是	API版本号。格式为：YYYY-MM-DD。取值：2025-11-27。	固定为2025-11-27
TaskId	Number	是	任务 ID	1

响应参数

名称	类型	描述	示例值
RequestId	String	请求ID。	xxxx-xxxx-xxxx
Success	Boolean	请求是否成功。	True
Code	String	错误码。请求成功时为空。	None
Message	String	错误信息或成功提示。	操作成功
Data	Object	返回数据，包含TaskId, TaskName, SceneId, SceneName, CustomerListId, CustomerListName, TaskStatus, Concurrency, StartDate, EndDate, StartTime, EndTime, TaskDesc, TotalCustomers, CalledCount, SuccessCount, FailedCount, GmtCreate, GmtModified等字段，具体说明请参见下方Data节点参数说明。

使用示例

Python

import json
import os
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_tea_openapi.client import Client as OpenApiClient
from alibabacloud_tea_util import models as util_models
from alibabacloud_openapi_util.client import Client as OpenApiUtilClient


def main():
    config = open_api_models.Config(
        access_key_id=os.getenv("ACCESS_KEY_ID"),
        access_key_secret=os.getenv("ACCESS_KEY_SECRET"),
    )
    config.endpoint = "thirdswaicall.aliyuncs.com"
    config.protocol = "HTTPS"
    client = OpenApiClient(config)

    params = open_api_models.Params(
        style="RPC",
        version="2025-11-27",
        action="QueryOutboundTaskDetail",
        method="POST",
        pathname="/",
        protocol="HTTPS",
        auth_type="AK",
        req_body_type="json",
        body_type="json",
    )

    body = {'TaskId': 1}

    request = open_api_models.OpenApiRequest(query=OpenApiUtilClient.query(body))
    runtime = util_models.RuntimeOptions(autoretry=True, max_attempts=3)
    try:
        resp = client.call_api(params, request, runtime)
        print(json.dumps(resp.get("body", {}), ensure_ascii=False, indent=2))
    except Exception as e:
        print(f"调用失败: {e}")


if __name__ == "__main__":
    main()

Java

import com.aliyun.teaopenapi.Client;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teaopenapi.models.OpenApiRequest;
import com.aliyun.teaopenapi.models.Params;
import com.aliyun.teautil.models.RuntimeOptions;
import com.google.gson.Gson;

import java.util.HashMap;
import java.util.Map;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 初始化配置
        Config config = new Config()
            .setAccessKeyId(System.getenv("ACCESS_KEY_ID"))
            .setAccessKeySecret(System.getenv("ACCESS_KEY_SECRET"))
            .setEndpoint("thirdswaicall.aliyuncs.com")
            .setProtocol("HTTPS");

        Client client = new Client(config);

        // 设置 API 参数
        Params params = new Params()
            .setStyle("RPC")
            .setVersion("2025-11-27")
            .setAction("QueryOutboundTaskDetail")
            .setMethod("POST")
            .setPathname("/")
            .setProtocol("HTTPS")
            .setAuthType("AK")
            .setReqBodyType("json")
            .setBodyType("json");

        // 构建请求参数
        Map<String, Object> body = new HashMap<>();
        body.put("TaskId", 1);

        OpenApiRequest request = new OpenApiRequest()
            .setQuery(com.aliyun.openapiutil.Client.query(body));

        // 设置运行时选项（自动重试）
        RuntimeOptions runtime = new RuntimeOptions()
            .setAutoretry(true)
            .setMaxAttempts(3);

        try {
            // 调用 API
            Map<String, ?> response = client.callApi(params, request, runtime);
            Gson gson = new Gson();
            System.out.println(gson.toJson(response.get("body")));
        } catch (Exception e) {
            System.err.println("调用失败: " + e.getMessage());
        }
    }
}

返回示例

{
  "Success": true,
  "Code": null,
  "Message": "操作成功",
  "RequestId": "xxxx-xxxx-xxxx",
  "Data": {
    "TaskId": 1,
    "TaskName": "春节促销外呼任务",
    "SceneId": 100,
    "SceneName": "促销通知场景",
    "CustomerListId": 200,
    "CustomerListName": "VIP客户名单",
    "TaskStatus": "RUNNING",
    "Concurrency": 10,
    "StartDate": "2025-01-15",
    "EndDate": "2025-01-31",
    "StartTime": "09:00",
    "EndTime": "18:00",
    "TaskDesc": "春节期间促销活动外呼",
    "TotalCustomers": 1000,
    "CalledCount": 500,
    "SuccessCount": 300,
    "FailedCount": 200,
    "GmtCreate": "2025-01-10 10:00:00",
    "GmtModified": "2025-01-15 14:30:00"
  }
}

具体的处理结果在Data节点中，以下为Data节点的参数说明。

名称	类型	描述	示例值
TaskId	Number	任务ID	1
TaskName	String	任务名称	春节促销外呼任务
SceneId	Number	场景ID	100
SceneName	String	场景名称	促销通知场景
CustomerListId	Number	客户名单ID	200
CustomerListName	String	客户名单名称	VIP客户名单
TaskStatus	String	任务状态	RUNNING
Concurrency	Number	并发数	10
StartDate	String	开始日期	2025-01-15
EndDate	String	结束日期	2025-01-31
StartTime	String	每日开始时间	09:00
EndTime	String	每日结束时间	18:00
TaskDesc	String	任务描述	春节期间促销活动外呼
TotalCustomers	Number	客户总数	1000
CalledCount	Number	已呼叫数	500
SuccessCount	Number	成功数	300
FailedCount	Number	失败数	200
GmtCreate	String	创建时间	2025-01-10 10:00:00
GmtModified	String	修改时间	2025-01-15 14:30:00

错误信息

如果执行报错，请参考错误信息进行解决。