> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Agendamento de Compromissos com GoHighLevel

> Aprenda como habilitar seu assistente de IA para agendar compromissos utilizando a integração com o GoHighLevel.

Habilite seu assistente de IA para agendar reuniões e compromissos de forma integrada ao GoHighLevel. Esse recurso permite que a IA consulte disponibilidade e realize agendamentos diretamente durante as chamadas, utilizando o sistema de calendário já existente no GoHighLevel.

## Pré-requisitos

Antes de configurar a integração com o GoHighLevel, é necessário:

* Conta ativa no GoHighLevel
* Calendário(s) configurado(s) na sua localização do GoHighLevel
* Permissões administrativas ou adequadas para autorizar conexões de aplicativos

## Processo de Configuração

### 1. Requisitos da Conta GoHighLevel

**Configuração da Conta:**

* Garanta que sua conta GoHighLevel esteja ativa
* Verifique se os calendários estão corretamente configurados
* Confirme se você possui permissões para conectar aplicações externas

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

* Crie ou valide calendários existentes na sua localização
* Defina horários de disponibilidade e regras de agendamento
* Configure campos personalizados necessários para compromissos

### 2. Conectando o GoHighLevel ao Assistente

1. Nas [configurações do assistente de IA](/ai-assistants/settings/prompt-and-tools#default-tools), acesse a seção **Ferramentas**
2. Selecione **Agendamento de Compromissos** entre as ferramentas disponíveis
3. Escolha **GoHighLevel** como 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. **Selecione sua conta** entre as opções disponíveis
3. **Autorize a aplicação** para acessar os dados do calendário
4. Você será redirecionado de volta para as configurações do assistente

<Note>
  Caso enfrente problemas na conexão com o GoHighLevel, tente utilizar uma **janela anônima/privada** do navegador para evitar conflitos de autenticação.
</Note>

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

Após a conexão bem-sucedida:

1. Selecione o **calendário específico** da sua localização no GoHighLevel
2. Os calendários disponíveis serão carregados automaticamente
3. Escolha onde os compromissos devem ser agendados

### 4. Testando a Integração

**Etapas essenciais de teste:**

1. Realize uma chamada de teste com o assistente de IA
2. Solicite o agendamento de um compromisso durante a conversa
3. Verifique se o compromisso aparece no calendário do GoHighLevel
4. Confirme se as notificações e confirmações foram enviadas corretamente
5. Teste diferentes cenários (horários disponíveis e indisponíveis)

## Informações Necessárias do GoHighLevel

Para concluir a integração, o sistema precisa acessar:

### Da Conta GoHighLevel:

* **Location ID:** Obtido automaticamente durante a autorização OAuth
* **IDs de Calendário:** Recuperados a partir dos calendários disponíveis na localização
* **Tokens de Acesso:** Gerenciados automaticamente pelo fluxo OAuth

### Permissões de Calendário:

* **Leitura de disponibilidade:** Para consultar horários livres
* **Criação de compromissos:** Para agendar reuniões
* **Acesso a detalhes do calendário:** Para obter nomes e configurações

## Funcionalidades da Integração

### Agendamento Automático de Compromissos

* **Verificação de disponibilidade em tempo real**
* **Confirmação instantânea de agendamentos**
* **Prevenção de conflitos:** Evita agendamentos duplicados
* **Gerenciamento de fuso horário:** Respeita o fuso do calendário e do cliente

### Obrigatoriedade de E-mail para Agendamentos

**Importante:** Para realizar agendamentos, o assistente de IA precisa do endereço de e-mail do cliente.

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

1. **Definir e-mail como variável de entrada:** Adicione `email` nas [configurações do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)
2. **Importar leads com e-mail:** Garanta que os contatos importados possuam e-mail
3. **Coleta durante a chamada:** Configure o assistente para solicitar o e-mail caso não esteja disponível

**Exemplo de instrução no prompt:**
"Se o cliente desejar agendar um compromisso e não houver um e-mail disponível,
solicite o endereço de e-mail para envio da confirmação do agendamento."

## Boas Práticas

### Gestão de Calendários

* **Mantenha os calendários atualizados**
* **Configure intervalos entre compromissos**
* **Utilize nomes claros nos calendários** para facilitar a seleção

### Configuração do Assistente

* **Inclua contexto de agendamento no prompt de sistema**
* **Defina variáveis de compromisso**
* **Configure a duração dos compromissos**

**Configuração de Duração de Compromissos:**
Informe no prompt do assistente a duração padrão dos compromissos:

"Ao agendar compromissos, utilize slots de 45 minutos. Se o cliente solicitar
um horário às 8:00, defina o horário de término como 8:45. Sempre calcule o
horário final com base no horário inicial + 45 minutos."

**Exemplos:**

* Cliente: "Podemos nos reunir às 14:00?"

* IA agenda: 14:00 – 14:45 (slot de 45 minutos)

* **Teste múltiplos cenários:** conflitos, reagendamentos e diferentes horários

### Segurança e Conformidade

* **Gerenciamento de tokens:** Tokens OAuth são renovados automaticamente
* **Privacidade de dados:** Apenas dados necessários do calendário são acessados
* **Escopo mínimo:** A integração utiliza apenas as permissões essenciais

## Solução de Problemas

### Correções Rápidas:

**Erro de API Key ausente:**

* **Solução:** Desconecte e conecte novamente a conta GoHighLevel
* **Caminho:** [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:**

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

**Problemas com Calendário:**

* **Atualize a conexão** se os calendários não aparecerem
* Verifique **fuso horário** e regras de disponibilidade

<Note>
  Para um guia completo de solução de problemas do GoHighLevel, incluindo cenários adicionais, consulte [Problemas com GoHighLevel](/troubleshooting/gohighlevel).
</Note>