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 토큰을 보유한다는 것이므로, 고객이 OAuth를 두 번 만들 필요가 없습니다. 우리는 M2에서 이를 복제합니다: POST /api/v1/calendar/connect/google과 /connect/microsoft는 사용자가 클릭하는 리다이렉트 URL을 반환합니다. 성공 시 우리는 불투명한 meetbot_calendar_user_id를 돌려주고 당신은 자신 측에 저장합니다. 우리는 그들의 리프레시 토큰을 보유하고, 테넌트별 KMS 파생 키로 정적 암호화합니다.
거기서: 백그라운드 작업이 연결된 사용자별 5분마다 Google Calendar Events API와 MS Graph /me/events를 폴링하고, iCalUid로 중복 제거하고, 녹화 규칙을 평가합니다. 규칙은 JSON입니다: "모든 내부 회의 녹화", "내 매니저와의 1:1 건너뛰기", "@customer.com 도메인이 있는 회의는 항상 녹화". 규칙이 일치하면 참여 시간 -90초에 bot을 스케줄링합니다. 직접 dispatch한 것처럼 같은 완료 시 서명된 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
리프레시 토큰이 테넌트별 KMS 파생 키로 암호화. 우리의 DBA는 토큰을 읽을 수 없습니다. 오케스트레이터의 런타임 KMS principal만 읽을 수 있습니다.
Marketplace listings
Google Workspace Marketplace + Microsoft AppSource 인증 목록 (진행 중)으로 사용자가 OAuth 동의 화면에서 앱 이름을 봅니다.