最近接了几个定制化项目，谈需求时发现一个有意思的现象：差不多一半客户开口第一句就是——"我们不用做App、小程序、网页，微信就是我们的前端"。
说实话，第一次听到这话我是懵的。但仔细一想，用户每天打开微信的时间比任何App都长，要是能直接在微信里把业务办了，谁还愿意下载新东西？
但微信本身不是为业务系统设计的。做订单通知、审批流程、客户管理，总不能手动一条条发消息吧？后来用Eyun的个人微信API接口做了几个项目，慢慢摸出了门道：通过API可以让应用获得6种完整的交互能力，把微信真正变成"可编程的业务前端"。今天整理出来分享给大家。
详细接口定义可以参考 Eyun开发文档，下面讲的这些能力文档里都有对应API说明。
6种交互能力详解
1. 主动通知能力：系统推送到用户
作用：最常用的能力。订单发货通知、审批结果提醒、系统告警等，用户不需要操作，消息自动发到微信。
场景：电商下单后自动发"订单已发货"；OA审批通过后立刻通知申请人。
Eyun API支撑：sendText/sendImage等发送接口，标准RESTful API，POST+JSON格式，携带wId实例ID和Token鉴权。
2. 被动响应能力：用户发消息系统自动回复
作用：用户主动发起，系统被动响应。输入"订单12345"返回订单状态，输入"帮助"返回操作菜单。
场景：客服机器人、自助查询、关键词自动回复。
Eyun API支撑：Webhook回调机制，用户发消息时Eyun通过HTTP POST推送JSON数据到你的回调地址，处理后调用send接口回复。
3. 双向会话能力：多轮对话上下文关联
作用：不是一问一答就结束，可以持续多轮对话，系统记住之前的聊天内容。
场景：智能客服引导描述问题；预约系统先问时间、再问地点、最后确认，过程连贯不中断。
Eyun API支撑：消息记录同步接口拉取历史消息，每条消息有senderId、chatId标识，配合Webhook和send接口实现多轮对话。
4. 多媒体交互能力：8种消息类型全覆盖
作用：业务交互不只是文字，还需要发图片、语音、视频、文件等。比如发身份证照片验证、发PDF合同。
场景：理赔系统拍照上传出险照片；HR系统发送offer文档。
Eyun API支撑：支持文本/图片/语音/视频/文件/名片/位置/链接8种类型，资源类消息先上传获取mediaId再发送，接收时返回下载地址。
5. 事件触发能力：状态变更自动触发动作
作用：微信里的状态变化也能作为触发条件，自动执行业务逻辑。
场景：新好友添加时自动发欢迎语；被拉入新群时发群规；好友删除时标记客户流失。
Eyun API支撑：丰富的事件回调（好友添加/删除、入群/退群、群成员变更等），同样通过Webhook JSON推送，配置不同触发动作即可。
6. 数据回流能力：微信数据同步回业务系统
作用：微信不只是消息通道，也是数据采集入口。把联系人、聊天记录、群信息同步回业务系统做分析。
场景：CRM系统自动同步微信联系人补充客户画像；质检系统拉取聊天记录检查话术。
Eyun API支撑：联系人同步接口（好友列表、群列表、群成员）、消息同步接口（按时间范围拉取历史），结构化JSON，支持增量同步。
6种交互能力汇总表
能力类型 | 交互方向 | 核心场景 | 关键Eyun API |
|---|---|---|---|
主动通知 | 系统→用户 | 订单通知、审批提醒 | sendText、sendImage等 |
被动响应 | 用户→系统 | 自助查询、客服机器人 | Webhook消息回调 + send接口 |
双向会话 | 双向多轮 | 智能客服、流程引导 | 消息记录接口 + 会话状态 |
多媒体交互 | 双向 | 图片验证、文件传输 | 8种消息类型 + 资源接口 |
事件触发 | 事件驱动 | 欢迎语、流失标记 | 事件回调（好友/群/状态） |
数据回流 | 微信→系统 | CRM同步、质检分析 | 联系人/消息同步接口 |
代码实现：6种能力的统一调度入口
下面是实际项目中用的调度入口类，把6种能力统一封装成WechatInteraction类。参数中的wId和Token请替换成你在Eyun平台上获取的实际值。
import requests class WechatInteraction: BASE_URL = "https://api.eyunz.com" def __init__(self, w_id, token): self.w_id = w_id self.token = token self.session_context = {} def _headers(self): return {"Content-Type": "application/json", "Authorization": f"Bearer {self.token}"} # 能力1：主动通知 def push_notification(self, to_user, content, msg_type="text"): endpoints = {"text": "/message/sendText", "image": "/message/sendImage"} if msg_type not in endpoints: raise ValueError(f"不支持的消息类型: {msg_type}") payload = {"wId": self.w_id, "toUser": to_user} payload["content" if msg_type == "text" else "mediaId"] = content return requests.post(self.BASE_URL + endpoints[msg_type], headers=self._headers(), json=payload).json() # 能力2&3：被动响应 + 双向会话 def handle_webhook(self, data): sender, content = data.get("fromUser"), data.get("content") ctx = self.session_context.get(sender, {"step": 0}) response = self._dialog(sender, content, ctx) self.session_context[sender] = ctx if response: self.push_notification(sender, response) return {"code": 0} def _dialog(self, sender, content, ctx): if content == "预约": ctx["step"] = 1 return "请告诉我预约时间？" elif ctx["step"] == 1: ctx["time"], ctx["step"] = content, 2 return "请告诉我预约地点？" elif ctx["step"] == 2: ctx["step"] = 0 return f"预约成功！时间：{ctx['time']}，地点：{content}" return None # 能力5：事件触发 def handle_event(self, data): et = data.get("eventType") if et == "friend_add": self.push_notification(data.get("userId"), "您好！欢迎添加，请问有什么可以帮您？") elif et == "group_join": self.push_notification(data.get("groupId"), "大家好，我是业务小助手！") return {"code": 0} # 能力6：数据回流 def sync_data(self, data_type, start_time=None): urls = {"contacts": "/contact/getFriends", "groups": "/contact/getGroups", "messages": "/message/getHistoryMsgs"} if data_type not in urls: raise ValueError(f"不支持的数据类型: {data_type}") payload = {"wId": self.w_id} if start_time: payload["startTime"] = start_time return requests.post(self.BASE_URL + urls[data_type], headers=self._headers(), json=payload).json()总结
把微信作为业务入口，刚开始我觉得是"野路子"，做了几个项目后发现这其实是非常务实的选择。用户不用学新东西，员工不用换工具，落地成本极低。
而Eyun的个人微信API接口，本质上就是给了你一把"打开微信交互能力的钥匙"，用熟悉的RESTful API、JSON格式、Token鉴权就能调用6种交互能力。不用研究底层协议，不用维护登录状态，专注写业务逻辑就行。
如果你也在做"微信当前端"这类项目，建议去 Eyun平台 了解一下，文档齐全接口稳定，少踩坑多干活，把精力放在真正创造价值的地方。
