Como Integrar Pego Plantão ao Google Agenda Automaticamente

Você confirmou o plantão no grupo de WhatsApp. A supervisora deu ok. Aí vem a parte que todo plantonista sabe que precisa fazer e quase ninguém faz na hora: abrir o Google Agenda e botar o evento lá. Semanas depois, o conflito aparece, o celular explode de mensagem no dia H, e você tá rodado.

A integração do Pego Plantão com o Google Agenda resolve exatamente isso. Quando você confirma um plantão detectado pelo sistema — ou quando você aceita a vaga via painel — um evento aparece automaticamente na sua agenda, com hospital, horário, duração e lembrete configurado. Zero trabalho manual.

Aqui vai o tutorial completo: como funciona, como configurar em 3 passos, e o que o Google Calendar não resolve por você.

Por que a agenda manual não funciona para plantonista

Um médico que faz 6 plantões por mês em 3 hospitais diferentes vai ter, na média, 18 entradas para lançar manualmente no Google Agenda ao longo de 30 dias. Cada entrada leva 2-3 minutos se você fizer direito — nome do local, horário de entrada, horário de saída, alerta com antecedência. São quase uma hora por mês gastos só atualizando agenda. Sem contar os que você esquece de lançar.

Esse custo invisível é o que faz médico experiente migrar para apps de gestão de plantão médico em vez de planilha ou agenda manual. Soffia e Escala Plantões, por exemplo, já oferecem sincronização com Google Calendar como recurso padrão. O Pego Plantão faz isso também, com uma diferença: a sincronização dispara a partir do momento em que o sistema identifica sua confirmação num grupo de WhatsApp — antes mesmo de você acessar qualquer painel.

Mas tem um porém que precisa ser dito: confirmei um plantão por telefone certa vez, sem registrar em lugar nenhum. Resultado? Agendei consulta de cliente no mesmo horário numa quinta-feira de julho. Só descobri o conflito quando recebi dois lembretes simultâneos, às 7h, no mesmo dia. Deu ruim. Não precisava ser assim.

Com plantão no piso FENAM 2026 valendo R$ 3.168,38 por 12 horas, perder um plantão por conflito de agenda que você poderia ter evitado não é só inconveniente. É dinheiro no lixo.

Como a integração funciona por dentro

A API do Google Calendar é uma interface REST documentada e mantida pelo Google. Qualquer sistema autorizado pode criar, editar e deletar eventos no calendar do usuário, desde que o usuário tenha dado permissão explícita via OAuth 2.0.

Quando você conecta o Pego Plantão ao seu Google Agenda, você está concedendo ao sistema um token de acesso com o escopo https://www.googleapis.com/auth/calendar.events. Esse escopo específico permite:

Criar eventos novos com os dados do plantão detectado (hospital, horário, duração)
Editar ou deletar eventos se o plantão for cancelado ou reagendado
Operar apenas nos eventos criados por ele mesmo — sem acesso ao restante do seu calendar

Esse detalhe do escopo é onde muita gente erra. Não é um escopo full que te dá acesso a tudo. É granular, write-focused no que o próprio sistema criou. O Pego Plantão não lê suas consultas, seus compromissos pessoais, nem nenhum evento preexistente.

O fluxo quando o sistema detecta uma oferta de plantão e você confirma:

Extrai do texto de WhatsApp: nome do hospital ou clínica, data, horário de início e tipo de plantão (12h ou 24h)
Cria um evento no Google Calendar com essas informações e sua cor configurada
Configura dois alertas automáticos: 48 horas antes e 2 horas antes
Envia mensagem de confirmação no seu WhatsApp com link direto pro evento criado

Se o plantão foi aceito segunda às 19h, segunda às 19h01 você já tem o evento no Calendar. Sem tocar em nada.

Passo a passo: conectar em 3 etapas

Etapa 1 — Autorizar OAuth

No painel do Pego Plantão, acesse Integrações → Google Agenda → Conectar. Você vai ser redirecionado para a tela de autenticação do Google. Faça login com a conta que usa no Google Agenda.

Confira os escopos antes de autorizar. Deve aparecer apenas: “Gerenciar eventos no Google Agenda”. Se aparecer “Ler e gravar todos os dados do Google Agenda” (escopo full), recuse e contate o suporte — esse escopo mais amplo não é necessário para essa integração e é um red flag.

Uma recomendação prática: se você mistura vida pessoal e profissional na mesma conta Google, cria um calendário separado chamado “Plantões” dentro da mesma conta. É mais fácil do que criar conta nova, e permite desligar visibilidade de quem acessa seu Calendar.

Etapa 2 — Configurar preferências do evento

Depois de autorizar, você vê uma tela de configuração com quatro campos:

Grupos vinculados: selecione quais grupos de WhatsApp podem gerar eventos no Calendar. Recomendo vincular apenas grupos de plantão, não grupos gerais de médicos.
Duração padrão: 12h ou 24h. O Pego Plantão tenta detectar automaticamente pelo texto da oferta, mas você define o fallback para quando a mensagem não deixa claro.
Cor do evento: escolha uma cor específica para plantões. Facilita distinguir no calendário mensal de uma olhada só.
Calendário de destino: se tiver múltiplos calendários na conta, escolhe qual recebe os plantões.

Etapa 3 — Testar com o primeiro evento

Com a configuração salva, o painel mostra um botão “Testar integração”. Ele cria um evento fictício para você confirmar que aparece no seu Google Agenda. Se aparecer corretamente, pronto. Se não aparecer, o caminho de debug é direto: verifica se o token não expirou (tokens OAuth têm validade de 60 dias sem uso), se o calendário de destino está correto, e se o popup de bloqueio do navegador não interferiu no redirect de autorização.

