1. 为什么要用 Webhook 接收消息开发微信机器人最重要的一步是“让代码知道别人发了什么”。很多旧框架采用循环轮询每隔1秒问一次服务器有没有新消息这不仅极度消耗服务器资源还会导致消息延迟。Eyun API 采用标准的 Webhook网络钩子机制。当你的微信号收到消息时Eyun 中枢会主动向你的服务器发送一个 HTTP POST 请求把消息以规范的 JSON 格式“推”给你的代码。这种方式零延迟、不占资源。2. 本地测试的“内网穿透”准备因为 Eyun 在云端它无法直接访问你本地电脑的 [http://127.0.0.1](http://127.0.0.1)。在本地测试开发时我们需要用工具把本地端口映射到公网。推荐使用 cwt、ngrok 或 localtunnel。以 localtunnel 为例在终端执行lt --port 5000你会获得一个公网域名例如[https://gentle-wolf-88.localtunnel.me](https://gentle-wolf-88.localtunnel.me)。把这个域名加上/webhook 路由拼接成 [https://gentle-wolf-88.localtunnel.me/webhook](https://gentle-wolf-88.localtunnel.me/webhook)填入 Eyun 控制台的 Webhook 配置项中。3. 完整 Webhook 接收端源码Python我们使用极简的 Flask 框架来搭建这个接收端。请先安装依赖pip install flask requests。编写 server.py#!/usr/bin/env python3 # -*- coding: utf-8 -*- Eyun 微信机器人开发系列教程 - 第二篇 功能接收 Eyun 微信执行中枢的 Webhook 消息流 import json from flask import Flask, request, jsonify app Flask(__name__) app.route(/webhook, methods[POST]) def eyun_webhook_listener(): 监听 Eyun 平台推送过来的微信事件 # 1. 解析 Eyun 推送的 JSON 数据 payload request.json if not payload: return jsonify({code: 400, message: Invalid JSON data}), 400 # 2. 打印完整的 JSON 报文结构方便开发者研究文档 print(\n *20 收到 Eyun 消息事件 *20) print(json.dumps(payload, indent4, ensure_asciiFalse)) print(*50 \n) # 3. 提取核心元数据 event_type payload.get(event_type) # 事件类型私聊、群聊、登录状态变更等 node_id payload.get(node_id) # 触发该事件的微信节点 ID event_data payload.get(data, {}) # 4. 根据不同的事件类型分发执行不同的业务逻辑 if event_type message.private: # 个人私聊消息 sender_wxid event_data.get(sender) # 发送者的微信ID msg_content event_data.get(content) # 消息文本内容 msg_id event_data.get(msg_id) # 消息唯一标识 print(f【私聊】节点[{node_id}]收到来自[{sender_wxid}]的消息: {msg_content} (ID: {msg_id})) elif event_type message.group: # 群聊消息 room_id event_data.get(room_id) # 群聊的房间ID sender_wxid event_data.get(sender) # 发言人的微信ID msg_content event_data.get(content) # 消息文本内容 print(f【群聊】群[{room_id}]内[{sender_wxid}]发言: {msg_content}) elif event_type node.status: # 节点状态变更事件如微信掉线或上线 new_status event_data.get(status) print(f【系统】您的微信节点[{node_id}]状态变更为: {new_status}) # 5. 必须及时给 Eyun 中枢返回 200 状态码否则中枢会判定你的服务器超时并尝试重试 return jsonify({code: 200, message: Event processed successfully}), 200 if __name__ __main__: # 启动本地服务监听 5000 端口 # 在生产环境中建议部署在公网服务器上并配合 Gunicorn 运行 app.run(host0.0.0.0, port5000)4. 关键数据文档拆解当你启动上述服务器并在微信里给机器人发一条消息时控制台会打印出如下结构的 JSON。请仔细观察它的规范设计{ event_type: message.private, node_id: personal_bot_v1, timestamp: 1716200000, data: { msg_id: 847291048291048201, sender: wxid_ab123cd456, receiver: wxid_robot_self, content: 测试消息内容, msg_type: 1 } }event_type这是你的“路由方向盘”。做开发时先通过它判断是群聊还是私聊。• node_id当你有多个微信号托管在 Eyun 时这个字段能告诉你这条消息是哪个微信号收到的。• sender 和 room_id后续我们编写“回复消息”接口时这两个字段就是我们要填写的接收人目标地址。掌握了这个回调机制你的机器人就已经睁开了眼睛。引导入口Eyun——微信执行中枢开发文档Eyun——微信执行中枢
Eyun微信执行中枢免费测试 教程/文档/开发
发布时间：2026/5/21 11:20:12
1. 为什么要用 Webhook 接收消息开发微信机器人最重要的一步是“让代码知道别人发了什么”。很多旧框架采用循环轮询每隔1秒问一次服务器有没有新消息这不仅极度消耗服务器资源还会导致消息延迟。Eyun API 采用标准的 Webhook网络钩子机制。当你的微信号收到消息时Eyun 中枢会主动向你的服务器发送一个 HTTP POST 请求把消息以规范的 JSON 格式“推”给你的代码。这种方式零延迟、不占资源。2. 本地测试的“内网穿透”准备因为 Eyun 在云端它无法直接访问你本地电脑的 [http://127.0.0.1](http://127.0.0.1)。在本地测试开发时我们需要用工具把本地端口映射到公网。推荐使用 cwt、ngrok 或 localtunnel。以 localtunnel 为例在终端执行lt --port 5000你会获得一个公网域名例如[https://gentle-wolf-88.localtunnel.me](https://gentle-wolf-88.localtunnel.me)。把这个域名加上/webhook 路由拼接成 [https://gentle-wolf-88.localtunnel.me/webhook](https://gentle-wolf-88.localtunnel.me/webhook)填入 Eyun 控制台的 Webhook 配置项中。3. 完整 Webhook 接收端源码Python我们使用极简的 Flask 框架来搭建这个接收端。请先安装依赖pip install flask requests。编写 server.py#!/usr/bin/env python3 # -*- coding: utf-8 -*- Eyun 微信机器人开发系列教程 - 第二篇 功能接收 Eyun 微信执行中枢的 Webhook 消息流 import json from flask import Flask, request, jsonify app Flask(__name__) app.route(/webhook, methods[POST]) def eyun_webhook_listener(): 监听 Eyun 平台推送过来的微信事件 # 1. 解析 Eyun 推送的 JSON 数据 payload request.json if not payload: return jsonify({code: 400, message: Invalid JSON data}), 400 # 2. 打印完整的 JSON 报文结构方便开发者研究文档 print(\n *20 收到 Eyun 消息事件 *20) print(json.dumps(payload, indent4, ensure_asciiFalse)) print(*50 \n) # 3. 提取核心元数据 event_type payload.get(event_type) # 事件类型私聊、群聊、登录状态变更等 node_id payload.get(node_id) # 触发该事件的微信节点 ID event_data payload.get(data, {}) # 4. 根据不同的事件类型分发执行不同的业务逻辑 if event_type message.private: # 个人私聊消息 sender_wxid event_data.get(sender) # 发送者的微信ID msg_content event_data.get(content) # 消息文本内容 msg_id event_data.get(msg_id) # 消息唯一标识 print(f【私聊】节点[{node_id}]收到来自[{sender_wxid}]的消息: {msg_content} (ID: {msg_id})) elif event_type message.group: # 群聊消息 room_id event_data.get(room_id) # 群聊的房间ID sender_wxid event_data.get(sender) # 发言人的微信ID msg_content event_data.get(content) # 消息文本内容 print(f【群聊】群[{room_id}]内[{sender_wxid}]发言: {msg_content}) elif event_type node.status: # 节点状态变更事件如微信掉线或上线 new_status event_data.get(status) print(f【系统】您的微信节点[{node_id}]状态变更为: {new_status}) # 5. 必须及时给 Eyun 中枢返回 200 状态码否则中枢会判定你的服务器超时并尝试重试 return jsonify({code: 200, message: Event processed successfully}), 200 if __name__ __main__: # 启动本地服务监听 5000 端口 # 在生产环境中建议部署在公网服务器上并配合 Gunicorn 运行 app.run(host0.0.0.0, port5000)4. 关键数据文档拆解当你启动上述服务器并在微信里给机器人发一条消息时控制台会打印出如下结构的 JSON。请仔细观察它的规范设计{ event_type: message.private, node_id: personal_bot_v1, timestamp: 1716200000, data: { msg_id: 847291048291048201, sender: wxid_ab123cd456, receiver: wxid_robot_self, content: 测试消息内容, msg_type: 1 } }event_type这是你的“路由方向盘”。做开发时先通过它判断是群聊还是私聊。• node_id当你有多个微信号托管在 Eyun 时这个字段能告诉你这条消息是哪个微信号收到的。• sender 和 room_id后续我们编写“回复消息”接口时这两个字段就是我们要填写的接收人目标地址。掌握了这个回调机制你的机器人就已经睁开了眼睛。引导入口Eyun——微信执行中枢开发文档Eyun——微信执行中枢
)
