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

# Problemas com o Cal.com

> Solucione problemas comuns com a integração do Cal.com para agendamento de compromissos 

Este guia fornece soluções para problemas comuns encontrados ao integrar o [**Cal.com**](http://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](http://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**](http://Cal.com)
* Insira o **ID do evento** correto a partir da URL do evento no [**Cal.com**](http://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**](http://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**](http://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**](http://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**](http://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**](http://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**](http://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**](http://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**](http://Cal.com)
* Configuração das definições do assistente
* Transcrição da chamada mostrando a tentativa de agendamento