## 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:**
1. Abra a **Agenda** e vá até a **conexão do Google**.
2. Selecione os **calendários** que deseja espelhar.
3. 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:**
1. Na conexão do Google, verifique o **status de sincronização** (veja a tabela abaixo).
2. Se quiser atualizar na hora, use **Sincronizar agora**.

**Reconectar quando o acesso expira:**
1. Se o status indicar **acesso expirado/revogado**, clique em **Reconectar**.
2. Refaça a **autorização do Google** e conceda as permissões de calendário.
3. 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.

## Veja também

- [Conectar o Google Calendar (OAuth) e sincronização](/hc/ajuda/articles/calendar-scheduling-conectar-google-calendar-pt-br)
- [Excluir ou cancelar um evento: qual usar](/hc/ajuda/articles/calendar-scheduling-excluir-ou-cancelar-evento-pt-br)
- [Reagendar, cancelar, Google Meet e arquivo .ics](/hc/ajuda/articles/calendar-scheduling-reagendar-cancelar-meet-ics-pt-br)
- [Visão geral de Agenda e Agendamentos](/hc/ajuda/articles/calendar-scheduling-overview-pt-br)