企业官网建设流程全解析

"一个 API"其实是一整套接口体系。按功能离"发消息"这个核心的远近，画成三个圈，盘点起来最直观。

一、核心圈——消息收发能力

最核心的一圈，围绕消息：sendText 发文本，sendImage 发图片，sendFile 发文件，以及视频、语音、链接、名片、小程序等消息类型。收消息靠 Webhook 回调，消息记录接口查历史。

核心圈解决"程序和微信能对话"。90% 的机器人项目，只用核心圈的能力就够了。这一圈的接口调用最频繁，返回码判断（1000 成功、1004 限频）也要最熟练。

二、扩展圈——人和群的管理能力

往外一圈，围绕关系：好友操作（添加、通过、删除、备注）、联系人同步；群操作（建群、拉人、踢人、群信息）；好友事件和群事件回调。

扩展圈解决"程序能管理人"。客服欢迎、群运营、私域管理这类场景，核心圈加上扩展圈就完整了。这一圈有写操作（加人、踢人），调用要谨慎。

三、外围圈——状态与高级能力

最外一圈，围绕监控和进阶：实例状态回调（在线、掉线）、错误码体系、朋友圈相关能力、多媒体素材处理。

外围圈解决"系统跑得稳、玩得深"。状态监控是生产环境必备——掉线不可怕，不知道掉线才可怕。朋友圈等高级能力按业务需要选用。

三圈能力盘点

核心圈最小调用

import requests def api(path, payload): r = requests.post(f"https://api.eyunz.com/v1/{path}", headers={"Authorization": TOKEN}, json={"wId": WID, **payload}) data = r.json() if data.get("code") != "1000": # 统一错误处理 log_error(path, data) return data api("sendText", {"toUser": to, "content": "你好"}) # 核心圈

落地建议

能力总览见 Eyun 开发文档。选能力时从核心圈起步，跑通消息收发再往外加——项目上线初期核心圈就能验证 80% 的需求。外围圈里唯一建议尽早接的是状态监控，它不产生业务价值但能防止业务中断。各接口参数在文档中都有明确说明，实例开通见 Eyun 平台。