NXLINK AI taskCallback

任务状态回调

• URL：优先回调到API创建任务时传入的 taskCallbackUrl；如果未传，则回调到nxlink管理菜单中配置的ai agent任务状态回调地址；如果页面也未配置，则不回调
• 接口描述：接收任务状态变化的回调通知
• 请求方式：POST
• Content-Type：application/json
• 是否需要鉴权：可选（由客户自行决定）

请求参数

header参数（可选）：

参数名	类型	必选	示例值	说明
accessKey	String	否	AK-6230339248928541113-2133	用户身份标识
ts	String	否	1655710885431	请求时间戳（毫秒）
bizType	String	否	100	业务类型，固定值"100"
action	String	否	nxai	业务操作，固定值"nxai"
sign	String	否	6e9506557d1f289501d333ee2c365826	API参数签名

请求参数：

Body参数

参数名	类型	说明
taskId	String	任务id
userTaskId	String	用户自定义任务id
other	String	创建任务时传入的任务透传字段
autoFlowId	Long	机器人id
autoFlowName	String	机器人名称
taskName	String	任务名称
taskDesc	String	任务描述
taskStatus	Integer	任务状态，详见下方枚举说明
pauseReason	Integer	暂停原因，非暂停状态可能为空
taskKeep	Integer	任务是否保活，0:不保活，1:保活
startupType	Integer	启动方式，1:手动启动，2:定时启动，3:立即启动
startupAt	Long	定时启动时间戳（秒），startupType=2 时有值
shutdownAt	Long	定时停止时间戳（秒），startupType=2 时有值
routeId	String	任务选择的路由
createTs	Long	任务创建秒级时间戳
statInfo	Object	任务统计信息快照

statInfo对象

参数名	类型	说明
answerOrderCount	Integer	接通订单数，订单结束时统计
finishOrderCount	Integer	完成订单数，订单结束时统计
totalOrderCount	Integer	总订单数，导入时统计
dialedOrderCount	Integer	已拨打订单数，一个订单打完第一通电话时统计
totalCallElapsed	Integer	通话总时长，单位秒
answerCallCount	Integer	接通通话数，通话结束时统计
totalCallCount	Integer	总通话数，通话结束时统计
manualElapsed	Integer	转人工通话总时长，单位秒
manualAnswerCount	Integer	转人工接听通话数量
manualFailCount	Integer	转人工失败通话数量
createTs	Long	统计信息创建秒级时间戳
answerRate	String	接通率
dialProgress	String	外呼进度
finishRate	String	完成率
manualAnswerRate	String	人工转接成功率
avgCallDuration	Integer	平均通话时长（秒）
avgManualDuration	Integer	平均人工通话时长（秒）

任务状态(taskStatus)说明

值	说明
1	准备就绪
2	进行中
3	已完成
4	失败
5	已暂停
6	余额不足暂停

说明

1. taskStatus 与查询任务列表接口中的任务状态取值保持一致。
2. statInfo 为回调触发时刻的任务统计快照。
3. 如果客户开启了签名校验，可按标准 AI Agent OpenAPI 的 header 规则校验本回调请求。

请求body示例

body示例

{
  "taskId": "52145b00-abc9-4a87-94c2-ed1e1e42ec1c",
  "userTaskId": "EXT-TASK-202603250001",
  "other": "task-batch-20260325",
  "autoFlowId": 197,
  "autoFlowName": "快速通知",
  "taskName": "客户回访任务-0325",
  "taskDesc": "针对已下单客户进行满意度回访",
  "taskStatus": 2,
  "pauseReason": null,
  "taskKeep": 0,
  "startupType": 2,
  "startupAt": 1746583929,
  "shutdownAt": 1746670329,
  "routeId": "y29ND1X4kkCG_nC576sALEkvg3HjEqde",
  "createTs": 1746583800,
  "statInfo": {
    "answerOrderCount": 120,
    "finishOrderCount": 150,
    "totalOrderCount": 200,
    "dialedOrderCount": 180,
    "totalCallElapsed": 5320,
    "answerCallCount": 130,
    "totalCallCount": 210,
    "manualElapsed": 300,
    "manualAnswerCount": 5,
    "manualFailCount": 1,
    "createTs": 1746583800,
    "answerRate": "61.90%",
    "dialProgress": "90.00%",
    "finishRate": "75.00%",
    "manualAnswerRate": "83.33%",
    "avgCallDuration": 40,
    "avgManualDuration": 60
  }
}

返回body参数：

参数名	类型	必选	示例值	说明
code	int	是	0	返回业务码，0 表示成功
data	object	否	""	业务数据

返回参数实例

body示例

{
  "code": 0,
  "data": ""
}

错误码

值	说明
1001	Authentication failed (missing public parameters)
1002	Authentication failed (parameter error)
1003	Authentication failed (invalid signature)
1004	Authentication failed (timestamp expired)
1005	Authentication failed (insufficient authority)
20000	Business Error