机器人推送（对外事件流）

路径：通知控制台 → 机器人推送

把站内业务事件（笔记发布、外卖订单、抽奖等）以 JSON 形式推给你自己的脚本或机器人中转服务。
灵萌不会直接替你发到 QQ / 钉钉；你需要用 API Key 拉取或接收回调后再转发。

不要和「官方机器人」搞混

名称	菜单位置	用途
官方机器人	用户体系 → 官方机器人	站内助手账号、对话回复
机器人推送（本文）	通知控制台 → 机器人推送	对外事件流 / Webhook

---

前置条件

• 模块已开通（系统设置 → 我的模块）
• 若用 HTTP 回调：你的接收地址须公网 HTTPS 可达
• 明确要订阅哪些事件（见下方事件列表）

---

三步上手

第一步：流配置

路径：通知控制台 → 机器人推送 → 流配置

1. 选择目标区域（或平台默认，区域编号 0）
2. 打开 启用对外事件流
3. 按需勾选允许的能力：HTTP 回调 / 内容拉取 / WebSocket
4. 勾选 允许事件类型（未勾选的事件，接入点即使订阅也收不到）
5. 按需调整：最大接入点数、Payload 档位（精简 / 标准 / 完整）、重试与超时、限流
6. 保存

WARNING

关闭「启用对外事件流」后，该区域不写入事件，也不能新建接入点。
未单独配置的区域会继承平台默认（region_id = 0）。

第二步：新建接入点

路径：通知控制台 → 机器人推送 → 接入点（页内标题也可能写作「机器人接入点」）

1. 新建接入点
2. 绑定区域，选择分类（如笔记转发 / 外卖告警 / 混合）
3. 多选订阅事件（须在流配置白名单内）
4. 选择取数方式：
   • Pull 拉取 — 你的程序定时来取
   • HTTP 回调 — 事件发生时 POST 到你的 URL
   • WebSocket — 长连接接收
5. 若回调：填写回调 URL、Secret；可选 IP 白名单
6. 保存后 立刻复制 API Key（通常只显示一次）

第三步：对接与排障

1. 用 API Key 按 接入指南 写脚本或配置中转服务
2. 日常看 推送概览（已启用区域、接入点、今日事件、WS 在线）
3. 失败看 回调日志，可补发 / 重放

路径：通知控制台 → 机器人推送 → 接入指南（站内有官方三步说明与取数方式说明）。

---

常见事件类型（页面标签）

笔记发布、外卖新订单、外卖已接单、外卖已取消、骑手已分配、抽奖开始、抽奖开奖、圈子公告等（以页面勾选项为准）。

---

验证是否生效

1. 流配置已启用，事件类型已勾选
2. 接入点启用且 Key 已保存
3. 触发一条真实业务（如发笔记、下外卖单）
4. 推送概览 今日事件增加；Pull/回调/WS 侧收到 JSON
5. 回调失败时 回调日志 有失败原因，修复后可补发

---

常见问题

现象	处理
接入点收不到	流配置是否启用；事件是否在白名单；接入点是否订阅且启用
回调一直失败	URL 是否 HTTPS 可达；验签 Secret；IP 白名单是否误拦
Key 丢了	在接入点执行轮换 Key，旧 Key 失效，请同步更新脚本
和站内通知重复	二者独立：站内走 通知与推送；对外走本文

---

相关文档

• 通知与推送
• 官方机器人
• 外卖