# Problemas na Integração com Google Agenda

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/calendarios/problemas-na-integracao-com-google-agenda

Guia para vendedores quando algo dá errado ao conectar, sincronizar ou manter a integração com o Google Agenda.

> Para o passo a passo completo da integração, veja [Integração com Google Agenda](./google-agenda.md).

## Antes de tudo: o que a Unefesta precisa do Google

Na tela de autorização do Google, você precisa **aceitar todas as permissões** solicitadas. Elas permitem que a Unefesta:

- Identifique sua conta (e-mail)
- Veja a lista dos seus calendários
- Leia os calendários que você possui
- Leia e sincronize eventos dos calendários dos quais você é **proprietário**

Se alguma permissão for negada ou desmarcada, a integração pode falhar ou funcionar de forma incompleta.

---

## Problemas na autorização (primeira conexão)

### Clicou em "Cancelar" ou fechou a janela do Google

**O que acontece:** você volta para a Unefesta sem concluir a conexão. O painel continua mostrando "Integração não encontrada".

**O que fazer:**

1. Acesse **Calendário** no painel do vendedor
2. Clique em **Integrar com Google Agenda agora**
3. Na tela do Google, clique em **Continuar** (ou **Permitir**) em todas as etapas

---

### Não marcou todas as permissões na tela do Google

**O que acontece:** o Google pode autorizar parcialmente ou a Unefesta não consegue listar calendários e eventos. Você pode ver erro ao sincronizar ou a lista de calendários do Google vazia ou incompleta.

**O que fazer:**

1. Na página de calendários, clique em **Cancelar autenticação** (se já houver uma conexão parcial)
2. Clique em **Integrar com Google Agenda agora**
3. Na tela de permissões, **marque todas as caixas** e confirme com **Continuar** / **Permitir**

> Dica: se o Google não mostrar a tela de permissões de novo, ao reconectar ele pode usar permissões antigas. Nesse caso, cancele a autenticação na Unefesta e tente integrar novamente — o fluxo solicita consentimento completo.

---

### Usou a conta Google errada

**O que acontece:** a integração funciona, mas os calendários que você esperava não aparecem na lista (porque estão em outra conta Google).

**O que fazer:**

