EvolutionAPI与Chatwoot集成问题分析与解决方案

问题背景

在使用EvolutionAPI与Chatwoot进行集成时，开发者遇到了消息无法正常接收的问题。具体表现为：虽然能够成功建立连接并发送初始消息，但后续消息无法在Chatwoot界面中显示。系统日志显示存在"Error in createConversation: TypeError: Cannot read properties of undefined (reading 'status')"的错误。

问题分析

经过多位开发者的测试和验证，发现该问题主要与Chatwoot版本和配置方式有关。核心问题点包括：

1. 版本兼容性问题：Chatwoot 4.0.4版本存在显示问题，虽然消息实际上已接收，但不会出现在对话列表中。

2. 云服务与自建服务的差异：使用Chatwoot云服务时问题更难以解决，而自建服务则相对容易配置成功。

3. 配置顺序问题：正确的集成配置顺序对功能实现至关重要。

解决方案

版本降级方案

多位开发者证实，将Chatwoot从4.0.4版本降级到4.0.1版本可以解决此问题。降级后，消息能够正常显示在对话列表中。

自建服务方案

对于使用Chatwoot云服务遇到问题的开发者，可以考虑自建Chatwoot服务。自建环境通常具有更好的可控性，能够更方便地进行调试和问题排查。

正确配置流程

1. 首先配置EvolutionAPI服务
2. 在Chatwoot中创建收件箱
3. 将收件箱与EvolutionAPI连接
4. 最后扫描即时通讯应用二维码完成连接

使用SQS集成

部分开发者发现，启用SQS(Simple Queue Service)集成可以改善消息传递的可靠性。这需要创建新的集成配置并确保SQS功能处于激活状态。

技术建议

1. 日志监控：同时监控EvolutionAPI和Chatwoot的日志，可以更准确地定位问题所在。

2. 分步测试：建议采用分步测试方法，先验证基础连接，再测试消息收发功能。

3. 环境一致性：确保测试环境和生产环境的一致性，避免因环境差异导致的问题。

4. 备份与回滚：在进行任何版本变更前，做好系统备份，以便快速回滚到稳定状态。

总结

EvolutionAPI与Chatwoot的集成问题主要源于版本兼容性和配置顺序。通过版本控制、正确的配置流程和环境选择，大多数开发者能够成功解决消息接收问题。对于关键业务系统，建议采用自建服务方案以获得更好的可控性和稳定性。