任务状态变更回调
更新时间：2026-07-16
描述
当任务状态变更后，外呼系统通过用户配置的回调地址将任务状态变更的数据进行回调。
动态鉴权签名生成规则 动态鉴权签名生成规则
URL
回调地址（配置台-API配置-其他配置）
HTTP Method
POST
请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| appid | string | 否 | 动态鉴权，appid（回调类型为动态鉴权传送） | APP001 |
| timestamp | string | 否 | 动态鉴权，签名生成时间（回调类型为动态鉴权传送） | 20260703102050 |
| nonce | string | 否 | 动态鉴权，参与签名生成的uuid（回调类型为动态鉴权传送） | a63de7dbff914f61b2169d53d9963806 |
| signature | string | 否 | 动态鉴权生成的签名（回调类型为动态鉴权传送 详情查看动态鉴权生成规则) | 088de95fb5fe8fc3c19a452d1c3f0e74744d578a77ca26640cf41197bd36c1cf |
| callbackType | int | 是 | 回调数据类型， 0-任务呼叫单通电话回调 1-号码组终态回调 2-任务状态变更回调 3-实时呼叫单通电话回调 | 2 |
| data | obj | 是 | 回调数据 |
data数据
| 参数名称 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| tenantId | long | 是 | 租户唯一标识 | 10363 |
| taskId | long | 是 | 任务标识 | "732721695686912" |
| taskStatus | int | 是 | 任务状态 1-待启动 2-执行中 3-已暂停 4-已完成 | 2 |
| updateTime | string | 是 | 更新时间 | "2021-03-29 12:15:36" |
| reason | string | 是 | 状态变更原因，如：系统进入禁呼时段 系统进入呼叫时段 手动启动任务 手动暂停任务 手动终止任务 账号欠费 无可用主叫号码 系统异常已暂停 任务已呼叫完成 任务已到期 | "手动启动任务" |
响应参数
| 名称 | 类型 | 备注 |
|---|---|---|
| code | int | http响应码，比如200、400 |
| msg | string | 响应信息，成功为success，失败时为具体原因 |
请求（回调）示例
Javascript
1 {
2 "signature": "088de95fb5fe8fc3c19a452d1c3f0e74744d578a77ca26640cf41197bd36c1cf", // 动态鉴权模式传送：签名
3 "appid": "APP001", // 动态鉴权模式传送：签名 appid
4 "nonce": "a63de7dbff914f61b2169d53d9963806", // 动态鉴权模式传送：参与签名生成的uuid
5 "timestamp": "20260703102050", // 动态鉴权模式传送：签名生成时间
6 "callbackType": 2,// 0-api单通电话回调 1-号码组终态回调 2-任务状态变更回调 3-实时任务通话记录回调
7 "data": {
8 "tenantId": 10363, // 租户id
9 "taskId":"1231234325", // 任务id
10 "taskStatus": 2, // 任务状态 1-待启动 2-执行中 3-已暂停 4-已完成
11 "reason": "手动启动任务", // 原因 系统进入禁呼时段 系统进入呼叫时段 手动启动任务 手动暂停任务 手动终止任务 账号欠费 无可用主叫号码 系统异常已暂停 任务已呼叫完成 任务已到期
12 "updateTime": "2021-03-29 12:15:36" // 更新时间
13 }
14 }返回（回调）示例
Javascript
1{
2 "code": 200,
3 "msg": "success",
4}评价此篇文章