事件
共 60 种事件类型，组织中有变化时投递到您的 Webhook。可以订阅具体类型，也可以订阅 card.* 这样的通配符。
卡片
- card.archived卡片已归档
- card.created卡片已创建
- card.deleted卡片已删除
- card.index_failed卡片索引失败
- card.indexed卡片已索引
- card.moved卡片已移动
- card.published草稿已作为新卡片发布
- card.restored卡片已恢复
- card.updated卡片已更新
核实
- card.unverified卡片的可信状态已撤销
- card.verified卡片已核实
- verification.expired核实已过期
- verification.requested已请求核实
合集与文件夹
- collection.created合集已创建
- collection.deleted合集已删除
- collection.updated合集已更新
- folder.created文件夹已创建
- folder.deleted文件夹已删除
- folder.updated文件夹已更新
协作
- announcement.read公告已读
- announcement.sent公告已发送
- comment.created评论已添加
- comment.resolved评论串已解决
- draft.approved草稿已批准
- draft.created草稿已创建
- draft.publish_requested已申请发布审批
问题与回答
- access_request.created已申请访问
- access_request.resolved访问申请已处理
- gap.detected已发现知识缺口
- question.answered问题已回答
- question.feedback_created回答已评分
- question.unanswered问题未得到回答
人员与访问权限
- api_key.createdAPI 密钥已创建
- api_key.expiringAPI 密钥即将过期
- api_key.revokedAPI 密钥已撤销
- app.authorized应用已获授权
- app.revoked应用授权已撤销
- group.created用户组已创建
- group.deleted用户组已删除
- group.member_added用户组成员已添加
- group.member_removed用户组成员已移除
- group.updated用户组已更新
- user.created用户已创建
- user.deactivated用户已停用
- user.offboarded已为用户办理离职交接
- user.updated用户已更新
数据源与导入
- import.document_failed导入文档失败
- import.sync_completed导入同步已完成
- source.connection_lost数据源连接已断开
- source.sync_completed数据源同步已完成
- source.sync_failed数据源同步失败
作业与导出
- export.ready导出已就绪
- job.completed作业已完成
- job.failed作业失败
计费
- credits.low点数不足
- invoice.issued发票已开具
- invoice.paid发票已付款
- subscription.updated订阅已更新
Webhook 服务事件
- webhook.endpoint_disabledWebhook 已停用
- webhook.ping测试事件
接收事件
每次投递都是向 Webhook 接收地址发送的 POST 请求，请求体就是这个 JSON。先验证 webhook-signature 头（Standard Webhooks），再信任请求体；在几秒内返回 2xx 状态，之后再处理。投递到同一个 Webhook 的事件保持原有顺序；投递失败时按逐渐拉长的间隔重试。
随时可能新增事件类型和字段：跳过不认识的类型和字段。