当微信成为业务入口：个人微信API接口如何帮助应用获得6种交互能力

最近接了几个定制化项目，谈需求时发现一个有意思的现象：差不多一半客户开口第一句就是——"我们不用做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种交互能力汇总表

代码实现：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平台 了解一下，文档齐全接口稳定，少踩坑多干活，把精力放在真正创造价值的地方。