Soluções para problemas comuns de integração com a Sua SofIA.
Problemas de Conexão
Falha na Autorização OAuth
Problema: Incapaz de conectar a conta da Calendly
Solução:
- Tente conectar em uma janela de navegador anônima/privada
- Verifique se você tem acesso de administrador à sua conta da Calendly
- Confira se as permissões de aplicativos de terceiros estão habilitadas na Calendly
Eventos Não Carregando
Problema: O dropdown de eventos está vazio após a conexão
Solução:
- Clique no botão “Carregar Eventos” para buscar os tipos de eventos
- 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 eventos ativos na sua conta da Calendly
Falhas de Reserva
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: O tipo de evento da sua Calendly tem uma configuração de localização (por exemplo, Google Meet, Zoom) que não corresponde ao que o agente de voz usa ao agendar.
Solução:
- Faça login na sua conta da 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
- Altere a localização para uma das seguintes opções:
- “Personalizado” — esta é a opção mais segura e funciona em todos os casos
- “Chamada Telefônica” → “Chamada de Entrada” — também funciona bem para casos de uso de IA de voz
- Se você tiver múltiplas localizações, certifique-se de que “Personalizado” esteja incluído como uma das opções
- Salve o tipo de evento
- Tente agendar novamente através do assistente
Se o seu tipo de evento estiver configurado apenas para uma localização de videoconferência (Google Meet, Zoom, Microsoft Teams), as reservas 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 na Reserva
Problema: Compromissos agendados para o horário errado
Solução:
- Verifique o fuso horário nas configurações do evento da sua Calendly
- Verifique se o fuso horário do assistente está configurado corretamente
- Teste com menções de horário específicas durante uma chamada
Problemas de Teste
Falhas em Reservas de Chamadas pela Web
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 número de telefone no formato internacional com o prefixo + (por exemplo, “+55 11 91234-5678”)
Obtendo Ajuda
Se os problemas persistirem:
- Verifique as transcrições das chamadas para tentativas de reserva
- Verifique se o tipo de evento aparece corretamente no seu painel da Calendly
- Teste com uma reserva simples de chamada telefônica
- Entre em contato com o suporte com:
- Captura de tela da mensagem de erro
- Captura de tela das configurações do tipo de evento da Calendly (especialmente a seção Localização)
- Transcrição da chamada mostrando a tentativa de reserva
