在企业微信二次开发中,外部群消息不仅可以触发自动回复,还可以直接启动后台业务任务。
比如客户在群里发送“同步订单”“查询项目进度”,系统可能需要调用多个接口,几十秒甚至几分钟后才能完成。
如果任务执行期间没有反馈,客户可能反复发送指令,造成接口重复调用。
通过星云API对接企业微信外部群消息,可以结合异步任务和状态管理,实现任务进度自动同步。
相关接口参考顶部星云官网卡片里的接口文档 。
一、收到消息后先创建任务
客户在外部群发送业务指令后,系统先识别消息内容,再创建独立任务。
建议记录以下信息:
| 字段 | 作用 |
|---|---|
| taskId | 任务唯一标识 |
| instanceId | 企业微信实例ID |
| roomId | 外部群ID |
| senderId | 消息发送人ID |
| status | 当前任务状态 |
| progress | 任务执行进度 |
任务创建成功后,可以先回复:
任务编号:TASK1001
当前状态:已受理
正在处理中,请稍候。
后台继续执行实际业务,不需要一直等待接口返回。
二、实时更新任务执行进度
对于批量处理任务,可以根据实际完成数量计算进度。
例如:
{
"taskId": "TASK1001",
"status": "RUNNING",
"total": 100,
"completed": 60,
"progress": 60
}
每完成一部分任务,就更新数据库或Redis中的进度信息。
如果业务系统支持进度事件,可以通过事件通知触发更新;否则可以由后台定期查询任务状态。
三、任务进度同步流程
客户在外部群发送指令
↓
接收消息并创建任务
↓
回复:任务已受理
↓
后台异步执行业务
↓
更新任务执行进度
↓
判断是否需要推送通知
↓
向原始群聊返回进度
↓
任务执行完成
↓
推送最终处理结果
例如客户提交100条订单同步任务,可以在关键节点返回:
任务编号:TASK1001
当前状态:正在处理
已完成:60/100
处理进度:60%
任务完成后,再主动发送:
任务编号:TASK1001
处理状态:已结束
成功:98条
失败:2条
这样客户不用反复发送查询指令,就能了解任务执行情况。
四、实际开发需要注意什么
1. 控制进度推送频率
不建议每处理一条数据就发送消息。可以按照25%、50%、75%、100%等关键节点推送,避免群内刷屏。
2. 防止重复创建任务
通过messageId和业务幂等键进行去重,避免重复消息导致同一任务多次执行。
3. 保证进度与任务准确关联
每次进度更新都需要绑定taskId,不能只根据客户ID或群ID更新任务状态,避免多人同时操作时出现进度混乱。
4. 处理任务超时和异常
接口超时不代表业务失败,应先确认实际执行情况,再决定是否重试或返回异常提示。
5. 区分任务状态与通知状态
业务执行成功,不代表消息已经发送成功。建议单独记录通知状态,方便发送失败后补发。
五、总结
企业微信外部群消息触发后台任务后,关键是将消息接收、任务执行和进度反馈分开处理。
通过异步任务、进度记录、关键节点通知和最终结果推送,可以减少重复请求,让客户及时了解业务处理情况。
本文介绍企业微信二次开发中,如何通过外部群消息触发异步任务并实时同步执行进度。核心包括任务创建、进度更新(基于数据库/Redis)、关键节点通知(如25%/50%/75%/100%)、防重复机制(messageId+幂等键)、进度与taskId强绑定、超时异常处理及通知状态独立管理,确保客户体验与系统稳定性。
797

被折叠的 条评论
为什么被折叠?



