EvolutionAPI中Typebot会话自动重启问题的分析与解决方案

问题现象描述

在EvolutionAPI与Typebot集成环境中，用户报告了一个严重影响用户体验的问题：当会话流程到达终点后，无论采取何种配置措施，Typebot都会自动重新启动会话流程。这种现象会导致会话陷入无限循环，特别是在与即时通讯应用集成时尤为明显。

问题技术背景

该问题首次出现在EvolutionAPI 1.7.0版本中，而在之前的1.6.1版本中并不存在。核心表现为：

1. 会话流程无法正常终止，即使配置了"暂停流程"或"等待"模块
2. 时间到期设置(如60分钟过期)失效
3. 问题主要出现在移动通讯应用集成场景，Web环境表现正常
4. 当会话转移到外部客服系统后，仍然会重启

根本原因分析

经过技术社区深入探讨，发现问题根源在于：

1. 会话状态管理机制变更：1.7.0版本修改了会话终止逻辑，当流程结束后EvolutionAPI会自动关闭会话
2. 新会话触发条件：任何新的用户消息都会被视为新会话的开始，而非原会话的继续
3. 环境变量配置缺失：缺少关键配置项来维持会话状态

解决方案

方案一：环境变量配置

在EvolutionAPI的环境变量中添加以下配置：

TYPEBOT_KEEP_OPEN=true

此配置会阻止API在流程结束时自动关闭会话，从而避免新消息触发新会话。

方案二：API端点调用

通过调用EvolutionAPI的会话状态变更端点，手动控制会话状态：

1. 在流程结束时调用Change Session Status端点
2. 将会话状态设置为"paused"
3. 需要时再设置为"closed"

请求示例：

{
  "remoteJid": "[e-mail]",
  "status": "closed"
}

方案三：版本回退

作为临时解决方案，可回退至1.6.1版本，该版本不存在此问题。

最佳实践建议

1. 环境变量优先：推荐使用TYPEBOT_KEEP_OPEN方案，配置简单且效果稳定
2. 完整JID格式：使用API端点方案时，确保remoteJid包含完整的@example.net后缀
3. 流程设计检查：验证流程中是否包含有效的终止节点
4. 监控机制：实施会话状态监控，确保预期行为

技术影响评估

此问题不仅影响用户体验，还会导致：

• 客户服务流程混乱
• 自动化效率降低
• 系统资源浪费
• 数据统计失真

通过上述解决方案，开发者可以有效恢复Typebot在EvolutionAPI环境中的预期行为，确保会话流程按设计正常终止。