> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Problemas do Calendly

> Solucione problemas comuns de integração do Calendly

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:**

1. Faça login na sua conta do Calendly em [calendly.com](https://calendly.com)
2. Vá para **Tipos de Evento** e clique no tipo de evento vinculado ao seu assistente
3. Clique em **Editar** nesse tipo de evento
4. Role até a seção **Localização**
5. 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
6. **Salve** o tipo de evento
7. Tente agendar novamente através do assistente

<Warning>
  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.
</Warning>

### 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:

1. Verifique transcrições de chamadas para tentativas de agendamento
2. Confirme se o tipo de evento aparece corretamente no seu painel do Calendly
3. Teste com um agendamento simples por chamada telefônica
4. 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