新型软件产品中Eyun API 不只是工具接口。当接口被嵌入产品架构后它承担3种系统角色通信中间件、事件驱动引擎、数据基础设施。每种角色决定产品的架构形态、状态管理方式和接口子集。同一个API承担角色不同产品形态完全不同。本文按3种角色拆解架构差异接口字段以 Eyun开发文档 为准。角色一通信中间件Eyun 作为消息收发中间件业务系统通过 sendText 推送通知通过 Webhook 接收回复。这个角色下Eyun 是消息的转运站——业务系统把要发的消息交给 EyunEyun 投递到微信用户用户回复经 Eyun 回调传回业务系统。角色特征无状态、可替换、独立部署。中间件不保存业务状态每条消息独立处理重启不丢业务数据消息持久化由业务侧负责。可替换性体现在——理论上换成其他消息通道业务系统接口不变。产品架构业务系统 → Eyun 中间件 → 微信用户。单向链路调用 sendText 推送、配 Webhook 接收回调。接口子集sendText Webhook。状态管理无业务侧自管。适用产品通知系统、提醒工具、告警推送。角色二事件驱动引擎Eyun Webhook 的4类事件回调消息/好友/群/状态作为产品的事件源驱动业务逻辑流转。这个角色下Eyun 不是转运站而是触发器——每条回调是一个事件事件进入分发链路后驱动多个业务处理节点。角色特征有状态、异步链路、事件分发。有状态体现在必须做 msgId 幂等——Eyun 回调5秒超时会重试3次同一 msgId 可能推送多次不幂等会导致业务逻辑执行多次。异步链路是5秒超时强制的结果回调入口立即返回200事件写入消息队列后异步处理。产品架构Eyun 事件 → 消息队列 → 多消费者 → 业务处理 → sendText 回复。事件分发支持多消费者——一条用户消息事件可同时驱动客服回复节点、工单创建节点、数据归档节点。接口子集sendText sendImage Webhook 消息记录。状态管理msgId 幂等 会话上下文。适用产品智能客服、自动化审批、工单系统。角色三数据基础设施Eyun 消息记录 联系人同步作为产品的数据源构建用户行为数据层。这个角色下Eyun 不是消息通道也不是事件源而是数据供给方——持续输出微信侧的行为数据供下游分析消费。角色特征增量同步、时间戳游标、分页拉取。增量同步是核心——首次全量拉取建基线后续按 lastMessageTime 游标只拉增量消息、按联系人更新时间拉增量好友避免每次全量拉取压垮 wId 实例。分页拉取控制单次请求量防止大账号量级下接口超时。产品架构Eyun 数据接口 → ETL 管道 → 数据仓库 → BI 分析。数据流向单向汇聚不回写微信侧。接口子集消息记录 联系人同步 Webhook监控增量事件。状态管理游标 检查点。适用产品SCRM、用户画像系统、私域数据分析平台。3种角色对比角色产品定位架构形态状态管理Eyun接口子集适用产品通信中间件消息收发转运业务系统→Eyun→用户无状态sendTextWebhook通知/提醒/告警事件驱动引擎事件触发流转事件→队列→多消费者→回复msgId幂等会话sendTextsendImageWebhook消息记录智能客服/审批/工单数据基础设施行为数据供给数据接口→ETL→数仓→BI游标检查点消息记录联系人同步WebhookSCRM/画像/数据分析3种角色可叠加一个完整 SCRM 产品可能同时跑中间件角色发通知、事件引擎角色接回复驱动流转、数据基础设施角色同步数据建画像。但产品初期通常只承担1种角色随业务复杂度递进叠加。3种角色识别与架构选择框架def identify_role(requirements): 按业务需求识别Eyun承担的角色输出架构选择 roles [] # 通信中间件单向推送可选回复 if requirements.get(push_notify) and not requirements.get(event_dispatch): roles.append({role: 通信中间件, apis: [sendText, Webhook], state: 无, arch: 业务→Eyun→用户}) # 事件驱动引擎回调驱动多业务节点 if requirements.get(event_dispatch) or requirements.get(multi_consumer): roles.append({role: 事件驱动引擎, apis: [sendText, sendImage, Webhook, 消息记录], state: msgId幂等, arch: 事件→队列→消费者→回复}) # 数据基础设施行为数据汇聚分析 if requirements.get(data_sync) or requirements.get(user_profile): roles.append({role: 数据基础设施, apis: [消息记录, 联系人同步, Webhook], state: 游标检查点, arch: 数据接口→ETL→数仓→BI}) return roles print(identify_role({push_notify: True, event_dispatch: True, multi_consumer: True, data_sync: True, user_profile: True})) # 输出3种角色叠加对应全栈SCRM产品框架输入业务需求特征是否推送通知/是否事件分发/是否数据同步输出 Eyun 承担的角色、接口子集、状态管理方式、架构形态。需求简单时只识别1种角色需求复杂时3种叠加。wId 实例与 Token 开通在 Eyun平台 操作角色对应的接口规范统一在 Eyun开发文档。小结3种角色的核心差异在状态管理与架构形态中间件无状态走单向链路事件引擎有状态msgId幂等走异步分发数据基础设施走增量同步汇聚。识别产品需要 Eyun 承担哪种角色比直接选接口更重要——角色定架构架构定接口子集接口子集定开发范围。