用途：Figma Webhooks V2 可在文件变更、评论发布或库发布时推送实时通知，支持按团队、项目或单个文件限定范围。
主要能力：支持 FILE_UPDATE、FILE_DELETE、FILE_VERSION_UPDATE、FILE_COMMENT、LIBRARY_PUBLISH 等事件类型，分别携带 file_key、file_name、version_id、comment、variables 等字段。认证通过每次载荷中回传的 passcode 完成。
使用方式：需准备可公网访问的 HTTPS 端点、具备 webhooks:write 权限的 FIGMA_PAT 以及 Team ID。创建 webhook 使用 POST https://api.figma.com/v2/webhooks，请求头带 X-Figma-Token，请求体包含 event_type、team_id、endpoint、passcode 等。接收端应校验 passcode（建议使用 timingSafeEqual），快速返回 200 后异步处理事件。管理接口包括 GET /v2/webhooks?team_id=、DELETE /v2/webhooks/{id}、PUT /v2/webhooks/{id}。由于 Figma 可能重复投递同一事件，需按 webhook_id 与 timestamp 组合做幂等去重。
适用场景：设计令牌同步、评论转发至 Slack 或创建 Jira 工单、库发布后触发下游重建等。
限制：端点必须为 HTTPS；passcode 配置错误会导致校验失败；投递失败过多会使 webhook 状态变为 PAUSED，需修复端点后重建；旧版事件格式可能缺少 triggered_by 字段。本地测试可用 ngrok http 3000 暴露服务。