Skip to main content
Este guia fornece soluções para problemas comuns encontrados ao integrar o Cal.com com seu assistente de IA

​
Problemas de Agendamento de Compromissos

Erro de Chave de API Ausente Problema: Erro “missing api_key or event_id for Cal.com” Solução:
  • Vá até as configurações do assistente
  • Acesse a seção Agendamento de Compromissos
  • Insira a chave de API correta obtida nas configurações de desenvolvedor do Cal.com
  • Insira o ID do evento correto a partir da URL do evento no Cal.com
  • Clique em Salvar para aplicar a configuração
  • Verifique se a conexão aparece como ativa
Problemas de Conexão Problemas de Configuração da API:
  • Verifique se a chave de API está ativa e possui as permissões corretas no Cal.com
  • Confirme se o ID do evento está correto na URL do evento
  • Certifique-se de que sua conta tenha acesso à conta do Cal.com
Problemas de Configuração de Evento Eventos não sendo agendados:
  • Campos personalizados obrigatórios: Certifique-se de não ter adicionado campos obrigatórios nas configurações do evento no Cal.com. Apenas campos padrão e o campo opcional de telefone são compatíveis.
  • Identificador do campo de telefone: Verifique se o identificador do campo de telefone é exatamente “phone” (diferencia maiúsculas e minúsculas).
  • Disponibilidade do evento: Confira se o evento no Cal.com possui disponibilidade configurada corretamente.
Falhas no Agendamento Compromissos não sendo criados:
  • E-mail obrigatório: Verifique se o assistente possui um e-mail definido nas configurações e se o lead possui um e-mail nas variáveis de entrada ou coletado na conversa.
  • Campo de telefone: Adicione o campo de telefone nas configurações do evento no Cal.com com o identificador “phone”. Consulte Phone Number in Calendar Events para detalhes da configuração.
  • Teste com chamadas reais: Faça chamadas de teste usando ligação telefônica (não chamada web) para garantir o envio correto das variáveis.
  • Fusos horários: Verifique se o fuso horário está configurado corretamente em ambos os sistemas.
  • Registros do assistente: Revise os logs e transcrições de chamadas para identificar tentativas de agendamento.
  • Configurações do evento: Confirme no Cal.com se há restrições de agendamento ativas.
Problemas de Contato com o Cliente Convites de calendário não enviados:
  • Variável de e-mail: Confirme se a variável de e-mail está corretamente configurada nas configurações do assistente.
  • E-mail do lead: Verifique se o e-mail do cliente está sendo transmitido corretamente ao criar o lead.
  • Formato de e-mail: Certifique-se de que os endereços de e-mail estão em formato válido.
Número de telefone não aparece nos eventos:
  • Campo de telefone: Verifique se o campo de telefone está configurado nas configurações do evento no Cal.com com o identificador “phone”. Consulte Phone Number in Calendar Events para detalhes.
  • Método de teste: Use chamadas telefônicas (não chamadas web) para garantir o envio correto da variável de telefone.
Obtendo Ajuda Se essas soluções não resolverem o problema:
  • Verifique as transcrições de chamadas para ver exatamente o que a IA tentou executar.
  • Teste a integração com um agendamento simples via chamada telefônica.
  • Entre em contato com o suporte enviando as mensagens de erro e capturas de tela.
Informações Comuns Solicitadas pelo Suporte:
  • Captura de tela da mensagem de erro
  • Detalhes da configuração do evento no Cal.com
  • Configuração das definições do assistente
  • Transcrição da chamada mostrando a tentativa de agendamento