Webhook 会在几秒钟内把你项目上的每次变化告诉另一个系统。只有管理员可以添加。
添加 Webhook
- 在侧边栏中打开设置 › AI 代理,找到 Webhook 和 Slack 卡片。
- 粘贴要接收事件的地址。它必须以
https://开头,并且能从互联网访问。 - 选择格式:
- JSON,带签名:用于你自己的代码、Zapier、Make、n8n 等工具;
- Slack incoming webhook:在 Slack 频道中,每个事件一行易读的文字。
- 点击添加 Webhook。


对于 JSON,请现在复制签名密钥。它不会再次显示。
发送到 Slack
- 在 Slack 中,为你想要的频道创建一个 incoming webhook。Slack 会给你一个以
https://hooks.slack.com/开头的地址。 - 在 Notiamo 中添加它,格式选择 Slack incoming webhook。
每一行说明谁在哪个项目上做了什么,并附有评论的链接。Slack 的内容是英文。
会发送什么
每条新评论、回复、状态变化和指派,以及编辑和被删除的回复。内部备注也包含在内并有标记:Webhook 是发给代理机构的,不是发给客户的。
一次 JSON 投递是一个 POST 请求,内容如下:
{
"delivery": "a-unique-id",
"events": [
{
"id": 1234,
"event": "comment_created",
"at": "2026-10-14T09:30:00.000Z",
"internal": false,
"viaAgent": false,
"actor": { "name": "Claire Martin" },
"project": { "id": "…", "name": "Main website" },
"comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
}
]
}
其他事件名称有 reply_created、status_changed、assigned、comment_edited、reply_edited 和 reply_deleted。根据事件不同,还会有 reply、status(from 和 to)、assignee 或 mentions。文字在 500 个字符处截断;要看完整评论,请打开 link。
当任务报告推进时,会发送 job.state_changed,其中 job 包含 from 和 to(draft、ready、article_waiting、changes_requested、approved 或 posts_delivered),以及 commentId 和 number。退回到 draft 也会发送;Slack 不包含这一条。
验证签名
每次 JSON 投递都有两个请求头:
X-Notiamo-Delivery:与正文中的delivery相同的编号;X-Notiamo-Signature:sha256=后面跟着用你的签名密钥对原始正文计算的 HMAC-SHA256。
请在你这边计算同样的值并比较。如果不一致,就拒绝该请求。
当你的服务器没有响应时
卡片会显示最近一次投递、你的服务器返回的状态码,以及连续失败的次数。Notiamo 会重试:先立即重试,然后在 15、30 和 45 分钟后,之后每小时一次。等待期间不会丢失任何内容。要停止投递,请点击删除。
API 密钥
Notiamo 的 API 密钥就是代理密钥。它们用来访问位于 https://my.notiamo.com/api/mcp 的 MCP 服务器,任何 MCP 客户端都可以用它来列出、读取、回复、指派和更新评论。请在设置 › AI 代理 › 代理密钥中创建,可以是只读或完全权限,适用于所有项目或某一个项目。支持登录(OAuth)的 MCP 客户端不需要密钥。见连接 AI 代理。
要把一个项目的所有评论导出为文件,请打开项目页面,点击导出 CSV 或导出 JSON。