Visão geral
Depois de conectar o Google Calendar, a Agenda mantém tudo em sincronia nos dois sentidos. Este artigo trata do acompanhamento dessa sincronização: como importar eventos que já existiam no Google, o que cada status de sincronização significa, como forçar uma atualização com Sincronizar agora e o que fazer quando o acesso do Google expira e é preciso reconectar.
A sincronização é em tempo quase real, com uma verificação periódica de segurança que reconcilia diferenças. Você não precisa sincronizar manualmente no dia a dia — as opções abaixo servem para inspeção e para casos pontuais.
Pré-requisitos
- Módulo Agenda habilitado e uma conexão Google já criada (veja o artigo de conexão/OAuth).
- Perfil com permissão para gerenciar integrações.
- Ao menos um calendário do Google selecionado para espelhar.
Passo a passo
Importar eventos existentes:
- Abra a Agenda e vá até a conexão do Google.
- Selecione os calendários que deseja espelhar.
- Aguarde a primeira sincronização: os eventos já existentes no Google passam a aparecer na Agenda.
Ver o status e forçar uma atualização:
- Na conexão do Google, verifique o status de sincronização (veja a tabela abaixo).
- Se quiser atualizar na hora, use Sincronizar agora.
Reconectar quando o acesso expira:
- Se o status indicar acesso expirado/revogado, clique em Reconectar.
- Refaça a autorização do Google e conceda as permissões de calendário.
- A sincronização volta a funcionar e a verificação periódica reconcilia o que ficou pendente.
Configurações & opções
- Importar eventos existentes: a primeira sincronização traz para a Agenda os eventos que já estavam no Google.
- Status de sincronização:
| Status | O que significa |
|---|---|
| Conectado / Sincronizado | Tudo em dia; atualizações fluem nos dois sentidos. |
| Sincronizando | Uma sincronização está em andamento (primeira carga ou atualização). |
| Acesso expirado / revogado | O Google revogou o acesso — é preciso reconectar. |
| Erro | Uma falha temporária; a verificação periódica tenta de novo. |
- Sincronizar agora: força uma atualização imediata, sem esperar a verificação periódica. Também destrava uma conexão que ficou presa em "Sincronizando".
- Reconectar: refaz a autorização do Google quando o acesso expira ou é revogado.
- Último erro / erros recentes: o painel mostra a última falha devolvida pelo Google mesmo enquanto o status ainda é "Sincronizando", para você não ficar esperando um processo que já falhou.
O que acontece quando você muda algo direto no Google
Uma alteração feita no Google vale exatamente como uma feita na plataforma. Ao arrastar, editar ou cancelar um compromisso no Google Calendar:
- O cliente é avisado. Um remarcado ou um cancelado dispara o mesmo aviso (WhatsApp/e-mail e
o arquivo
.ics) que uma remarcação feita pelo painel — respeitando os mesmos interruptores de notificação que você já configurou. Se você desligou o aviso de remarcação, ele continua desligado. - Suas automações rodam. Regras e fluxos com gatilho de compromisso criado, remarcado ou cancelado passam a disparar também para mudanças vindas do Google.
- A tela atualiza sozinha. A grade da Agenda reflete a mudança sem recarregar a página.
- Os lembretes do novo horário voltam a valer. Ao arrastar um compromisso para outra data no Google, os lembretes são reprogramados para o novo horário.
- A reserva acompanha. Cancelar no Google também encerra a reserva correspondente, então a página pública do cliente deixa de oferecer "remarcar" para um compromisso que não existe mais.
A primeira importação é silenciosa. Ao espelhar um calendário que já tinha centenas de compromissos, a carga inicial não dispara avisos, automações nem notificações — ela apenas traz o que já existia. Só as mudanças a partir dali são anunciadas.
Importar um compromisso nunca é uma confirmação de agendamento. A plataforma não manda "seu horário está confirmado" para alguém só porque o compromisso apareceu no Google.
Integração Google por tipo de evento
Cada tipo de evento decide, de forma independente, como conversa com o Google. A configuração fica no editor do tipo de evento, na seção Integração Google:
- Bloquear horários ocupados nestes calendários: marque quantos calendários quiser. Nenhum horário já ocupado em qualquer um deles será oferecido na página pública. É assim que você evita ser agendado por cima de um compromisso pessoal que está em outra agenda.
- Criar os eventos em: escolha um calendário do Google para receber os agendamentos confirmados. É nele que o convite e o link do Meet são criados.
Se você não configurar nada, o comportamento continua o de antes: o tipo usa a própria agenda, e só conversa com o Google quando essa agenda é espelhada.
Casos de uso
- Trazer para a Agenda a agenda que já existia no Google, sem redigitar eventos.
- Conferir rapidamente se a conexão está em dia antes de um dia cheio.
- Forçar Sincronizar agora após mexer em vários eventos no Google.
- Restabelecer a sincronização com Reconectar depois que a senha/permissão do Google mudou.
Dicas, limites e boas práticas
- No dia a dia, não é preciso sincronizar manualmente — a sincronização é automática e quase em tempo real.
- Use Sincronizar agora apenas para conferência ou após grandes mudanças no Google.
- Se o status ficar em acesso expirado, reconecte o quanto antes para não perder atualizações.
- Selecione apenas os calendários que realmente quer espelhar — menos ruído na Agenda.
- Eventos criados pela plataforma são marcados internamente para evitar loops de ida e volta.
- Editar um compromisso na plataforma não muda mais o que você configurou só no Google: eventos marcados como "Livre", a visibilidade (privado/confidencial) e as permissões dos convidados são preservados.
Solução de problemas
- Conectei, mas os eventos antigos não vieram: confirme que selecionou ao menos um calendário para espelhar e aguarde a primeira sincronização; use Sincronizar agora para forçar.
- Parei de receber atualizações: o acesso pode ter expirado/sido revogado no Google — use Reconectar.
- Um evento sumiu ou duplicou: a verificação periódica reconcilia diferenças; se persistir, use Sincronizar agora e, em último caso, reconecte a conta.
- O status fica em "Sincronizando" por muito tempo: a primeira carga de uma agenda grande leva alguns minutos, mas não deve passar disso. Se continuar em "Sincronizando", não fique só esperando — abra o painel da conexão e olhe o último erro e a contagem de erros recentes, que agora aparecem mesmo enquanto o status ainda é "Sincronizando". Use Sincronizar agora: ele destrava um estado preso e recomeça a carga. Se o erro persistir, reconecte a conta.
- O status fica em "Erro": o painel mostra a mensagem que o Google devolveu. Erro de acesso (expirado/revogado) só se resolve com Reconectar.
- Parou de sincronizar sozinho depois de alguns dias: se o app OAuth do Google ainda estiver em modo Testing (não verificado), o Google revoga o acesso a cada 7 dias — a conexão vai quebrar semanalmente até o app ser verificado no Google Cloud. Você recebe um aviso por e-mail quando isso acontece; a correção definitiva é publicar/verificar o app.
- Eventos marcados como "Livre" no Google: eles aparecem na Agenda, mas não bloqueiam horários da sua página de agendamento — é o mesmo comportamento do Google.
- Eventos recorrentes: cada ocorrência é importada individualmente, então a série aparece em todas as datas, não só na primeira.