很多人把API 接口和微信机器人当成一回事其实它们是两层东西——API 是能力层能做什么机器人是应用层怎么组合这些能力解决业务问题。分不清这两层就会出现接口都调通了但机器人不好用的情况。这篇讲清两层的关系和组装方法。一、API 是能力层只管能做什么API 接口提供的是原子能力发一条消息、拉一个好友列表、通过一次申请、踢一个人。接口不关心你为什么这么做只管接收参数、执行、返回结果。能力层的评价标准是稳定性和完整性——接口是否 7×24 可用、返回是否规范、能力覆盖是否全。这部分由平台方负责你不需要开发只需要调用。接口能力的完整清单见 Eyun 官网。二、机器人是应用层只管业务要什么机器人是你自己的程序把原子能力按业务逻辑组合起来。比如新好友自动运营这个机器人功能背后是组合了四个能力监听申请事件、调用通过接口、调用发送接口发欢迎语、调用资料接口打标签。应用层的评价标准是业务效果——响应是否及时、回复是否准确、流程是否顺畅。这部分完全由你自己开发平台给不了。三、从接口到机器人三层组装法第一层客户端封装——把 HTTP 调用包成方法处理鉴权、重试、限流业务代码不碰原始请求。第二层事件路由——回调进来按事件类型分发到不同处理器处理器之间互不干扰。第三层业务策略——每个处理器里写业务规则比如什么申请自动通过什么消息转人工。三层分开的好处是改一层不动其他层换平台只改客户端封装加新事件类型只加路由分支调业务规则只改策略层。四层关系对照层负责什么谁开发改动频率API 能力层原子能力稳定性平台方低客户端封装鉴权重试限流你低事件路由按类型分发你中业务策略业务规则你高三层组装骨架import time, requests # 第一层客户端封装 class WeChatAPI: def __init__(self, base, token_getter): self.base base self.token_getter token_getter def call(self, path, data): return requests.post(self.base path, jsondata, headers{Authorization: self.token_getter()}, timeout15).json() def send(self, wxid, content): time.sleep(3) # 封装层统一限流 return self.call(/send, {wxid: wxid, content: content[:500]}) # 第二层事件路由 class EventRouter: def __init__(self): self.handlers {} def on(self, event_type, handler): self.handlers[event_type] handler return self def dispatch(self, event): h self.handlers.get(event.get(type)) if h: h(event) # 第三层业务策略 class BizPolicy: def __init__(self, api): self.api api def handle_friend_request(self, event): if event[source] qrcode: # 策略扫码直接过 self.api.call(/friend/accept, {req_id: event[req_id]}) time.sleep(3) self.api.send(event[wxid], 欢迎) def handle_message(self, event): if 人工 in event[content]: # 策略提人工就转 self.transfer_to_human(event) else: self.auto_reply(event) # 组装 api WeChatAPI(BASE, get_token) policy BizPolicy(api) router EventRouter() router.on(friend_request, policy.handle_friend_request) router.on(message, policy.handle_message) # 回调入口只干一件事分发 def webhook(event): router.dispatch(event) return {code: 0}落地建议先分清两层——API 是能力层负责能做机器人是应用层负责怎么组合接口调通只是第一步业务效果取决于应用层设计。组装按三层走客户端封装管鉴权重试限流、事件路由管分发、业务策略管规则三层独立改一层不动其他层。业务策略层是迭代最频繁的地方规则尽量配置化。能力层由Eyun这类个人微信API平台 提供三层组装在自建服务实现接口字段以平台开发文档为准。