POST /v1/calendar/connect/{provider}
Возвращает одноразовый URL OAuth-редиректа. provider ∈ {google, microsoft}. State несёт ваш customer_user_id round-trip.
04 · calendar integration api
V1 выходит M2 2026Connect 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, который вы храните у себя. Их refresh-токен мы храним зашифрованным at rest ключом, выведенным из per-tenant KMS.
Дальше: фоновая задача опрашивает Google Calendar Events API и MS Graph /me/events каждые пять минут на подключённого пользователя, дедуплицирует по iCalUid и оценивает ваши правила записи. Правила — это JSON: «записать все внутренние встречи», «пропустить 1:1 с моим менеджером», «всегда записывать встречи с доменами @customer.com». Когда правило срабатывает, мы планируем бота на время начала минус 90 секунд. Вы получаете тот же подписанный webhook на завершение, как если бы dispatch-или бота сами.
Multi-tenant по дизайну. Ваш tenant id, id вашего конечного пользователя, ваши правила, ваша политика удержания — всё изолировано, всё видно в админке meetbot под вашим аккаунтом. По умолчанию хостинг в EU с SCC в DPA; регион США — по запросу. Мы подаёмся на верификацию Google Workspace Marketplace, чтобы ваши конечные пользователи видели имя вашего приложения на consent screen, а не нашего.
планируемая поверхность
Возвращает одноразовый URL OAuth-редиректа. provider ∈ {google, microsoft}. State несёт ваш customer_user_id round-trip.
Синхронизированные события для одного из ваших конечных пользователей. С пагинацией, watermark-able, включает извлечение URL встреч (Meet/Teams/Zoom).
Установка правил записи для одного пользователя. JSON-предикат над метаданными события: домен, число участников, организатор, regex заголовка.
Каждые 5 минут на подключённого пользователя. Дедупликация по iCalUid. Правки/отмены распространяются на запланированные dispatch-и ботов.
Refresh-токены зашифрованы ключами, выведенными из per-tenant KMS. Наши DBA не могут читать ваши токены; только runtime KMS principal оркестратора может.
Верифицированные листинги Google Workspace Marketplace + Microsoft AppSource (в процессе), чтобы ваши пользователи видели имя вашего приложения на consent screen OAuth.