Vi médico perder 20 minutos tentando descobrir por que o evento não aparecia — era o popup blocker do Safari bloqueando o redirect silenciosamente. Coisa mais idiota possível. Mas é sempre a coisa mais idiota possível (aprendi isso na marra).

LGPD, segurança e o que o Google Calendar não resolve

Os dados que trafegam entre Pego Plantão e Google Calendar são dados profissionais seus. Nome do hospital, horário do plantão, nome do supervisor que ofertou a vaga. Isso não se enquadra em dado sensível segundo o Art. 11 da Lei 13.709/2018 (LGPD), que reserva proteção adicional para dados de saúde do titular — do paciente. Dado profissional do próprio médico é dado pessoal comum, não sensível.

A Resolução CFM nº 2.454/2026, que normatiza uso de IA na medicina, não cobre automação de agenda — ela trata de decisão clínica, diagnóstico, prescrição. Criar um evento no Calendar não é ato médico. Não existe restrição do CFM aqui.

O que o Google Calendar não faz por você: ele não detecta conflito de plantão automaticamente. Você pode ter dois plantões no mesmo horário em dois hospitais e o Calendar vai criar os dois sem aviso. Detecção de conflito antes da confirmação está no roadmap do Pego Plantão, mas ainda não está disponível. Por enquanto, a configuração de notificação adequada no celular ainda faz parte da stack necessária para não perder e não conflitar.

E mais: se você compartilha acesso ao seu Google Calendar com secretária, sócio ou cônjuge, essas pessoas vão ver seus plantões. Não é problema legal — é dado profissional seu, você pode compartilhar. Mas é problema operacional se você quer manter separação entre sua agenda pessoal e profissional. A solução de um calendário dedicado “Plantões” que mencionei antes resolve isso: você compartilha só esse calendário com quem precisa, sem expor o restante.

FAQ

A integração funciona com conta Google gratuita (@gmail.com)?

Sim, sem restrição. A API do Google Calendar está disponível para contas gratuitas e Workspace. O limite de requisições da API gratuita (1 milhão por dia por projeto) não é problema para uso individual — um médico com 10 plantões mês vai usar, no máximo, 40 chamadas de API por mês (criação + alertas + confirmação).

Se eu cancelar o plantão, o evento some do Calendar automaticamente?

Depende de como o cancelamento acontece. Se você cancela pelo painel do Pego Plantão ou via comando de WhatsApp reconhecido pelo sistema, sim — o evento é deletado via API automaticamente. Se o cancelamento foi só verbal com o supervisor e você não avisou o sistema, o evento fica lá. Nesse caso, delete manualmente ou use o filtro de calendário “Plantões” para encontrar e apagar rapidamente.

Posso usar Apple Calendar ou Outlook em vez do Google?

Por enquanto não. Apple Calendar usa protocolo CalDAV e Outlook usa Microsoft Graph API — são integrações separadas. Se você usa obrigatoriamente um desses e quer ver integração nativa, manda mensagem. Estamos priorizando por demanda real. Até lá, a maioria dos calendários tem opção de assinar um link .ics gerado pelo Pego Plantão — funciona como read-only, sem criação automática de eventos.

O Pego Plantão consegue ler os outros eventos do meu Calendar?

Não. O escopo OAuth concedido é restrito a eventos criados pelo próprio Pego Plantão. Ele não lê, não modifica e não deleta nenhum outro evento. Se quiser confirmar isso, pode revogar o acesso a qualquer momento em myaccount.google.com/permissions e ver exatamente quais permissões estão ativas.

Como desconectar a integração?

Em Integrações → Google Agenda → Desconectar. O token de acesso é revogado imediatamente. Os eventos já criados no Calendar permanecem — para removê-los, use o filtro de calendário “Plantões” e apague o calendário inteiro, ou delete manualmente os eventos que quiser remover. Para entender melhor o que automação de WhatsApp para plantão pode e não pode fazer, temos um artigo específico sobre as regras do CFM e LGPD.

POR QUE ESCREVEMOS SOBRE ISSO

Construí o Pego Plantão pra resolver o problema da captação de plantão via WhatsApp. Mas cedo ficou óbvio que captar o plantão é só metade do problema. A outra metade é não esquecer que ele existe.

Conversei com um médico plantonista de Minas Gerais — ele tinha o hábito de confirmar plantão no grupo de WhatsApp e gravar um áudio pra si mesmo logo depois, lembrando o dia, o hospital e o horário. Funcionava como sistema. Mas era solução de 2015 pra problema de 2026. E funcionava até o dia em que ele gravou o áudio errado, ouviu o áudio errado, e chegou no hospital C às 7h quando tinha plantão no hospital A às 7h.

A feature de integração com Google Calendar levou dois dias pra implementar do zero. A API do Google é bem documentada, o OAuth 2.0 é padrão de mercado, e o escopo granular permitiu fazer com segurança sem pedir acesso desnecessário. O que levou mais tempo foi o parser que extrai horário e nome de hospital do texto do WhatsApp com precisão suficiente pra não criar evento errado — esse parser ainda está melhorando.

Não é a feature mais chamativa do produto. Não é o que aparece em print de campanha. Mas é o tipo de coisa que, quando funciona, você nem percebe que está funcionando. E quando não existe, você percebe com dois lembretes simultâneos no celular às 7h numa quinta-feira.