POST /v1/calendar/connect/{provider}
Gibt eine einmalige OAuth-Redirect-URL zurück. provider ∈ {google, microsoft}. State trägt Ihre customer_user_id Round-Trip.
04 · calendar integration api
V1 liefert M2 2026Calendar rein, Bots raus.
Verbinden Sie das Google-Calendar- oder Outlook-Konto Ihrer Nutzer einmal. Wir syncen Events, evaluieren die von Ihnen definierten Regeln und dispatchen einen Recording-Bot zur richtigen Minute. Kostenlos — Sie zahlen nur die $0,30/Std Recording, die Sie tatsächlich verbrauchen.
übersicht
Warum es das gibt.
Warum es das gibt. Recalls größter Burggraben ist, dass sie die OAuth-Tokens der Endnutzer ihrer Kunden für sie halten, sodass der Kunde OAuth nie zweimal bauen muss. Wir replizieren das in M2: POST /api/v1/calendar/connect/google und /connect/microsoft geben eine Redirect-URL zurück, die Ihr Nutzer klickt; bei Erfolg geben wir eine opake meetbot_calendar_user_id zurück, die Sie auf Ihrer Seite speichern. Wir behalten ihren Refresh-Token, im Ruhezustand mit einem Pro-Tenant-KMS-abgeleiteten Schlüssel verschlüsselt.
Von dort: ein Hintergrund-Job pollt die Google Calendar Events API und MS Graph /me/events alle fünf Minuten pro verbundenem Nutzer, dedupliziert nach iCalUid und evaluiert Ihre Recording-Regeln. Regeln sind JSON: «alle internen Meetings aufnehmen», «1:1s mit meinem Manager überspringen», «immer Meetings mit @customer.com-Domains aufnehmen». Wenn eine Regel matcht, planen wir den Bot für Beitrittszeit minus 90 Sekunden. Sie bekommen den gleichen signierten Webhook bei Abschluss, als hätten Sie den Bot selbst dispatched.
Multi-Tenant by Design. Ihre Tenant-ID, die ID Ihres Endnutzers, Ihre Regeln, Ihre Retention-Policy — alle isoliert, alle sichtbar im meetbot-Admin unter Ihrem Konto. Standardmäßig in der EU gehostet mit SCCs im DPA; US-Region auf Anfrage verfügbar. Wir bewerben uns für die Google Workspace Marketplace-Verifizierung, damit Ihre Endnutzer Ihren App-Namen im Zustimmungs-Screen sehen, nicht unseren.
geplante Oberfläche
Spec, offen gelegt.
GET /v1/calendar/users/{id}/events
Gesyncte Events für einen Ihrer Endnutzer. Paginiert, watermark-able, inkludiert Meeting-URL-Extraktion (Meet/Teams/Zoom).
PUT /v1/calendar/users/{id}/rules
Setzt die Recording-Regeln für einen Nutzer. JSON-Predicate über Event-Metadaten: Domain, Teilnehmerzahl, Organizer, Title-Regex.
Background-Sync-Job
Alle 5 Minuten pro verbundenem Nutzer. Dedupliziert nach iCalUid. Edits/Stornierungen propagieren zu geplanten Bot-Dispatches.
Verschlüsselung im Ruhezustand
Refresh-Tokens mit Pro-Tenant-KMS-abgeleiteten Schlüsseln verschlüsselt. Unsere DBAs können Ihre Tokens nicht lesen; nur das Runtime-KMS-Principal des Orchestrators kann.
Marketplace-Listings
Verifizierte Google Workspace Marketplace + Microsoft AppSource-Listings (in Arbeit), damit Ihre Nutzer Ihren App-Namen im OAuth-Zustimmungs-Screen sehen.