推送地址（Webhook）使用说明

Skill Studio 的定时推送会把摘要以 HTTP POST 发到你填写的 URL。不同产品对请求体格式要求不同：本服务对钉钉群机器人已做专门适配；其它地址会发送 JSON，需自行对接或经中转服务转换。

一、推荐：钉钉群机器人

打开钉钉 PC 或手机端，进入目标群设置 → 智能群助手 / 机器人 → 添加机器人 → 选择「自定义」或通过应用市场添加支持 Webhook 的机器人。
复制机器人提供的 Webhook 地址（通常以 https://oapi.dingtalk.com/robot/send?access_token=… 开头）。
在本页「推送地址」中新建一条：填写显示名称，把完整 URL 粘贴到 Webhook URL，保存。
若机器人开启了安全设置 → 自定义关键词，请在服务端环境变量中配置与推送正文一致的关键词（例如包含「定时推送」），否则钉钉会拒收。

二、本系统如何区分「钉钉」与「其它」

当 URL 的域名包含 oapi.dingtalk.com 时，按钉钉文本消息格式发送（msgtype: text 等）。其它 URL 则 POST 本系统内部的 JSON 结构（含 event、摘要等字段），多数 IM 的默认 Webhook 不能直接解析，需要你在中间搭一层服务或自动化工具做格式转换。

三、常见支持 Webhook 的应用与产品（参考清单）

下列产品多提供「传入 Webhook / Incoming Webhook / 自定义机器人」能力；是否与本页直连取决于对方 API 格式。

类型	示例	说明
国内协作	钉钉、企业微信、飞书 / Lark、华为 WeLink、如流	钉钉已适配；其余通常需中转或自研网关。
海外协作	Slack、Microsoft Teams、Discord、Google Chat、Telegram Bot	各自 JSON 字段不同，需对接文档或 n8n 等转换。
研发与运维	GitHub、GitLab、Bitbucket、Jenkins、Azure DevOps、PagerDuty、Sentry	多用于事件通知；若仅调试可收 POST 亦可试。
自动化	Zapier、Make、IFTTT、n8n、Huginn	常作为「万能中转」，把本系统 JSON 转成目标格式。
调试	webhook.site、Beeceptor、自建接口	查看原始请求体与 Header，联调必备。

四、测试与排查

在「定时推送」里编辑任务，使用测试内容 / 测试推送验证（基于已保存配置）。
钉钉返回 HTTP 200 但 errcode 非 0 时，多为关键词或加签安全策略不匹配。
非钉钉地址若返回 4xx/5xx，请用调试工具查看服务端发出的 JSON 是否被对方接受。

若你希望官方直接支持「企业微信 / 飞书 / Slack」等格式，可在部署环境中扩展 due_tasks 中的消息构造逻辑，或统一走 n8n 等中转。

← 返回 Skill Studio