官网友情链接 wecomapi.com企微自动化系统一定会存在失败任务。群发失败标签更新失败成员同步失败客户通知失败。很多团队已经设计了重试和补偿但一个容易被忽视的问题是补偿本身也有时效。例如客户刚进入群时欢迎语发送失败。三小时后系统恢复再补发“欢迎加入”。技术上成功业务上非常奇怪。所以企微开发API中的失败任务不能只判断“能不能重试”还需要判断“现在补还有没有价值”。WeComApi 可以作为企微API接入层提供客户、外部群、标签和消息能力。本地任务中心则为不同任务配置补偿窗口。一、补偿窗口和任务deadline的区别原任务 deadline最晚应该什么时候首次执行。补偿窗口失败以后在多久内仍然值得重新执行。两者可以相同也可以不同。二、一个具体例子入群欢迎首次计划立即。补偿窗口10分钟。超过10分钟不再发送欢迎语。但客户关系初始化、CRM同步仍然可以继续补。同一个工作流的不同步骤拥有不同窗口。三、WeComApi 在这里的位置WeComApi负责实际企微动作。业务系统负责失败以后是否继续调用。四、不同任务不同窗口群发活动通知到活动开始前。客户标签同步可以几小时甚至一天。CRM数据同步更长。群成员对账可以隔天。客户可见动作通常窗口更短。五、补偿前重新检查业务状态欢迎语失败。10分钟内准备重试。但客户已经退群。即使没过窗口也取消。时间只是第一层。还要检查当前状态。六、人工已经处理机器人售后回复失败。人工已接管。不要补。状态优先于窗口。七、失败原因也影响补偿网络超时可以补。目标不存在无需补。权限不足修复权限后是否还补要看剩余窗口。八、补偿窗口过期后的状态expired_compensation。不是 failed。这样运营知道不是技术永远失败而是现在已经不值得执行。九、内部动作和客户动作分开消息发送过期。CRM记录仍然可以补。所以工作流每个步骤单独状态。不要整个任务一起终止。十、批量群发1000目标。部分失败。补偿窗口到期以后剩余失败目标不再补。任务最终状态completed_with_expired_targets。真实反映结果。十一、账号恢复账号离线两小时。恢复后先扫描哪些补偿仍在窗口。过期任务直接结束。避免恢复时补一堆陈旧内容。十二、补偿优先级快到窗口截止的高价值任务提高优先级。但不能突破安全频控。十三、人工延长窗口某些特殊任务可以主管手动延长。记录old_deadlinenew_deadlinereason。客户可见高风险动作最好重新审核。十四、数据看板补偿任务窗口内成功过期人工延长按任务类型。可以看到哪些业务最容易错过最佳恢复时间。十五、规则版本补偿窗口策略本身也会调整。记录compensation_policy_version。历史可解释。十六、异常某类型任务大量因补偿窗口过期。说明首次执行或恢复链路太慢。需要优化系统而不是简单把窗口无限延长。十七、日志首次失败重试窗口状态变化最终取消原因。完整记录。十八、总结企微开发API的失败补偿不能只追求“最终一定执行成功”。WeComApi 可以提供企微客户、群、消息和标签能力。本地任务中心通过补偿窗口、当前业务状态、人工接管和失败分类判断失败动作现在是否还值得继续。对于客户可见消息来说几小时后执行一个已经过时的动作往往比直接不执行更糟糕。真正成熟的补偿系统不是无休止重试而是在正确的时间窗口内尽最大努力恢复超过业务价值以后明确结束。