登录
基础
连接微信
办公
第三方应用开发 服务端API 数据分析专区 任务管理 创建任务
创建任务
最后更新：2024/01/11
（1）通过该接口可创建一个任务，服务商数据分析专区可调用专区接口轮询是否有新任务，当查到有新任务时，数据分析专区可以执行该任务。执行成功后，数据分析专区调用专区接口标记任务完成。
（2）每个任务只能被拉取一次，若任务执行失败或者超时，需要服务商调用获取任务结果接口判断是否需要重试，若需要重试则需要重新创建一个任务
（3）任务创建成功后只保留7天
（4）同一个服务商调用该接口并发数不能超过10
权限说明
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 暂不支持 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
| 会话存档接口授权 | 需具备「会话存档接口权限」 |
请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/chatdata/specapi/create_job?access_token=ACCESS_TOKEN
{
"msg_filter": {
"msg_list": [
{
"msgid": "xxxmsgid",
"encrypt_info": {
"secret_key": "xxx"
}
},
{
"msgid": "yyymsgid",
"encrypt_info": {
"secret_key": "xxx"
}
}
]
},
"custom_id": "xxx",
"custom_data": "xxxx"
}
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 会话存档接口授权接口凭证 |
| msg_filter | 否 | 数据分析专区拉取会话内容时过滤参数 |
| msg_list | 否 | 要拉取的消息列表，最多支持1000个（若分析的消息数超过1000条，可参考任务说明方式实现），具体说明参考MsgItem。该列表可通过会话存档接口授权中的 获取会话记录 接口获取 |
| custom_id | 是 | 服务商自定义id，需保证在该服务商内全局唯一，用于去重避免创建任务超时重试生成重复的任务。最多支持128字节 |
| custom_data | 否 | 开发者自定义数据，最多支持1024个字节 |
MsgItem说明
| 参数 | 必须 | |
|---|---|---|
| msgid | 是 | 每条消息对应的msgid |
| encrypt_info | 是 | 该应用对应的该条消息的加密信息 |
| encrypt_info.secret_key | 是 | 消息密钥，对会话记录中的 encrypted_secretkey 字段进行解密得到，参考 encrypt_secretkey 解密方式 |
请求回包
{
"errcode": 0,
"errmsg": "ok",
"jobid": "xxxx"
}参数说明：
| 参数 | 说明 | |
|---|---|---|
| errcode | 错误码 | |
| errmsg | 错误描述 | |
| jobid | 任务id |
任务说明：
若需要分析的任务消息条数超过1000条，可创建多个任务，可在任务的custom_data中指定自定义数据，将多个任务拉取的消息记录合并后再执行真正分析任务。
- 创建任务
本节内容
