POST /v1/calendar/connect/{provider}
返回一次性 OAuth 重定向 URL。provider ∈ {google, microsoft}。State 携带您的 customer_user_id 往返。
04 · calendar integration api
V1 在 M2 2026 推出日历进入， 机器人输出。
Connect your users' Google Calendar or Outlook account once. We sync events, evaluate the rules you defined, and dispatch a recording bot at the right minute. Free — you only pay for the $0.30/hr of recording you actually consume.
概述
为何存在。
为什么有这个。Recall 最大的护城河是他们为客户保管客户终端用户的 OAuth token，所以客户不必构建两次 OAuth。我们在 M2 复制这一点：POST /api/v1/calendar/connect/google 和 /connect/microsoft 返回您的用户点击的重定向 URL；成功时我们交回一个不透明的 meetbot_calendar_user_id 您在自己一侧存储。我们保留他们的 refresh token，用每租户 KMS 派生密钥静态加密。
从那里：后台任务每 5 分钟为每个连接的用户轮询 Google Calendar Events API 和 MS Graph /me/events，按 iCalUid 去重，评估您的录制规则。规则是 JSON：“录制所有内部会议”、“跳过与我经理的 1:1”、“始终录制带 @customer.com 域的会议”。规则匹配时，我们把 bot 调度到加入时间减 90 秒。您收到与自己 dispatch bot 时同样的完成签名 webhook。
按设计多租户。您的租户 id、您终端用户的 id、您的规则、您的保留策略——全部隔离，全部在您账号下的 meetbot 管理界面中可见。默认 EU 托管，DPA 中带 SCC；US 区域按需。我们正在申请 Google Workspace Marketplace 验证，以便您的终端用户在同意屏上看到您的应用名，而不是我们的。
计划中的接口
Spec, 公开。
GET /v1/calendar/users/{id}/events
您终端用户中一个的同步事件。可分页、可 watermark，包括会议 URL 提取 (Meet/Teams/Zoom)。
PUT /v1/calendar/users/{id}/rules
为一个用户设置录制规则。事件元数据上的 JSON 谓词：域名、参会者数量、组织者、标题 regex。
Background sync job
每个连接的用户每 5 分钟。按 iCalUid 去重。编辑/取消传播到调度的 bot dispatch。
Encryption at rest
Refresh token 用每租户 KMS 派生密钥加密。我们的 DBA 无法读取您的 token；只有 orchestrator 的运行时 KMS principal 能读。
Marketplace listings
Google Workspace Marketplace + Microsoft AppSource 验证列表 (进行中) 让您的用户在 OAuth 同意屏上看到您的应用名。