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

Problemas de Conexão

Chave de API Inválida

Problema: Eventos não carregando ou falha na sincronização Solução:
  • Verifique se a chave de API está ativa na 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 Carregando

Problema: O dropdown 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 da chave de API para acionar o carregamento dos eventos
  • Atualize a página se os eventos ainda não aparecerem
  • Verifique se você tem eventos criados na Cal.com

Problemas de Sincronização

Falha na Sincronização do Evento

Problema: O botão “Sincronizar Evento” falha ou mostra erro Solução:
  1. Clique no botão “Solução de 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 eventos da Cal.com

Erros de Configuração de Campos

Problema: Recebendo erros sobre campos obrigatórios ou campos ausentes Solução:
  • Clique em “Solução de Problemas” para redefinir os campos
  • Apenas nome, e-mail 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 bem-sucedidas, mas o cliente não recebe o convite Solução:
  • Defina a variável email nas configurações do assistente
  • Passe o e-mail do cliente ao criar leads
  • Verifique se o formato do e-mail é válido

Número de Telefone Ausente

Problema: O número de telefone não aparece nos eventos do calendário Solução:
  • Clique no botão “Sincronizar Evento” ou “Solução de 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 na Reserva

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

Problemas de Teste

Reservas de Chamadas pela Web Falham

Problema: Reservas funcionam de forma inconsistente com chamadas pela web Solução:
  • Use chamadas telefônicas reais para testes (não chamadas pela web)
  • Chamadas pela web podem não passar a variável de telefone corretamente
  • Ao usar chamadas pela web, forneça o telefone no formato internacional com o prefixo + (por exemplo, “+1 555-123-4567”)
  • Chamadas telefônicas garantem que todas as variáveis sejam transmitidas corretamente

Vários Calendários Não Funcionando

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 eventos distintos (por exemplo, “15min”, “30min”)
  • Sincronize cada evento separadamente após adicionar

Obtendo Ajuda

Se os problemas persistirem:
  1. Verifique as transcrições das chamadas para tentativas de reserva
  2. Verifique se o evento da Cal.com aparece no painel da Cal.com
  3. Teste com uma reserva de 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 do evento da Cal.com
    • Transcrição da chamada mostrando a tentativa de reserva