在企业微信二次开发中,消息自动收发经常需要调用后台业务接口,比如订单查询、物流查询、售后处理等。
实际运行时,可能出现业务已经执行成功,但接口响应超时,导致客户迟迟收不到处理结果的情况。
如果直接重新执行业务,容易造成重复提交;如果不做后续处理,又可能导致消息漏发。
通过星云API对接企业微信消息收发能力,可以结合任务状态管理和消息补发机制,解决接口超时后的结果反馈问题。
相关接口参考顶部星云官网卡片里的接口文档 。
一、先区分两种超时情况
接口超时后,不能直接判断业务失败。
| 超时类型 | 处理方式 |
|---|---|
| 业务接口超时 | 查询实际业务执行状态 |
| 消息发送接口超时 | 核实消息是否已提交成功 |
| 第三方接口无响应 | 记录待确认状态 |
| 网络连接异常 | 根据实际情况判断是否重试 |
例如订单创建接口超时,可能订单已经创建成功,只是响应没有正常返回。
这种情况下,应该先查询订单状态,而不是直接重新创建订单。
二、建立业务任务与消息通知记录
建议分别管理业务执行状态和消息发送状态。
例如:
{
"taskId": "TASK1001",
"instanceId": "INSTANCE001",
"roomId": "ROOM001",
"businessStatus": "SUCCESS",
"notifyStatus": "PENDING",
"retryCount": 0
}
其中:
-
businessStatus:记录后台业务是否完成。 -
notifyStatus:记录结果消息是否发送。 -
retryCount:记录补发尝试次数。
这样即使消息发送失败,也不需要重新执行已经完成的业务。
三、接口超时后的结果补发流程
客户发送企业微信消息
↓
创建任务并调用业务接口
↓
判断接口是否超时
↓
查询实际业务执行状态
↓
确认业务已完成
↓
保存最终处理结果
↓
检查消息通知状态
↓
确认需要补发
↓
调用消息发送接口
↓
记录补发结果
如果业务结果仍然无法确认,应继续保留待确认状态,不能直接向客户返回成功或失败。
四、如何实现自动补发
1. 建立待发送消息队列
业务处理完成后,先生成独立的通知任务,再调用消息发送接口。
如果发送失败,可以将通知保留在待处理队列中。
2. 为消息设置唯一通知标识
例如:
notifyKey = taskId + notifyType
实际生成:
TASK1001:FINAL_RESULT
通过数据库唯一约束,避免同一个业务结果被重复创建为多个通知任务。
3. 控制补发次数
对于明确未发送成功的消息,可以设置有限次数的重试,并逐步增加重试间隔。
如果发送接口超时、结果未知,应优先通过接口支持的回执或查询能力核实,避免重复发送。
4. 保证补发目标准确
补发时直接读取原始任务保存的实例ID、客户ID和群ID,不要重新通过昵称匹配接收对象。
5. 保存完整补发日志
记录补发时间、目标会话、接口返回状态和错误原因,方便排查消息漏发问题。
五、补发结果如何通知客户
例如订单同步任务已经完成,但第一次结果通知发送失败。
系统确认需要补发后,可以向原始外部群发送:
任务编号:TASK1001
处理状态:已完成
订单总数:100条
成功:98条
失败:2条
如果任务仍在执行,则不应提前发送最终结果。
需要注意,消息发送接口返回成功通常只代表接口已受理,是否实际送达还要看接入接口是否提供相应回执。
六、总结
企业微信消息自动收发处理接口超时时,关键是将业务执行和消息通知分开管理。
通过任务状态记录、结果核实、独立通知队列和有限重试,可以减少业务重复执行,也能降低消息漏发和重复推送的风险。
本文探讨企业微信二次开发中接口超时导致消息漏发的问题,提出将业务执行与消息通知分离管理的方案。核心包括区分超时类型、建立任务与通知双状态记录、构建带唯一标识的待发送队列、设置有限重试策略、精准定位补发目标及完整日志追踪。通过星云API集成,实现可靠的结果补发与客户通知,避免重复提交与消息丢失。
251

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



