> ## 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 com Cal.com

> Solucione problemas comuns de integração com Cal.com

Soluções para problemas comuns de integração com Cal.com.

## Problemas de Conexão

### Chave de API Inválida

**Problema:** Eventos não carregam ou a sincronização falha

**Solução:**

* Verifique se a chave de API está ativa em 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 Carregam

**Problema:** Menu suspenso 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 de chave de API para acionar o carregamento de eventos
* Atualize a página se os eventos ainda não aparecerem
* Verifique se você tem eventos criados no Cal.com

## Problemas de Sincronização

### Falha ao Sincronizar Evento

**Problema:** Botão "Sincronizar Evento" falha ou mostra erro

**Solução:**

1. Clique no botão **"Solucionar 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 evento do Cal.com

### Erros de Configuração de Campo

**Problema:** Recebendo erros sobre campos obrigatórios ou campos ausentes

**Solução:**

* Clique em **"Solucionar Problemas"** para redefinir os campos
* Apenas nome, email 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 têm sucesso, mas o cliente não recebe o convite

**Solução:**

* Defina a variável `email` em [configurações do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)
* Passe o email do cliente ao criar leads
* Verifique se o formato do email é válido

### Número de Telefone Ausente

**Problema:** Número de telefone não aparece nos eventos do calendário

**Solução:**

* Clique no botão **"Sincronizar Evento"** ou **"Solucionar 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 de Reserva

**Problema:** Compromissos agendados no horário errado

**Solução:**

* Verifique o fuso horário nas configurações de evento do Cal.com
* Verifique se o assistente está obtendo o horário correto do cliente
* Teste com menções específicas de horário durante a chamada

## Problemas de Teste

### Reservas de Chamada Web Falham

**Problema:** Reservas funcionam de forma inconsistente 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 telefone em formato internacional com prefixo + (ex: "+55 11 98765-4321")
* Chamadas telefônicas garantem que todas as variáveis sejam transmitidas corretamente

### Vários Calendários Não Funcionam

**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 evento distintos (ex: "15min", "30min")
* Sincronize cada evento separadamente após adicionar

## Obtendo Ajuda

Se os problemas persistirem:

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