EvolutionAPI与Typebot集成中的消息会话处理机制分析

在基于EvolutionAPI和Typebot构建的客服系统中，存在一个典型的会话管理问题：当客服人员主动发起对话后，Typebot仍会在客户回复时自动创建新会话流程。这种现象会破坏人工客服与客户之间的自然对话连续性，影响用户体验。

问题本质

该问题的技术本质在于系统未能正确区分"主动发起"和"被动响应"两种会话模式。当客服人员(fromMe=true)首先联系客户时，系统应该：

1. 保持当前会话上下文
2. 禁止Typebot创建新的对话流程
3. 维持人工客服的主导权

解决方案架构

服务端处理层(EvolutionAPI)

在EvolutionAPI 2.1.2及以上版本中，已加入消息源标识处理逻辑。服务端应：

• 检测消息的fromMe属性
• 对客服发起的消息跳过Typebot流程触发
• 保持现有会话状态不变

流程引擎层(Typebot)

Typebot 2.28.2需要配合实现以下逻辑：

• 增加消息来源判断条件
• 当检测到fromMe=true时，跳过自动流程创建
• 保留当前会话的所有上下文变量

实现建议

对于开发者而言，完整的解决方案需要双端配合：

1. 版本要求：

   • EvolutionAPI必须升级至2.1.2+
   • Typebot建议使用2.28.2+

2. 配置要点：

   • 在EvolutionAPI中启用"ignoreAgentResponse"选项
   • 在Typebot流程中设置消息源判断条件

3. 异常处理：

   • 建立会话状态同步机制
   • 实现超时会话自动回收
   • 添加人工/自动模式切换标志

系统行为对比

场景	旧版本行为	修正后行为
客服主动发起	客户回复时新建流程	保持现有会话
客户主动咨询	正常启动Typebot流程	正常启动流程
会话超时后	可能创建冗余流程	自动清理会话

最佳实践建议

1. 在混合式客服系统中，建议实现：

   • 明确的会话所有权标识
   • 人工/自动模式切换API
   • 会话状态持久化机制

2. 对于高并发场景，还需要考虑：

   • 会话锁机制
   • 消息时序处理
   • 状态一致性校验

该问题的解决不仅修复了特定bug，更为构建灵活的人机协作客服系统提供了架构参考。开发者可以根据实际业务需求，在此基础上扩展更复杂的会话管理策略。