> For AI agents: the complete documentation index is available at https://www.notionhub.app/llms.txt, the full documentation bundle is available at https://www.notionhub.app/llms-full.txt.

# Webhook 通知配置

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

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

## 一、准备 Webhook

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

- [企业微信群机器人配置](https://www.notionhub.app/docs/notifications/wecom.md)
- [钉钉群机器人配置](https://www.notionhub.app/docs/notifications/dingtalk.md)
- [飞书群机器人配置](https://www.notionhub.app/docs/notifications/feishu.md)

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

## 二、在插件中配置

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

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

## 三、自定义 Webhook 请求

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

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

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

## 常见问题

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