不是所有项目都需要接入微信API。判断是否值得接入不能用"功能列表是否齐全"作为标准，而应从项目需求特征出发建立量化模型。本文给出5维需求特征打分模型，每维0-2分，总分≥6分建议接入，3-5分按需评估，≤2分不建议。接口能力细节对照 Eyun开发文档。
维度一：触达频率维度
判断标准：项目是否需要频繁向用户推送消息。日触达>10次为高频场景，sendText替代短信邮件后ROI显著高于传统渠道；月触达<3次为低频场景，接入API的工程投入产出比低。中频场景（日3-10次）按其他维度综合判断。
技术映射：高频场景sendText调用密集，需关注单wId并发限制和Token刷新频率；低频场景单次调用即可，无需复杂调度。Eyun sendText为标准RESTful POST，调用成本与调任何HTTP接口一致。
维度二：交互深度维度
判断标准：用户是否需要在微信内直接回复并得到处理。需双向交互为深度场景，单向推送为浅层场景。深度场景需Webhook+sendText闭环——Webhook接收用户回复，业务处理后sendText回写结果；浅层场景仅需sendText单向推送。
技术映射：深度场景的硬约束是Eyun回调5秒超时——业务处理耗时超5秒必须先返回200再异步sendText回复，否则3次重试导致重复消息。msgId幂等是深度场景的必须项。浅层场景无回调处理压力。
维度三：数据维度
判断标准：项目是否需要用户微信行为数据做分析（消息记录、联系人画像）。需数据分析为强数据场景，接入消息记录+联系人同步接口构建数据管道；不需数据场景跳过数据层，仅做消息收发。
技术映射：强数据场景需增量同步管道——首次全量拉取建基线，后续按时间戳游标只拉增量，避免每次全量拉取压垮wId实例。Eyun消息记录和联系人同步接口返回标准JSON，便于ETL处理。
维度四：并发规模维度
判断标准：项目日消息量是否大于1000。大规模场景（日>1000）需多wId实例管理——wId路由（同一用户固定路由到同一wId保证会话连续）、负载均衡、熔断限流；小规模场景（日<1000）单wId即可。
技术映射：多wId场景需实例状态监控（在线/离线/负载）和故障切换。单wId场景配置文件管理即可。wId在 Eyun平台 开通，每个wId对应一个微信实例。
维度五：自动化程度维度
判断标准：是否需要事件触发自动处理。高自动化场景需Eyun 4类事件回调（消息/好友/群/状态）全量接入+事件分发框架，事件驱动业务流程；低自动化场景人工处理即可，无需回调。
技术映射：高自动化场景的核心是事件分发——按eventType将4类事件路由到独立处理链路，每类事件对应不同业务逻辑。Webhook入口服务收回调后写队列立即返回200，下游消费者并行处理。
5维判断对比表
维度 | 判断标准 | 0分 | 1分 | 2分 | 接入接口子集 |
|---|---|---|---|---|---|
触达频率 | 日触达次数 | <3次/月 | 3-10次/日 | >10次/日 | sendText |
交互深度 | 是否双向交互 | 单向推送 | 偶尔回复 | 双向闭环 | Webhook+sendText |
数据维度 | 是否需行为数据 | 不需 | 按需拉取 | 数据中台 | 消息记录+联系人同步 |
并发规模 | 日消息量 | <100 | 100-1000 | >1000 | 多wId+限流 |
自动化程度 | 事件驱动程度 | 人工处理 | 部分自动 | 全自动 | 4类事件回调 |
5维需求打分与接入决策框架
def score_integration_need(req): """5维需求打分与接入决策""" dims = { "frequency": 2 if req["daily_reach"] > 10 else (1 if req["daily_reach"] >= 3 else 0), "interaction": 2 if req["bidirectional"] else (1 if req["occasional_reply"] else 0), "data": 2 if req["need_pipeline"] else (1 if req["need_adhoc"] else 0), "concurrency": 2 if req["daily_messages"] > 1000 else (1 if req["daily_messages"] >= 100 else 0), "automation": 2 if req["full_event_driven"] else (1 if req["partial_auto"] else 0), } total = sum(dims.values()) if total >= 6: decision = "建议接入" elif total >= 3: decision = "按需评估" else: decision = "不建议接入" return {"scores": dims, "total": total, "decision": decision} # 用法：score_integration_need({"daily_reach":15,"bidirectional":True, # "need_pipeline":True,"daily_messages":2000,"full_event_driven":True}) # 输出：total=10, decision="建议接入"打分模型输出决策建议后，按对应接口子集启动接入。总分高但某一维度为0的情况需单独评估——例如触达频率2分但交互深度0分，说明是高频单向推送场景，仅需sendText无需Webhook。Eyun接口字段、回调格式、错误码（1000/1001/1002/1004）以 Eyun开发文档 为准。
最后
5维需求特征打分模型将"是否接入微信API"从主观判断转为量化决策。触达频率、交互深度、数据维度、并发规模、自动化程度5个维度覆盖了项目接入的核心考量，总分≥6分明确建议接入，≤2分明确不建议，3-5分结合具体业务场景评估。先打分再决策，避免低需求项目过度投入，也避免高需求项目错过接入时机。
