Webhook

Webhook 让 Insighto 在你每次创建、更新或删除笔记时，自动把这条笔记 POST 到你指定的地址——不用轮询、不用写抓取脚本，可以顺手接进 IFTTT、n8n、飞书机器人或你自己的服务里。

配置一个 Webhook

1. 打开「设置 → Webhook」。
2. 点「创建 Webhook」，填一个名称，以及接收数据的 URL（需要能从公网访问）。
3. 保存后即刻生效，之后每次笔记变动都会推送到这个地址。

可创建的 Webhook 数量按会员档位：免费版不开放，PRO 最多 5 个，MAX 最多 20 个。

什么时候会触发

三类笔记事件会触发推送，用载荷里的 activityType 区分：

1. memos.memo.created —— 新建一条笔记时。
2. memos.memo.updated —— 编辑已有笔记时。
3. memos.memo.deleted —— 删除笔记时。

推送的数据长什么样

Insighto 会向你的 URL 发一个 POST，请求体是一段 JSON，包含事件类型、创建者，以及笔记本身：

{
  "url": "https://your-service.example.com/hook",
  "activityType": "memos.memo.created",
  "creator": "users/123",
  "memo": {
    "name": "memos/456",
    "state": 1,
    "creator": "users/123",
    "content": "想到就记 #insighto",
    "visibility": 1,
    "create_time": { "seconds": 1730000000 }
  }
}

解析时注意 memo 里的几个约定：字段名是 snake_case；state 和 visibility 是枚举数字（state：1=正常、2=归档；visibility：1=私密、2=互链、3=公开）；时间是 { "seconds": Unix 秒 } 的形式。