企业微信二次开发：自动回复如何根据接口成功、失败状态返回不同内容

在企业微信二次开发中，自动回复不仅要识别客户发送的消息，还需要根据后台接口的执行结果，返回不同的业务内容。

比如客户在外部群发送“查询订单1001”，如果查询成功，就返回订单信息；如果订单不存在，则提示客户检查编号；如果接口超时，则需要告知客户正在确认结果。

通过星云API对接企业微信消息收发能力，可以结合接口状态判断和动态回复规则，实现不同执行结果的自动反馈。

相关接口参考顶部星云官网卡片里的接口文档 。

一、先区分接口执行状态

实际开发中，不能只根据HTTP状态码判断业务是否成功。

建议将接口结果统一为以下状态：

状态	处理方式
SUCCESS	返回实际业务结果
FAILED	返回对应失败原因
TIMEOUT	提示结果待确认
RETRYING	告知客户正在重试
PENDING	提示业务正在处理中

例如接口返回HTTP 200，只代表HTTP请求成功，还需要检查业务返回码和实际数据。

二、根据接口结果匹配回复模板

可以在后台建立统一的状态与回复内容映射。

const replyTemplates = {
  SUCCESS: "业务处理成功",
  FAILED: "业务处理失败，请检查提交信息",
  TIMEOUT: "处理时间较长，正在确认结果",
  RETRYING: "系统正在重新尝试处理",
  PENDING: "请求已受理，正在处理中"
};

function getReply(status) {
  return replyTemplates[status] || "暂时无法获取处理结果";
}

这些属于业务系统自定义的回复规则，并非星云API固定的接口字段。

对于订单查询、售后申请等业务，还可以结合接口返回的数据，生成更具体的回复内容。

三、自动回复处理流程

客户发送企业微信消息
        ↓
识别业务类型与参数
        ↓
调用后台业务接口
        ↓
解析接口返回结果
        ↓
判断业务执行状态
   ┌─────┼─────┐
   ↓     ↓     ↓
 成功   失败   超时
   ↓     ↓     ↓
返回结果 错误提示 状态确认
   ↓     ↓     ↓
   └─────┼─────┘
         ↓
生成对应回复内容
         ↓
发送到原始客户或群聊

例如客户发送：

查询订单1001

查询成功：

订单编号：1001
订单状态：已发货
物流状态：运输中

查询失败：

未查询到订单1001
请检查订单编号是否正确。

接口超时：

订单查询时间较长
系统正在确认处理结果，请稍后查看。

四、实际开发需要注意什么

1. 区分业务失败和接口异常

订单不存在属于业务查询结果，网络超时则属于接口异常，两者不能使用相同的回复规则。

2. 不要盲目重试

对于创建订单、提交申请等操作，接口超时不代表执行失败，需要先确认实际结果，避免重复提交。

3. 防止重复发送消息

通过messageId和taskId进行去重，并单独记录消息通知状态，避免重复回调造成多次回复。

4. 保证回复对象准确

任务创建时保存实例ID、客户ID和群ID，确保后台处理完成后，结果能够发送到正确的会话。

5. 不直接暴露内部错误

数据库异常、接口密钥错误等技术信息应保存在后台日志中，客户只需要看到对应的业务提示。

五、总结

企业微信自动回复根据接口状态返回不同内容，关键是将接口调用结果、业务执行状态和回复模板结合起来。

通过状态判断、异常分类、动态回复和任务管理，可以让客户清楚了解业务是成功、失败还是仍在处理中。