Soluções para problemas comuns de integração do Calendly.
Problemas de Conexão
Falha na Autorização OAuth
Problema: Não consegue conectar a conta do Calendly
Solução:
- Tente conectar em uma janela de navegação anônima/privada
- Verifique se você tem acesso de administrador à sua conta do Calendly
- Certifique-se de que as permissões de aplicativos de terceiros estejam habilitadas no Calendly
Eventos Não Carregam
Problema: O menu suspenso de eventos está vazio após conectar
Solução:
- Clique no botão “Carregar Eventos” para buscar tipos de evento
- Aguarde a sincronização ser concluída (pode levar alguns segundos)
- Atualize a página se os eventos ainda não aparecerem
- Verifique se você tem tipos de evento ativos em sua conta do Calendly
Falhas de Agendamento
Erro de Tipo de Localização
Problema: “Falha ao agendar compromisso: O tipo de localização especificado não está configurado para este tipo de evento”
Causa: Seu tipo de evento do Calendly tem uma configuração de localização (ex: Google Meet, Zoom) que não corresponde ao que o agente de voz usa ao fazer o agendamento.
Solução:
- Faça login na sua conta do Calendly em calendly.com
- Vá para Tipos de Evento e clique no tipo de evento vinculado ao seu assistente
- Clique em Editar nesse tipo de evento
- Role até a seção Localização
- Mude a localização para uma dessas opções:
- “Personalizado” — esta é a opção mais segura e funciona em todos os casos
- “Chamada telefônica” → “Chamada recebida” — também funciona bem para casos de uso de IA de voz
- Se você tem várias localizações, certifique-se de que “Personalizado” está incluído como uma das opções
- Salve o tipo de evento
- Tente agendar novamente através do assistente
Se seu tipo de evento está configurado apenas para localização de videoconferência (Google Meet, Zoom, Microsoft Teams), os agendamentos falharão porque o agente de voz não gera links de reunião. Mude para “Personalizado” ou adicione “Personalizado” como uma opção de localização adicional.
Problemas de Fuso Horário de Agendamento
Problema: Compromissos agendados no horário errado
Solução:
- Verifique o fuso horário nas configurações do seu evento do Calendly
- Confirme se o fuso horário do assistente está configurado corretamente
- Teste com menções de horários específicos durante uma chamada
Problemas de Teste
Falhas de Agendamento em Chamadas Web
Problema: Agendamentos funcionam inconsistentemente 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 número de telefone no formato internacional com prefixo + (ex: “+55 11 99999-9999”)
Obtendo Ajuda
Se os problemas persistirem:
- Verifique transcrições de chamadas para tentativas de agendamento
- Confirme se o tipo de evento aparece corretamente no seu painel do Calendly
- Teste com um agendamento simples por chamada telefônica
- Contate o suporte com:
- Captura de tela da mensagem de erro
- Captura de tela das configurações do tipo de evento do Calendly (especialmente a seção Localização)
- Transcrição da chamada mostrando a tentativa de agendamento
