> ## 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.
# Agendamento de Compromissos GoHighLevel
> Learn how to enable your AI assistant to schedule appointments using GoHighLevel integration
Habilite seu assistente de IA para agendar reuniões e compromissos de forma integrada usando a integração com o GoHighLevel. Esse recurso permite que seu assistente verifique a disponibilidade e agende reuniões diretamente durante as chamadas, utilizando seu sistema de calendário GoHighLevel existente.
## **Pré-requisitos**
Antes de configurar a integração com o GoHighLevel, você precisará de:
* Uma conta ativa no GoHighLevel
* Calendário(s) configurado(s) na sua localização do GoHighLevel
* Permissões de administrador ou adequadas para autorizar conexões de aplicativos
***
**Processo de Configuração**
### 1. Requisitos da Conta GoHighLevel
**Configuração da Conta:**
* Garanta que você possui uma conta ativa no GoHighLevel
* Verifique se seus calendários estão configurados corretamente na conta
* Confirme que você tem as permissões necessárias para conectar aplicativos externos
**Configuração do Calendário:**
* Crie ou verifique calendários existentes na sua localização GoHighLevel
* Defina horários de disponibilidade e configurações de agendamento apropriados
* Configure quaisquer campos personalizados obrigatórios para compromissos
***
### 2. Conectando o GoHighLevel ao Seu Assistente
* Nas **configurações do assistente de IA**, vá até a seção **Ferramentas**
* Selecione **Agendamento de Compromissos** entre as ferramentas disponíveis
* Escolha **GoHighLevel** como tipo de integração de calendário
* Clique em **Conectar ao GoHighLevel**
**Processo de Autorização OAuth:**
* Você será redirecionado para a página de autorização do GoHighLevel
* Escolha sua conta entre as opções disponíveis
* Autorize o aplicativo a acessar os dados do seu calendário
* Você será redirecionado de volta para as configurações do assistente
Se você tiver problemas para conectar ao GoHighLevel, tente usar uma janela de navegação **Anônima/Privada**, pois isso pode resolver conflitos de autenticação.
### 3. Seleção de Calendário
Após a conexão bem-sucedida:
* Selecione o calendário específico da sua localização no GoHighLevel
* Seus calendários disponíveis serão buscados e exibidos automaticamente
* Escolha o calendário onde os compromissos devem ser agendados
***
### 4. Testando a Integração
**Passos essenciais de teste:**
* Faça uma chamada de teste ao seu assistente de IA
* Solicite o agendamento de um compromisso durante a conversa
* Verifique se o agendamento aparece no seu calendário GoHighLevel
* Confira se os detalhes de confirmação foram enviados corretamente
* Teste diferentes cenários (horários disponíveis e indisponíveis)
***
### Informações Necessárias do GoHighLevel
Para completar a integração, o sistema precisa acessar:
**Da sua conta GoHighLevel:**
* **ID da Localização:** Obtido automaticamente durante a autorização OAuth
* **IDs dos Calendários:** Recuperados dos calendários disponíveis na localização
* **Tokens de Acesso:** Gerenciados automaticamente pelo fluxo OAuth
**Permissões do Calendário:**
* **Ler disponibilidade do calendário:** Para verificar horários abertos
* **Criar compromissos:** Para agendar novas reuniões
* **Acessar detalhes do calendário:** Para recuperar nomes e configurações do calendário
***
### Recursos da Integração
**Agendamento Automático de Compromissos**
* **Verificação de disponibilidade em tempo real:** A IA verifica os horários livres
* **Confirmação instantânea:** Compromissos criados imediatamente no GoHighLevel
* **Prevenção de conflitos:** O sistema evita agendamentos duplicados
* **Gerenciamento de fuso horário:** Respeita os fusos horários do calendário e do cliente
***
### Requisito de Email para Compromissos
Importante: Para agendar compromissos, seu assistente de IA precisa do **email do cliente**.
**Opções de configuração:**
* **Definir email nas variáveis de entrada:** Adicione email como variável de entrada nas configurações do assistente
* **Importar leads com email:** Ao importar leads, inclua os endereços de email
* **Coleta pela IA durante a chamada:** Configure o assistente para solicitar o email durante a conversa, caso não esteja disponível
***
**Exemplo de instrução de prompt:**
```
"Se o cliente quiser agendar um compromisso e eu não tiver o endereço de e-mail dele,
peça para que forneça o e-mail para a confirmação do agendamento."
```
## Melhores Práticas
**Gerenciamento de Calendário**
* **Mantenha os calendários atualizados:** Garanta que a disponibilidade esteja correta no GoHighLevel
* **Defina tempos de buffer:** Configure intervalos apropriados entre compromissos
* **Use nomes claros para os calendários:** Facilita a seleção durante a configuração
**Configuração do Assistente**
* **Inclua contexto do calendário no system prompt:** Ajuda a IA a entender os cenários de agendamento
* **Defina variáveis de compromisso:** Extraia informações relevantes para o GoHighLevel
* **Configure a duração do compromisso:** Especifique quanto tempo cada compromisso deve durar
**Configuração da Duração do Compromisso:**\
Informe seu assistente de IA sobre a duração dos compromissos no **system prompt**:
```
"Ao agendar compromissos, use intervalos de 45 minutos.
Se um cliente disser que deseja se encontrar às 8:00, defina o **end_time** para 8:45.
Sempre calcule o **end_time** com base no horário de início mais 45 minutos."
```
**Exemplos de Cenários:**
* Cliente diz: "Podemos nos encontrar às 14:00?"
* IA agenda: 14:00 - 14:45 (intervalo de 45 minutos)
* Teste diversos cenários: diferentes horários solicitados, conflitos, reagendamentos
***
### **Segurança e Conformidade**
* **Gerenciamento de tokens:** Tokens OAuth são atualizados automaticamente
* **Privacidade de dados:** Apenas os dados de calendário necessários são acessados
* **Escopo de permissões:** A integração usa apenas as permissões mínimas necessárias
***
### **Solução de Problemas**
**Correções Rápidas:**
**Erro de API Key ausente:**
* **Solução:** Desconecte e reconecte sua conta GoHighLevel, depois selecione um assistente e salve
* **Passos:** Configurações do assistente → Agendamento de Compromissos → Desconectar → Conectar novamente → Selecionar assistente → Salvar
**Problemas de Conexão:**
* Tente o modo anônimo/incógnito para autorização OAuth
* Verifique permissões da conta e configuração do calendário
**Problemas com o Calendário:**
* Atualize a conexão se os calendários não aparecerem
* Verifique fusos horários e configurações de disponibilidade
Para solução completa de problemas do GoHighLevel, incluindo soluções detalhadas e outros problemas, consulte **GoHighLevel Issues**.