#Webhook 通知配置

NotionHub 可以把同步开始、完成和失败通知发送到群机器人或自定义 Webhook。目前会自动识别：

• 企业微信群机器人
• 钉钉群机器人
• 飞书群机器人
• Slack Incoming Webhook
• Discord Webhook
• 其他接收标准 JSON 的 HTTP Webhook

#一、准备 Webhook

在接收通知的平台创建群机器人并复制完整 Webhook URL：

• 企业微信群机器人配置
• 钉钉群机器人配置
• 飞书群机器人配置

Webhook URL 相当于发送密钥，不要提交到公开仓库、Issue 或聊天记录。

#二、在插件中配置

1. 打开 NotionHub 浏览器插件。
2. 进入 通知。
3. 选择 Webhook。
4. 填写完整的 Webhook URL。
5. 如果钉钉机器人启用了加签，再填写签名密钥；其他平台留空。
6. 保存配置，并在需要接收通知的同步服务中开启通知。

NotionHub 会根据 URL 自动使用对应平台的消息格式。钉钉机器人建议使用关键词或加签安全设置，不要使用 IP 白名单，因为 GitHub Hosted Runner 的出口 IP 会变化。

#三、自定义 Webhook 请求

无法识别的平台会收到一个 HTTP POST JSON 请求：

{
  "title": "NotionHub",
  "text": "同步完成",
  "markdown": "同步完成"
}

接收端返回 HTTP 2xx 即视为投递成功。

#常见问题

• 检查 Webhook URL 是否复制完整。
• 钉钉使用关键词时，请把关键词设置为 NotionHub。
• 钉钉使用加签时，确认签名密钥与当前机器人一致。
• 企业微信机器人只能向创建它的群聊发送消息。
• Webhook 被重新生成后，需要在插件中更新配置。