Webhook 会在几秒钟内把你项目上的每次变化告诉另一个系统。只有管理员可以添加。

添加 Webhook

  1. 在侧边栏中打开设置 › AI 代理,找到 Webhook 和 Slack 卡片。
  2. 粘贴要接收事件的地址。它必须以 https:// 开头,并且能从互联网访问。
  3. 选择格式:
    • JSON,带签名:用于你自己的代码、Zapier、Make、n8n 等工具;
    • Slack incoming webhook:在 Slack 频道中,每个事件一行易读的文字。
  4. 点击添加 Webhook。

“设置 › AI 代理”中的“Webhook 和 Slack”卡片:添加地址的表单,以及一个带最近一次投递的 Webhook。“设置 › AI 代理”中的“Webhook 和 Slack”卡片:添加地址的表单,以及一个带最近一次投递的 Webhook。

对于 JSON,请现在复制签名密钥。它不会再次显示。

发送到 Slack

  1. 在 Slack 中,为你想要的频道创建一个 incoming webhook。Slack 会给你一个以 https://hooks.slack.com/ 开头的地址。
  2. 在 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。