POST /v1/calendar/connect/{provider}
Zwraca jednorazowy URL przekierowania OAuth. provider ∈ {google, microsoft}. State niesie Twój customer_user_id round-trip.
04 · calendar integration api
V1 dostarcza M2 2026Kalendarz wchodzi, boty wychodzą.
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.
przegląd
Dlaczego to istnieje.
Po co to istnieje. Największa fosa Recalla polega na tym, że trzymają tokeny OAuth użytkowników końcowych swoich klientów dla nich, więc klient nie musi budować OAuth dwa razy. Replikujemy to w M2: POST /api/v1/calendar/connect/google i /connect/microsoft zwracają URL przekierowania, który klika Twój użytkownik; przy sukcesie oddajemy nieprzezroczyste meetbot_calendar_user_id, które przechowujesz po swojej stronie. Trzymamy ich refresh token, zaszyfrowany at rest kluczem KMS-derived per tenant.
Stamtąd: zadanie w tle pollu Google Calendar Events API i MS Graph /me/events co pięć minut na podłączonego użytkownika, deduplikuje po iCalUid i ewaluuje Twoje reguły nagrywania. Reguły są JSON-em: „nagrywaj wszystkie wewnętrzne spotkania", „pomijaj 1:1 z moim managerem", „zawsze nagrywaj spotkania z domenami @customer.com". Gdy reguła pasuje, planujemy bota na czas dołączenia minus 90 sekund. Dostajesz ten sam podpisany webhook po ukończeniu, jakbyś sam dispatchował bota.
Multi-tenant z założenia. Twój tenant id, id Twojego użytkownika końcowego, Twoje reguły, Twoja polityka retencji — wszystko izolowane, wszystko widoczne w admin meetbot pod Twoim kontem. Hostowane w EU domyślnie z SCC w DPA; region US dostępny na żądanie. Aplikujemy o weryfikację Google Workspace Marketplace, żeby Twoi użytkownicy końcowi widzieli nazwę Twojej aplikacji na ekranie consent, a nie naszej.
planowany zakres API
Spec, na widoku.
GET /v1/calendar/users/{id}/events
Zsynchronizowane zdarzenia jednego z Twoich użytkowników końcowych. Stronicowane, watermark-able, łącznie z ekstrakcją URL spotkania (Meet/Teams/Zoom).
PUT /v1/calendar/users/{id}/rules
Ustaw reguły nagrywania dla jednego użytkownika. Predykat JSON nad metadanymi zdarzenia: domena, liczba uczestników, organizator, regex tytułu.
Background sync job
Co 5 minut na podłączonego użytkownika. Deduplikuje po iCalUid. Edycje/anulacje propagują się do zaplanowanych dispatchy botów.
Encryption at rest
Refresh tokeny zaszyfrowane kluczami KMS-derived per tenant. Nasi DBA nie mogą czytać Twoich tokenów; tylko runtime KMS principal orchestratora może.
Marketplace listings
Zweryfikowane wpisy Google Workspace Marketplace + Microsoft AppSource (w toku), żeby Twoi użytkownicy widzieli nazwę Twojej aplikacji na ekranie consent OAuth.