EvolutionAPI中ChatWoot集成时消息状态异常问题解析

问题背景

在使用EvolutionAPI 1.7.0版本与ChatWoot进行集成时，开发人员遇到了一个关于消息状态管理的异常现象。当用户将对话标记为"已解决"后，如果同一客户再次发送新消息，系统会将对话错误地标记为"待处理"状态，而不是预期的"已打开"状态。

问题现象详细描述

在标准工作流程中，当客服人员完成一个对话并将其标记为"已解决"后，如果同一客户后续再次发起对话，系统应该自动将对话状态更新为"已打开"。然而实际观察到的行为却是：

1. 客服将对话标记为"已解决"
2. 客户发送新消息
3. 系统错误地将对话状态设为"待处理"
4. 即使管理员已在管理界面中取消勾选"开始对话为待处理"选项，问题仍然存在

问题根源分析

经过深入排查，发现问题并非出在EvolutionAPI本身，而是ChatWoot平台的配置问题。具体原因是：

在ChatWoot的后台设置中，"启用机器人"选项被意外开启。当此选项启用时，系统会将所有新对话默认设置为"待处理"状态，等待机器人或人工客服处理。这一行为覆盖了EvolutionAPI发送的状态设置。

解决方案

要解决此问题，管理员需要：

1. 登录ChatWoot管理后台
2. 导航至机器人设置部分
3. 找到"启用机器人"选项
4. 将其设置为禁用状态

完成这些步骤后，新对话将按照预期行为工作：当已解决的对话收到新消息时，系统会将其状态正确地更新为"已打开"而非"待处理"。

最佳实践建议

对于使用EvolutionAPI与ChatWoot集成的开发者和系统管理员，建议：

1. 在集成完成后，全面检查ChatWoot的所有相关设置
2. 特别注意机器人相关选项对工作流程的影响
3. 定期审核系统配置，特别是在平台更新后
4. 建立配置变更记录，便于问题追踪

总结

这次问题排查经验表明，在系统集成项目中，当出现异常行为时，排查范围不应局限于单一系统，而应考虑所有相关组件的配置和交互。特别是像ChatWoot这样的客服平台，其内置功能可能会覆盖API发送的指令。通过系统性的排查和正确的配置，可以确保EvolutionAPI与ChatWoot的集成工作如预期般顺畅运行。