Skip to main content
Soluções para problemas comuns de integração com Cal.com.

Problemas de Conexão

Chave de API Inválida

Problema: Eventos não carregam ou a sincronização falha Solução:
  • Verifique se a chave de API está ativa em Cal.com → Configurações → Desenvolvedor → Chaves de API
  • Certifique-se de que a chave inclui o prefixo cal_live_
  • Gere uma nova chave de API se necessário

Eventos Não Carregam

Problema: Menu suspenso de eventos está vazio após inserir a chave de API Solução:
  • Verifique se a chave de API está correta
  • Clique fora do campo de chave de API para acionar o carregamento de eventos
  • Atualize a página se os eventos ainda não aparecerem
  • Verifique se você tem eventos criados no Cal.com

Problemas de Sincronização

Falha ao Sincronizar Evento

Problema: Botão “Sincronizar Evento” falha ou mostra erro Solução:
  1. Clique no botão “Solucionar Problemas” em vez disso
  2. Isso redefine todos os campos de reserva para a configuração correta
  3. Verifique as alterações nas configurações de evento do Cal.com

Erros de Configuração de Campo

Problema: Recebendo erros sobre campos obrigatórios ou campos ausentes Solução:
  • Clique em “Solucionar Problemas” para redefinir os campos
  • Apenas nome, email e telefone devem ser obrigatórios
  • Todos os outros campos (localização, convidados, etc.) devem ser opcionais

Falhas de Reserva

Nenhum Convite de Calendário Enviado

Problema: Reservas têm sucesso, mas o cliente não recebe o convite Solução:

Número de Telefone Ausente

Problema: Número de telefone não aparece nos eventos do calendário Solução:
  • Clique no botão “Sincronizar Evento” ou “Solucionar Problemas”
  • Isso adiciona automaticamente o campo de telefone ao evento
  • O número de telefone é incluído após a sincronização

Problemas de Fuso Horário de Reserva

Problema: Compromissos agendados no horário errado Solução:
  • Verifique o fuso horário nas configurações de evento do Cal.com
  • Verifique se o assistente está obtendo o horário correto do cliente
  • Teste com menções específicas de horário durante a chamada

Problemas de Teste

Reservas de Chamada Web Falham

Problema: Reservas funcionam de forma inconsistente com chamadas web Solução:
  • Use chamadas telefônicas reais para teste (não chamadas web)
  • Chamadas web podem não passar a variável de telefone corretamente
  • Ao usar chamadas web, forneça o telefone em formato internacional com prefixo + (ex: “+55 11 98765-4321”)
  • Chamadas telefônicas garantem que todas as variáveis sejam transmitidas corretamente

Vários Calendários Não Funcionam

Problema: Apenas um calendário funciona ou eventos entram em conflito Solução:
  • Cada calendário deve ter um evento diferente selecionado
  • Use nomes de evento distintos (ex: “15min”, “30min”)
  • Sincronize cada evento separadamente após adicionar

Obtendo Ajuda

Se os problemas persistirem:
  1. Verifique transcrições de chamadas para tentativas de reserva
  2. Verifique se o evento do Cal.com aparece no painel do Cal.com
  3. Teste com uma chamada telefônica simples
  4. Entre em contato com o suporte com:
    • Captura de tela da mensagem de erro
    • Captura de tela das configurações de evento do Cal.com
    • Transcrição da chamada mostrando a tentativa de reserva