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

# Agendamento de Compromissos GoHighLevel

> Aprenda como habilitar seu assistente de IA a agendar compromissos usando a integração GoHighLevel

Habilite seu assistente de IA a agendar reuniões e compromissos perfeitamente usando a integração GoHighLevel. Este recurso poderoso permite que sua IA verifique disponibilidade e marque reuniões diretamente durante chamadas com seu sistema de calendário GoHighLevel existente.

## Pré-requisitos

Antes de configurar a integração GoHighLevel, você precisará:

* Uma conta GoHighLevel ativa
* Calendário(s) configurado(s) em sua localização GoHighLevel
* Administrador ou permissões apropriadas para autorizar conexões de aplicativos

## Processo de Configuração

### 1. Requisitos da Conta GoHighLevel

**Configuração da Conta:**

* Certifique-se de ter uma conta GoHighLevel ativa
* Verifique se seus calendários estão configurados adequadamente em sua conta
* Confirme que você tem as permissões necessárias para conectar aplicativos externos

**Configuração de Calendário:**

* Crie ou verifique calendários existentes em sua localização GoHighLevel
* Defina horários de disponibilidade e configurações de reserva apropriados
* Configure campos personalizados necessários para compromissos

### 2. Conectando GoHighLevel ao Seu Assistente

1. Nas [configurações do assistente de IA](/ai-assistants/settings/prompt-and-tools#default-tools), navegue até a seção **Ferramentas**
2. Selecione **Agendamento de Compromissos** das ferramentas disponíveis
3. Escolha **GoHighLevel** como seu tipo de integração de calendário
4. Clique em **Conectar ao GoHighLevel**

**Processo de Autorização OAuth:**

1. Você será redirecionado para a página de autorização do GoHighLevel
2. **Escolha sua conta** das opções disponíveis
3. **Autorize o aplicativo** a acessar seus dados de calendário
4. Você será redirecionado de volta às configurações do seu assistente

<Note>
  Se você tiver problemas ao conectar ao GoHighLevel, tente usar uma **janela de navegação Anônima/Privada**, pois isso pode resolver conflitos de autenticação.
</Note>

### 3. Seleção de Calendário

Após conexão bem-sucedida:

1. Selecione o **calendário** específico de sua localização GoHighLevel
2. Seus calendários disponíveis serão automaticamente buscados e exibidos
3. Escolha o calendário onde os compromissos devem ser reservados

### 4. Testando a Integração

**Passos essenciais de teste:**

1. Faça uma chamada de teste para seu assistente de IA
2. Solicite agendar um compromisso durante a conversa
3. Verifique se a reserva aparece em seu calendário GoHighLevel
4. Confirme que os detalhes de confirmação são enviados adequadamente
5. Teste diferentes cenários (horários disponíveis/indisponíveis)

## Informações Necessárias do GoHighLevel

Para completar a integração, o sistema precisa de acesso a:

### Da Sua Conta GoHighLevel:

* **ID de Localização:** Obtido automaticamente durante autorização OAuth
* **IDs de Calendário:** Recuperados dos calendários disponíveis de sua localização
* **Tokens de Acesso:** Gerenciados automaticamente através do fluxo OAuth

### Permissões de Calendário:

* **Ler disponibilidade de calendário:** Para verificar horários disponíveis
* **Criar compromissos:** Para reservar novas reuniões
* **Acessar detalhes de calendário:** Para recuperar nomes e configurações de calendários

## Recursos de Integração

### Reserva Automática de Compromissos

* **Verificação de disponibilidade em tempo real:** IA verifica horários disponíveis
* **Confirmação instantânea de reserva:** Compromissos criados imediatamente no GoHighLevel
* **Prevenção de conflitos:** Sistema previne reservas duplas
* **Tratamento de fuso horário:** Respeita fusos horários do calendário e do cliente

### Requisito de E-mail para Compromissos

**Importante:** Para reservar compromissos, seu assistente de IA precisa de um endereço de e-mail do cliente.

**Opções de configuração:**

1. **Definir e-mail nas variáveis de entrada:** Adicione `email` como uma variável de entrada nas [configurações do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)
2. **Importar leads com e-mail:** Ao importar leads, certifique-se de incluir endereços de e-mail
3. **Coleta pela IA durante chamada:** Configure seu assistente para pedir o e-mail durante a conversa se não estiver disponível

**Exemplo de instrução de prompt:**

```
"Se o cliente quiser reservar um compromisso e eu não tiver o endereço de e-mail dele, 
peça que forneça seu endereço de e-mail para a confirmação da reserva."
```

## Melhores Práticas

### Gerenciamento de Calendário

* **Mantenha calendários atualizados:** Certifique-se de que a disponibilidade esteja atual no GoHighLevel
* **Defina tempos de intervalo:** Configure espaços apropriados entre compromissos
* **Use nomes de calendário claros:** Facilita a seleção durante a configuração

### Configuração do Assistente

* **Inclua contexto de calendário no prompt do sistema:** Ajude a IA a entender cenários de reserva
* **Defina variáveis de compromisso:** Extraia informações relevantes para o GoHighLevel
* **Configure duração do compromisso:** Especifique quanto tempo os compromissos devem durar

**Configuração de Duração do Compromisso:**
Informe seu assistente de IA sobre a duração dos compromissos no prompt do sistema:

```
"Ao reservar compromissos, use slots de 45 minutos. Se um cliente disser que quer 
se encontrar às 8:00 da manhã, defina o horário_final para 8:45. Sempre calcule o horário_final 
com base no horário de início mais 45 minutos."
```

**Cenários de exemplo:**

* Cliente diz: "Podemos nos encontrar às 14:00?"

* IA reserva: 14:00 - 14:45 (slot de 45 minutos)

* **Teste vários cenários:** Diferentes solicitações de horário, conflitos, reagendamento

### Segurança e Conformidade

* **Gerenciamento de tokens:** Tokens OAuth são renovados automaticamente
* **Privacidade de dados:** Apenas dados de calendário necessários são acessados
* **Escopo de permissão:** Integração usa permissões mínimas necessárias

## Solução de Problemas

### Correções Rápidas:

**Erro de Chave de API Ausente:**

* **Solução:** Desconecte e reconecte sua conta GoHighLevel, então selecione um assistente e salve
* **Passos:** Vá para [configurações do assistente](/ai-assistants/settings/prompt-and-tools#default-tools) → Agendamento de Compromissos → Desconectar → Conectar novamente → Selecionar assistente → Salvar

**Problemas de Conexão:**

* **Tente modo anônimo** para autorização OAuth
* **Verifique permissões da conta** e configuração de calendário

**Problemas de Calendário:**

* **Atualize a conexão** se calendários não aparecerem
* **Verifique fusos horários** e configurações de disponibilidade

<Note>
  Para solução de problemas abrangente do GoHighLevel, incluindo soluções detalhadas e problemas adicionais, consulte [Problemas do GoHighLevel](/troubleshooting/gohighlevel).
</Note>