从客服工具到销售软件：个人微信API接口可以承载的微信功能

个人微信API接口承载什么功能取决于上层软件产品的形态。同一套Eyun接口在客服工具、销售软件、CRM系统、通知系统4类产品中承载的功能子集完全不同。本文按产品类型横切对比4类产品各自调用的Eyun功能子集与技术要点接口字段以 Eyun开发文档 为准。4类产品的功能映射逻辑产品类型决定功能子集。客服工具核心是消息双向流转以WebhooksendText为主销售软件核心是富媒体推送以sendTextsendImagesendFile为主CRM系统核心是数据补全以联系人同步消息记录为主通知系统核心是单向高并发以sendText多wId为主。每类产品只用到Eyun功能的一个子集不存在全都要的产品。客服工具类消息双向流转核心需求是用户消息进来、客服回复出去的闭环。Eyun Webhook接收用户消息回调JSON含fromUser/content/msgId/wId客服处理完调sendText回复。会话上下文依赖消息记录接口拉历史按fromUser聚合为会话链路。功能子集sendText sendImage Webhook 消息记录。sendImage用于客服回图片截图说明消息记录用于新客服接手时看历史。关键技术点是5秒回调超时——Webhook收到消息必须先返回200再异步处理否则触发3次重试导致重复回复msgId做幂等去重。销售软件类富媒体组合推送核心需求是把产品信息以多种形态推给客户。sendText推文字介绍sendImage推产品图sendFile推报价单PDF。三种消息类型按销售流程编排首次触达发文字图片跟进阶段发文件。客户跟进记录依赖联系人同步接口构建客户列表标记跟进阶段。功能子集sendText sendImage sendFile 联系人同步。关键技术点是消息类型编排顺序——先发文字再发图片体验更自然sendFile的文件需先上传再引用。错误码1001参数错误常出现在文件路径错误时调用前校验文件可达性。CRM系统类微信行为数据补全核心需求是用微信交互数据补全CRM客户画像。联系人同步接口拉好友列表构建客户基础库消息记录接口拉交互历史分析沟通频次和活跃度Webhook监控客户主动联系事件。CRM侧调sendText做客户触达。功能子集联系人同步 消息记录 Webhook sendText。关键技术点是增量同步——首次全量拉取建基线后续按lastMessageTime游标只拉增量避免每次全量拉取压垮wId实例。4类Webhook事件消息/好友/群/状态中好友事件用于客户关系变化监控。通知系统类单向高并发推送核心需求是把系统状态变更推给用户单向、不回复、高并发。订单状态、审批结果、告警通知都属此类。只需sendText接口但要求高并发下多wId负载。功能子集sendText 多wId管理。关键技术点是wId分片——按用户ID哈希分配到不同wId实例单实例并发控制在接口上限内。Token集中管理1002错误码触发自动刷新重试保证推送不断裂。通知类不需要Webhook用户不回复架构最简。4类产品功能对比产品类型核心功能Eyun功能子集关键技术点数据流向客服工具消息双向流转sendTextsendImageWebhook消息记录5秒超时msgId幂等双向闭环销售软件富媒体组合推送sendTextsendImagesendFile联系人同步消息编排文件校验单向为主CRM系统行为数据补全联系人同步消息记录WebhooksendText增量同步游标管理数据汇聚通知系统单向高并发推送sendText多wId管理wId分片Token刷新单向广播4类产品功能子集互有重叠但核心不同客服重双向销售重富媒体CRM重数据通知重并发。一个产品可能横跨两类如销售CRM但承载的主功能子集由其产品定位决定。产品类型与功能子集映射框架PRODUCT_CAPABILITY { 客服工具: { core: 消息双向流转, apis: [sendText, sendImage, Webhook, 消息记录], wid: single, webhook: True, sync: session}, 销售软件: { core: 富媒体组合推送, apis: [sendText, sendImage, sendFile, 联系人同步], wid: single, webhook: False, sync: contact}, CRM系统: { core: 行为数据补全, apis: [联系人同步, 消息记录, Webhook, sendText], wid: single, webhook: True, sync: incremental}, 通知系统: { core: 单向高并发推送, apis: [sendText, 多wId管理], wid: sharding, webhook: False, sync: None}, } def get_capability_subset(product_type): 按产品类型返回Eyun功能子集与接入策略 return PRODUCT_CAPABILITY.get(product_type, {})框架按产品类型输出功能子集、wId策略、Webhook依赖、数据同步方式4个维度的接入参数。开发前先确定产品类型按子集接入对应接口——避免通知系统误配Webhook无回复需求或客服工具漏配消息记录缺会话上下文。wId和Token开通在 Eyun平台 操作接口字段对照 Eyun开发文档。4类产品对应4个功能子集不是每个产品都要接全套接口。客服重收发闭环销售重富媒体推送CRM重数据补全通知重并发分片——产品定位决定功能子集功能子集决定接入方案。先明确产品类型再按子集接入比上来就全量对接接口更高效。