POST /v1/calendar/connect/{provider}
Devolve URL de redirecionamento OAuth de uso único. provider ∈ {google, microsoft}. State carrega seu customer_user_id ida e volta.
04 · calendar integration api
V1 chega M2 2026Calendário entra, bots saem.
Conecte a conta Google Calendar ou Outlook dos seus usuários uma vez. Sincronizamos eventos, avaliamos as regras que você definiu, e despachamos bot de gravação no minuto certo. Grátis — você só paga os $0,30/h de gravação que de fato consome.
visão geral
Por que isso existe.
Por que existe. O maior fosso do Recall é que custodiam tokens OAuth dos usuários finais dos clientes deles, então o cliente nunca precisa construir OAuth duas vezes. Replicamos em M2: POST /api/v1/calendar/connect/google e /connect/microsoft devolvem URL de redirecionamento que seu usuário clica; no sucesso devolvemos um meetbot_calendar_user_id opaco que você guarda do seu lado. Mantemos o refresh token, criptografado em repouso com chave derivada de KMS por tenant.
Daí: job em background sonda Google Calendar Events API e MS Graph /me/events a cada cinco minutos por usuário conectado, dedupica por iCalUid, e avalia suas regras de gravação. Regras são JSON: «grave todas as reuniões internas», «pule 1:1s com meu manager», «sempre grave reuniões com domínios @customer.com». Quando regra casa, agendamos o bot para hora-de-entrada menos 90 segundos. Você recebe o mesmo webhook assinado ao completar como se tivesse despachado o bot.
Multi-tenant por design. Seu id de tenant, id do seu usuário final, suas regras, sua política de retenção — tudo isolado, tudo visível no admin meetbot sob sua conta. Hospedado na UE por padrão com SCCs no DPA; região US disponível sob solicitação. Estamos solicitando verificação Google Workspace Marketplace para seus usuários finais verem nome do seu app na tela de consentimento, não o nosso.
superfície planejada
Spec, à mostra.
GET /v1/calendar/users/{id}/events
Eventos sincronizados para um dos seus usuários finais. Paginado, watermark-able, inclui extração de URL de reunião (Meet/Teams/Zoom).
PUT /v1/calendar/users/{id}/rules
Define regras de gravação para um usuário. Predicado JSON sobre metadados de evento: domínio, contagem de participantes, organizador, regex de título.
Job de sincronização em background
A cada 5 minutos por usuário conectado. Dedupica por iCalUid. Edições/cancelamentos propagam pra despachos de bot agendados.
Criptografia em repouso
Refresh tokens criptografados com chaves derivadas de KMS por tenant. Nossos DBAs não podem ler seus tokens; só o principal KMS de runtime do orquestrador pode.
Listagens em marketplace
Listagens verificadas Google Workspace Marketplace + Microsoft AppSource (em progresso) para seus usuários verem nome do seu app na tela de consentimento OAuth.