SuperAPI AI 工具集

granola-webhooks-events

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:Granola 不提供原始 Webhook 端点,事件驱动自动化须经 Zapier 转发。本技能介绍其事件模型、负载结构、过滤、处理模式与自定义事件处理器构建,适用于实时通知、会议事件处理等场景。

主要能力与事件模型:Zapier 提供两个触发器——“Note Added to Granola Folder”(笔记自动进入指定文件夹)和“Note Shared to Zapier”(手动点击分享)。负载字段包括 title、creator_name、creator_email、attendees(含 name/email)、calendar_event_title、calendar_event_datetime、note_content,可用于区分内外会议、匹配会议类型关键词、搜索行动项。

使用方式:在 Zapier 用 Filter 步骤按 attendee 邮箱、标题关键词、note_content 含“- [ ]”等条件路由;也可将事件经 Webhooks by Zapier 以 POST JSON 转发到自建端点(如 Express.js 或 FastAPI),在处理器中解析行动项并按会议类型分发。处理模式分即时、批量、条件、幂等四种。Zapier 对失败动作自动重试;自定义端点建议用 note ID 去重实现幂等,超时则先返回 200 再异步处理。

限制:需 Granola Business 套餐才能访问 Zapier;触发不匹配文件夹名(区分大小写)不触发;笔记仍在处理时 note_content 可能为空;日历事件无参会人列表时无参会人数据;示例中的域名与合成事件仅作演示。