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.
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:
- Acesse Calendário no painel do vendedor
- Clique em Integrar com Google Agenda agora
- 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:
- Na página de calendários, clique em Cancelar autenticação (se já houver uma conexão parcial)
- Clique em Integrar com Google Agenda agora
- 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:
- Verifique em myaccount.google.com qual conta está logada no navegador
- 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:
- Volte à página de Calendário
- 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:
- Tente integrar novamente
- Mantenha a aba aberta até ver a mensagem de sucesso
- 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:
- Em Calendário, clique em Cancelar autenticação
- 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:
- Confirme que está logado na Unefesta
- Tente integrar novamente uma única vez (não recarregue a página de retorno do Google)
- 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:
- Acesse Calendário
- Clique em Cancelar autenticação
- Clique em Integrar com Google Agenda agora e autorize novamente
- 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:
- Clique em Integrar com Google Agenda agora
- Reconfigure a sincronização em cada calendário Unefesta que precisar (passos 4 a 11 do guia principal)
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:
- Verifique no Google Agenda se o calendário ainda existe
- Cancele a autenticação e integre de novo, se necessário
- 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:
- Abra o link do e-mail ou vá em Ver Eventos Importados no calendário
- Corrija a autenticação com o Google, se necessário
- Cancele a sincronização do calendário
- Exclua eventos importados (se houver dados inconsistentes)
- 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:
- Na página do calendário, clique em Cancelar Sincronização
- Clique em Sincronizar Eventos de novo
- 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:
- Na página do calendário, remova todos os compartilhamentos (usuários com acesso)
- 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 quiser sincronizar de novo, selecione um calendário do Google e clique em Sincronizar Eventos.
"Por questões de segurança, remova a sincronização com Google antes de excluir todos os eventos"
O que acontece: você tentou Excluir Eventos Importados enquanto a sincronização ainda estava ativa.
O que fazer:
- Clique em Cancelar Sincronização
- Depois clique em Excluir Eventos Importados
Isso remove os eventos apenas na Unefesta; os eventos no Google Agenda não são apagados.
Problemas ao cancelar a autenticação (revogar acesso)
"Erro ao revogar acesso"
O que acontece: falha ao comunicar com o Google para revogar o token.
O que fazer:
- Tente Cancelar autenticação novamente
- Revogue manualmente em myaccount.google.com/permissions o app/conexão da Unefesta
- Se a Unefesta ainda mostrar "Autenticado com Google", atualize a página ou faça logout e login
Revogou no Google, mas a Unefesta ainda mostra conectado
O que acontece: a revogação foi feita direto na conta Google, não pelo botão da Unefesta.
O que fazer:
- Na Unefesta, clique em Cancelar autenticação (pode exibir erro — tente mesmo assim)
- Se necessário, integre de novo
- Calendários que estavam sincronizados precisarão ser reconfigurados
Erro ao listar calendários do Google
O que acontece: na página de Calendário, a lista de calendários do Google não carrega. Você pode receber notificação: "Erro ao listar seus calendários do Google. Tente cancelar a integração e integrar novamente."
O que fazer:
- Cancelar autenticação
- Integrar com Google Agenda agora, aceitando todas as permissões
- Se persistir, teste em outro navegador ou janela anônima (extensões podem bloquear o OAuth)
Lembrete: estoque e bloqueios
A sincronização com o Google bloqueia datas no calendário, mas não reserva estoque automaticamente em produtos/serviços com controle de quantidade.
Para produtos com estoque:
- Configure bloqueios e quantidades na seção Produtos/Serviços relacionados a este calendário, ou
- Use Adicionar Bloqueio no calendário informando a quantidade
Sem isso, o item pode continuar aparecendo como disponível para venda.
Fluxo recomendado para "começar do zero"
Use esta sequência quando nada mais funcionar:
- Em cada calendário Unefesta sincronizado: Cancelar Sincronização
- Se necessário: Excluir Eventos Importados
- Na página principal de Calendário: Cancelar autenticação
- (Opcional) Revogue a Unefesta em myaccount.google.com/permissions
- Integrar com Google Agenda agora — aceite todas as permissões
- Siga o passo a passo completo desde a seleção do calendário do Google
Quando contactar o suporte
Entre em contato informando:
- ID do calendário Unefesta (número exibido na lista, ex.:
# 42) - Conta Google utilizada (e-mail)
- Mensagem de erro exata ou print da tela
- Se recebeu e-mail de falha de sincronização (copie o texto do erro)
Isso ajuda a equipe a verificar logs e webhooks do Google Calendar no servidor.