EvolutionAPI中Typebot会话自动关闭问题的分析与解决

问题现象描述

在使用EvolutionAPI与Typebot集成时，用户报告了一个异常行为：当流程启动后，系统会在未完成预期交互的情况下自动关闭会话，并重新开始流程。具体表现为：

1. 在流程设计中，用户设置了两个文本框输入环节
2. 当流程执行到特定节点（如群组6）时，系统本应正常输出预设内容（如用户号码）
3. 但实际行为却是会话被意外终止，流程重新开始

环境配置

• 服务器操作系统：Ubuntu 24.04
• EvolutionAPI版本：1.7.1
• Typebot版本：Web版（官方）

根本原因分析

经过技术排查，发现该问题与EvolutionAPI的会话保持机制有关。在默认配置下，系统没有明确设置Typebot会话的保持参数，导致会话在特定条件下被系统自动回收。

解决方案

要解决此问题，需要在EvolutionAPI的配置中添加以下关键参数：

TYPEBOT_KEEP_OPEN=true

这个参数明确指示系统保持Typebot会话处于打开状态，直到流程自然结束或用户主动终止。该配置应添加在EvolutionAPI的环境变量或配置文件中，而非Typebot本身的设置中。

配置注意事项

1. 除了上述关键参数外，EvolutionAPI中与Typebot相关的其他常见配置还包括：

   • WEBHOOK_EVENTS_TYPEBOT_START
   • WEBHOOK_EVENTS_TYPEBOT_CHANGE_STATUS

2. 对于使用Web版Typebot的用户，需要特别注意这些配置是应用在EvolutionAPI端，而非Typebot平台本身。

3. 建议在修改配置后：

   • 重启EvolutionAPI服务使配置生效
   • 监控系统日志确认新配置已正确加载
   • 进行完整的端到端测试验证问题是否解决

最佳实践建议

1. 对于生产环境中的Typebot集成，建议始终设置TYPEBOT_KEEP_OPEN参数为true，除非有明确的会话管理需求。

2. 定期检查EvolutionAPI的更新日志，关注与Typebot集成相关的新功能和配置选项。

3. 在复杂流程设计中，可以考虑添加会话状态监控机制，以便及时发现和诊断类似的会话异常问题。

通过正确配置这些参数，可以确保Typebot会话在整个流程执行期间保持稳定，避免意外中断和重新开始的情况发生。