> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Agente de Conversation AI
> Configure um agente de Conversation AI que responde automaticamente aos clientes, tira dúvidas a partir da sua base de conhecimento e agenda compromissos pelo WhatsApp, SMS e outros canais conectados através do GoGHL.ai.
Imagine o seu WhatsApp respondendo aos clientes, tirando dúvidas e agendando compromissos sozinho. Com os **Agentes de Conversation AI** e os seus canais do **GoGHL.ai**, é exatamente isso que você tem:
* Um cliente envia mensagem para o seu negócio pelo **WhatsApp**
* O agente de IA lê a mensagem, entende a intenção e responde na hora
* Se ele quiser agendar um compromisso, o agente oferece horários disponíveis do seu calendário
* Se tiver uma dúvida, responde a partir da sua **base de conhecimento**
* Se não souber a resposta, **transfere a conversa para um humano**
Tudo automático, tudo no WhatsApp, a partir do seu próprio número conectado via GoGHL.ai.
***
## Vídeo de Configuração Completa
***
## Pré-requisitos
Antes de começar, certifique-se de ter:
* Uma conta ativa no **GoGHL.ai** com o app do marketplace instalado na sua subconta
* **WhatsApp conectado** à subconta (veja [Configuração do WhatsApp](/pt-BR/whatsapp/full-setup))
* **Conversation AI** habilitado no seu plano do CRM
* Um **calendário** configurado no seu CRM (necessário para agendamento de compromissos)
***
## Passo 1: Abrir o Conversation AI
Faça login no seu CRM e mude para a **subconta** que você conectou ao WhatsApp via GoGHL.ai.
Na barra lateral esquerda, clique em **AI Agents** e abra a aba **Conversation AI**.
O painel mostra o desempenho dos seus agentes: contatos únicos atendidos, ações executadas, compromissos agendados e tempo economizado.
***
## Passo 2: Criar um Bot
Clique no botão **+ Create Bot** no canto superior direito.
Escolha como você quer construir o seu bot:
* **Prompt Based Bot**: forneça instruções personalizadas (um prompt) para captura de leads, agendamento de compromissos ou perguntas e respostas gerais. Recomendado se você tem prática em escrever prompts.
* **Flow Based Builder**: um construtor visual de fluxos para captura e nutrição avançada de leads com lógica complexa e ramificações. Recomendado para usuários avançados.
Este guia usa o **Prompt Based Bot**.
Selecione um template inicial e clique em **Continue**:
* **General Q\&A**: responde perguntas comuns na hora; perfeito para FAQs e resoluções rápidas
* **Appointment booking**: ajuda os clientes a escolher horários disponíveis e confirmar compromissos
* **Marketplace Templates**: templates de ConversationAI prontos (somente administradores de agência)
* **Start from Scratch**: construa um bot totalmente personalizado
Este guia segue o template de **Appointment booking** (agendamento de compromissos), o caso de uso mais comum para automação de WhatsApp.
***
## Passo 3: Configurar as Definições do Bot
Dê ao bot um nome reconhecível, por exemplo `Assistente de Agendamento WhatsApp`.
Escolha o modo de operação:
* **Off**: o Conversation AI fica desativado
* **Suggestive**: o bot sugere respostas dentro da janela de chat, e você decide o que enviar
* **Auto Pilot**: o bot responde automaticamente com base nos dados com que foi treinado
Comece com **Suggestive** durante os testes e mude para **Auto Pilot** quando confiar nas respostas do bot.
Em **Supported Communication Channels/Providers**, selecione os canais onde o bot deve ficar ativo. O GoGHL.ai se conecta ao seu CRM como um provedor de conversas do tipo **SMS**, então selecione **SMS** para que o bot responda pelo seu provedor do GoGHL.ai (WhatsApp QR, iMessage e SMS Android). Você também pode habilitar **Live Chat**, **Chat Widget (SMS chat)**, **Instagram** e **Facebook**.
Opcionalmente, defina um **Business Name** (o padrão é o nome da location). O bot o utiliza ao se referir ao seu negócio nas respostas.
***
## Passo 4: Configurar o Modo Auto-Pilot
Ajuste como o bot se comporta ao responder automaticamente.
* **Wait time before responding**: quanto tempo o bot espera antes de responder (segundos, minutos ou horas). Um pequeno atraso permite que os clientes terminem de digitar mensagens em várias partes.
* **Maximum messages a bot can send in a conversation**: limita as respostas do bot por conversa para controlar o uso e os custos de IA.
* **Also allow this bot to respond to**: habilite **Images** e/ou **Voice Notes** para que o bot consiga entendê-los. Essas respostas podem demorar um pouco mais e só estão disponíveis no modo Auto-Pilot.
* **Send bot to sleep when I send a**: pausa o bot quando você envia uma **Manual Message** ou uma **Workflow Message**. Habilite os dois para pausar em qualquer mensagem enviada, assim o bot nunca atropela você nem os seus workflows existentes.
* **Response Settings**: habilite **Response Style Settings** para escolher como o bot escreve: conciso, equilibrado ou detalhado.
Clique em **Save** ao terminar.
***
## Passo 5: Treinar o Bot
O bot responde a partir da sua **base de conhecimento**. Abra a aba **Bot Training** para conectar uma.
Clique em **Manage Knowledge Base** (ou crie uma nova a partir de Bot Training), dê um nome e uma descrição opcional, e clique em **Create**.
Adicione fontes das quais o bot pode aprender:
* **Website**: importe uma **URL exata** ou **todas as URLs de um domínio**; as páginas são buscadas e indexadas automaticamente
* **FAQs**: adicione pares de pergunta e resposta
* **Tables**: dados estruturados, como listas de preços
* **Rich text**: conteúdo de texto livre
* **Upload file**: documentos como PDFs
De volta em **Bot Training**, clique em **Add Trigger**, escolha a sua base de conhecimento (você pode conectar até 7) e, opcionalmente, adicione instruções como:
```text theme={null}
Use esta base de conhecimento quando o usuário perguntar sobre preços e descontos
```
As instruções são opcionais; o agente decide de forma autônoma quando usar cada base de conhecimento. Adicionar instruções torna o roteamento mais previsível.
***
## Passo 6: Definir a Personalidade e os Objetivos do Bot
Abra a aba **Bot Goals** para definir como o bot conversa e o que ele deve alcançar.
* **Modelo de IA**: escolha o modelo que alimenta o bot (por exemplo, OpenAI GPT 4.1).
* **Personality**: descreva o tom e o papel, por exemplo:
```text theme={null}
Você é um assistente de atendimento ao cliente amigável e profissional da {{ai.business_name}}.
Você ajuda empresas a conectar o WhatsApp para automatizar mensagens,
respostas com IA e comunicação multicanal.
```
* **Goal**: para onde o bot deve conduzir a conversa. Com o template de Appointment booking, o objetivo é levar os clientes a agendar um compromisso; você pode ampliá-lo, por exemplo, respondendo perguntas sobre recursos, preços, configuração e integrações.
* **Additional Information**: diretrizes de conversa, por exemplo:
```text theme={null}
Diretrizes de Conversa:
* Mantenha um tom casual, objetivo e conciso.
* Espelhe o idioma e o jeito de falar do cliente.
* Sempre identifique primeiro o tipo de solicitação: dúvida sobre recursos,
problema técnico, questão de cobrança ou pedido de agendamento.
```
***
## Passo 7: Configurar as Ações
As ações permitem que o bot faça mais do que conversar. Configure-as na aba **Bot Goals**.
Conecte um **calendário único** ou **múltiplos calendários** e clique em **Proceed**. Em seguida, configure:
* **Agendar via link**: envie aos clientes um link de agendamento em vez de agendar no chat (deixe desligado para a IA agendar diretamente)
* **Pause bot response after booking**: interrompe o bot após o agendamento
* **Trigger workflows after booking**: dispara um workflow para confirmações ou lembretes
* **Transfer to employee post appointment booking**: atribui a conversa a um membro específico da equipe
* **Permitir que o bot cancele compromissos** e **reagende compromissos**: habilite os dois para que os clientes gerenciem os agendamentos totalmente pelo chat
Permita que o bot colete informações durante a conversa (por exemplo, a **cidade**) e salve automaticamente no registro do contato. Você pode adicionar novos campos diretamente nessa tela.
Quando um cliente diz "tchau", "até logo" ou "obrigado, tenha um bom dia", o bot para de responder. Isso também evita desperdício de uso de IA. Opcionalmente, configure:
* Uma **mensagem final** (ex.: "Obrigado pelo seu tempo, tenha um ótimo dia!")
* **Reativar o bot** após um número definido de minutos, horas ou dias, ou mantê-lo desligado
* Uma **tag personalizada** para rastrear as conversas em que o bot parou
Passe a conversa para uma pessoa real em três cenários:
1. **Human requested**: dispara com frases como "quero falar com um gerente" ou "quero falar com um humano". Atribua a conversa a um usuário específico e habilite **Skip assigning if contact has an assigned user** para evitar reatribuições.
2. **Can't find relevant information**: o bot não tem uma resposta. Defina uma mensagem final como "Desculpe, não tenho a resposta para a sua pergunta no momento. Estou encaminhando a sua solicitação para a nossa equipe e alguém retornará em até 24 horas."
3. **Failed to resolve issue**: várias tentativas de resolver o problema falharam; a conversa é escalada para a sua equipe.
Combine a transferência para humano com as [notificações internas](/pt-BR/automation/setup) do GoGHL.ai para receber um aviso pelo WhatsApp ou e-mail no momento em que a IA não conseguir responder, e entre na conversa para responder você mesmo.
Direcione a conversa para outro bot: seja uma **transferência padrão** para o seu bot principal quando este bot não souber a resposta, seja transferências baseadas em cenários para bots especializados que você criou.
Se um contato parar de responder, o bot faz follow-up automaticamente após o tempo que você definir (minutos, horas ou dias), com várias etapas de follow-up se necessário. Se o contato disser que está ocupado ("me chame em 15 minutos"), o bot respeita o horário solicitado.
Gere um resumo automático da conversa quando ela ficar inativa pelo tempo que você definir, e envie-o para um **usuário específico** ou um **e-mail personalizado**.
***
## Passo 8: Teste o seu Bot
Use o painel **Test Your Bot** (disponível nas abas Bot Settings, Bot Training e Bot Goals) antes de colocar no ar.
* Faça as perguntas que os seus clientes fariam: preços, recursos, agendar uma demo
* Teste um agendamento: o bot oferece horários reais do calendário que você conectou
* Avalie as respostas com os botões de **like/dislike** para sinalizar respostas erradas
* Abra os detalhes de uma resposta para ver o **prompt e a intenção utilizados, o histórico do chat e as ações executadas**
Quando as respostas estiverem corretas, mude o **Bot Status** para **Auto Pilot** em Bot Settings, clique em **Save**, e o seu agente de IA para WhatsApp estará no ar.
***
## Boas Práticas
* Comece no modo **Suggestive** e revise as sugestões do bot antes de habilitar o Auto Pilot
* Mantenha a sua base de conhecimento focada: conecte bases de conhecimento separadas para preços, suporte e informações de produto, com instruções de gatilho claras
* Defina um limite razoável de **mensagens máximas** para controlar o uso de IA
* Habilite a **detecção de despedida** para evitar respostas desnecessárias
* Sempre configure a **transferência para humano** para que os clientes nunca fiquem presos com um bot que não pode ajudá-los
* Habilite **send bot to sleep on manual message** para que o bot nunca interrompa as conversas da sua equipe
***
## Solução de Problemas
**O bot não responde no WhatsApp**
* Certifique-se de ter saldo na sua carteira (verifique **View credits** na barra superior). Sem saldo, o Conversation AI não funcionará.
* Confirme que o **SMS** está selecionado em Supported Communication Channels (o GoGHL.ai é um provedor de conversas do tipo SMS)
* Verifique se o status do bot é **Auto Pilot** (no modo Suggestive ele apenas sugere, nunca envia)
* Verifique se o seu número de WhatsApp está conectado no GoGHL.ai (veja [Configuração do WhatsApp](/pt-BR/whatsapp/full-setup))
**O bot dá respostas erradas ou vazias**
* Verifique se a base de conhecimento terminou de indexar as páginas do seu site
* Adicione instruções de gatilho para que a base de conhecimento correta seja usada
* Refine os prompts de Personality e Additional Information
**Os compromissos não são agendados**
* Certifique-se de que há um calendário conectado na ação de Appointment Booking
* Confirme que o calendário tem horários disponíveis
***
## Suporte
Se precisar de ajuda para configurar o seu agente de Conversation AI:
* Fale conosco pelo **WhatsApp Chat**
* Escreva para [**support@goghl.ai**](mailto:support@goghl.ai)
***
## Perguntas Frequentes
Sim. O bot responde através do número de WhatsApp que você conectou à sua subconta via GoGHL.ai, em qualquer canal que você habilitar.
Selecione **SMS**. O GoGHL.ai se conecta ao seu CRM como um provedor de conversas do tipo **SMS**, então o bot precisa estar ativo no canal SMS para responder pelo seu provedor do GoGHL.ai (WhatsApp QR, iMessage e SMS Android).
Sim. Crie vários bots (ex.: um para perguntas e respostas, outro para agendamentos) e use a ação **Transfer Bot** para direcionar as conversas entre eles. Você também pode definir um bot como **Primary Bot**.
Não, se você habilitar **Send bot to sleep when I send a Manual Message** nas configurações de Auto-pilot. O bot pausa sempre que você entra na conversa.
Sim. Habilite **Images** e **Voice Notes** no modo Auto-pilot. Essas respostas podem demorar um pouco mais e só estão disponíveis no modo Auto-Pilot.
***
Agora você está pronto para operar um agente de IA totalmente automatizado no WhatsApp usando **GoGHL.ai + Conversation AI**.
Este guia usa o **Prompt Based Bot**.
O painel mostra o desempenho dos seus agentes: contatos únicos atendidos, ações executadas, compromissos agendados e tempo economizado.
***
## Passo 2: Criar um Bot
* **Wait time before responding**: quanto tempo o bot espera antes de responder (segundos, minutos ou horas). Um pequeno atraso permite que os clientes terminem de digitar mensagens em várias partes.
* **Maximum messages a bot can send in a conversation**: limita as respostas do bot por conversa para controlar o uso e os custos de IA.
* **Also allow this bot to respond to**: habilite **Images** e/ou **Voice Notes** para que o bot consiga entendê-los. Essas respostas podem demorar um pouco mais e só estão disponíveis no modo Auto-Pilot.
* **Send bot to sleep when I send a**: pausa o bot quando você envia uma **Manual Message** ou uma **Workflow Message**. Habilite os dois para pausar em qualquer mensagem enviada, assim o bot nunca atropela você nem os seus workflows existentes.
* **Response Settings**: habilite **Response Style Settings** para escolher como o bot escreve: conciso, equilibrado ou detalhado.
Clique em **Save** ao terminar.
***
## Passo 5: Treinar o Bot
O bot responde a partir da sua **base de conhecimento**. Abra a aba **Bot Training** para conectar uma.
* **Modelo de IA**: escolha o modelo que alimenta o bot (por exemplo, OpenAI GPT 4.1).
* **Personality**: descreva o tom e o papel, por exemplo:
```text theme={null}
Você é um assistente de atendimento ao cliente amigável e profissional da {{ai.business_name}}.
Você ajuda empresas a conectar o WhatsApp para automatizar mensagens,
respostas com IA e comunicação multicanal.
```
* **Goal**: para onde o bot deve conduzir a conversa. Com o template de Appointment booking, o objetivo é levar os clientes a agendar um compromisso; você pode ampliá-lo, por exemplo, respondendo perguntas sobre recursos, preços, configuração e integrações.
* **Additional Information**: diretrizes de conversa, por exemplo:
```text theme={null}
Diretrizes de Conversa:
* Mantenha um tom casual, objetivo e conciso.
* Espelhe o idioma e o jeito de falar do cliente.
* Sempre identifique primeiro o tipo de solicitação: dúvida sobre recursos,
problema técnico, questão de cobrança ou pedido de agendamento.
```
***
## Passo 7: Configurar as Ações
As ações permitem que o bot faça mais do que conversar. Configure-as na aba **Bot Goals**.