1. Verifique em [myaccount.google.com](https://myaccount.google.com) qual conta está logada no navegador
2. Se necessário, **Cancelar autenticação** na Unefesta e integre de novo escolhendo a conta correta na tela do Google

---

### Mensagem "Código de autenticação não encontrado"

**O que acontece:** você voltou do Google para a Unefesta, mas o endereço da página não trouxe o código necessário (por exemplo, cancelou no Google ou a URL foi alterada).

**O que fazer:**

1. Volte à página de **Calendário**
2. Clique em **Integrar com Google Agenda agora** e conclua o fluxo sem interromper

---

### Demorou muito na tela "Processando autenticação do Google..."

**O que acontece:** após cerca de 30 segundos, a página redireciona automaticamente para Calendário. O código de autorização do Google expira rapidamente; se a conexão demorar, a integração não é concluída.

**O que fazer:**

1. Tente integrar novamente
2. Mantenha a aba aberta até ver a mensagem de sucesso
3. Evite trocar de aba ou fechar o navegador durante o processamento

---

### Mensagem "Integração já realizada"

**O que acontece:** sua conta na Unefesta já possui uma conexão com o Google registrada. O sistema não permite duplicar a integração.

**O que fazer:**

- Se a integração está funcionando: não é necessário conectar de novo
- Se quer trocar de conta Google ou reconectar do zero:
  1. Em **Calendário**, clique em **Cancelar autenticação**
  2. Depois clique em **Integrar com Google Agenda agora**

---

### Erro genérico ao concluir a integração

**O que acontece:** a página de callback do Google falha e você volta ao calendário sem mensagem de sucesso.

**Causas comuns:**

- Código de autorização já utilizado (atualizou a página de callback)
- Sessão expirada na Unefesta (faça login de novo)
- Problema temporário de comunicação com o Google

**O que fazer:**

1. Confirme que está logado na Unefesta
2. Tente integrar novamente **uma única vez** (não recarregue a página de retorno do Google)
3. Se persistir, cancele a autenticação (se existir) e refaça o fluxo

---

## Problemas após conectar (autenticação expirada ou inválida)

### Aviso "A sincronização falhou ou expirou. Tente cancelar e integrar novamente."

**O que acontece:** a Unefesta detectou que a conexão com o Google não está mais válida (Contém erros ou token expirado). Isso ocorre quando:

- Você revogou o acesso da Unefesta nas configurações da conta Google
- A senha da conta Google foi alterada
- O Google invalidou o acesso por segurança (`invalid_grant` / `invalid_token`)
- O token de acesso expirou e não pôde ser renovado

Você também pode receber **e-mail** ou **notificação** no painel com o texto: *"Por favor, refaça a autenticação com o Google."*

**O que fazer:**

1. Acesse **Calendário**
2. Clique em **Cancelar autenticação**
3. Clique em **Integrar com Google Agenda agora** e autorize novamente
4. Se algum calendário estava sincronizado, pode ser necessário **cancelar a sincronização** daquele calendário e **sincronizar de novo** (veja abaixo)

> No onboarding do vendedor, o passo **"Status da Integração com Google Calendar"** fica pendente enquanto houver esse problema.

---

### "Integração não encontrada" (mas você já integrou antes)

**O que acontece:** o registro da integração foi removido (revogação manual ou limpeza após erro).

**O que fazer:**

1. Clique em **Integrar com Google Agenda agora**
2. Reconfigure a sincronização em cada calendário Unefesta que precisar (passos 4 a 11 do [guia principal](./google-agenda.md))

---

## Problemas ao sincronizar um calendário

### "Não autenticado com Google"

**O que fazer:** conclua a integração na página principal de **Calendário** antes de sincronizar um calendário específico.

---

### "Apenas o proprietário pode sincronizar o calendário com Google"

**O que acontece:** você está vendo um calendário **compartilhado** com você por outro vendedor. Calendários compartilhados na Unefesta **não podem** ser sincronizados com o Google pelo convidado.

**O que fazer:** peça ao **dono do calendário** para configurar a sincronização com o Google na conta dele.

---

### Calendário do Google não aparece na lista (ou aparece só como "compartilhado comigo")

**O que acontece:** a Unefesta só permite sincronizar calendários dos quais você é **proprietário** no Google (`accessRole: owner`). Calendários em que você é apenas leitor, editor ou "apenas disponibilidade" **não podem** ser sincronizados.

**O que fazer:**

- Escolha um calendário da qual você é **proprietário** (incluindo o calendário principal da conta)
- Se o calendário desejado pertence a outra pessoa, peça que ela compartilhe com permissão de proprietário ou use a conta que criou o calendário

---

### "Calendário não encontrado na listagem do Google"

**O que acontece:** o calendário selecionado não está mais disponível na sua conta Google (foi excluído, descompartilhado ou a integração perdeu acesso).

**O que fazer:**

1. Verifique no [Google Agenda](https://calendar.google.com) se o calendário ainda existe
2. **Cancele a autenticação** e integre de novo, se necessário
3. Selecione outro calendário do Google na página de detalhes do calendário Unefesta

---

### "Sincronização em andamento"

**O que acontece:** já existe uma sincronização sendo processada para esse calendário (`awaitingSync`). A primeira sincronização pode levar alguns minutos; você receberá **e-mail** quando terminar.

**O que fazer:**

- Aguarde o e-mail de conclusão
- Não clique em **Sincronizar Eventos** repetidas vezes
- Se passou muito tempo (mais de 1 hora) sem retorno, entre em contato com o suporte informando o ID do calendário

---

### E-mail de sincronização com erro / falha

**O que acontece:** a sincronização inicial ou uma atualização falhou. O e-mail traz o link para **Eventos importados** e uma descrição do erro.

**Causas comuns:**

- Token do Google inválido (refaça a autenticação — veja seção acima)
- Calendário do Google removido ou sem permissão
- Muitos eventos ou instabilidade temporária da API do Google

**O que fazer:**

1. Abra o link do e-mail ou vá em **Ver Eventos Importados** no calendário
2. Corrija a autenticação com o Google, se necessário
3. **Cancele a sincronização** do calendário
4. **Exclua eventos importados** (se houver dados inconsistentes)
5. **Sincronize Eventos** novamente

---

### Sincronizou, mas alterações futuras não aparecem

**O que acontece:** a importação inicial funcionou, mas o "watch" (monitoramento de alterações) não foi ativado. A mensagem interna indica: *"Calendário sincronizado mas não será possível receber novas atualizações."*

**O que fazer:**

1. Na página do calendário, clique em **Cancelar Sincronização**
2. Clique em **Sincronizar Eventos** de novo
3. Se o problema continuar, **Cancele autenticação** na página principal de Calendário e integre novamente

---

### Notificação "ERRO AO CRIAR EVENTO NO GOOGLE"

**O que acontece:** durante a sincronização, a Unefesta tentou enviar para o Google um bloqueio que já existia na Unefesta, mas o Google recusou ou falhou.

**O que fazer:**

- O bloqueio **permanece na Unefesta**; adicione manualmente o compromisso equivalente no Google Agenda, se quiser mantê-lo nos dois lugares
- Verifique se a autenticação com o Google está válida

---

## Problemas ao cancelar sincronização ou remover eventos

### "Calendário compartilhado. Não é possível cancelar a sincronização."

**O que acontece:** o calendário Unefesta está compartilhado com outro usuário. Por segurança, é preciso remover o compartilhamento antes de desvincular o Google.

**O que fazer:**

1. Na página do calendário, remova todos os **compartilhamentos** (usuários com acesso)
2. Depois clique em **Cancelar Sincronização**

---

### "Sincronização já foi cancelada anteriormente"

**O que acontece:** esse calendário Unefesta já não está vinculado a nenhum calendário do Google.

**O que fazer:** se