> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.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 seu provedor de mensagens.

Imagine o seu WhatsApp respondendo aos clientes, tirando dúvidas e agendando compromissos sozinho. Com os **Agentes de Conversation AI** e os seus **canais conectados de WhatsApp, iMessage e SMS**, é 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 o provedor de WhatsApp.

***

## Pré-requisitos

Antes de começar, certifique-se de ter:

* Certifique-se de ter o app **WhatsApp provider** instalado e atualizado; se não, entre em contato com o suporte do seu CRM
* **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

<Steps>
  <Step title="Selecione a sua Subconta">
    Faça login no seu CRM e mude para a **subconta** que você conectou ao WhatsApp.
  </Step>

  <Step title="Acesse AI Agents">
    Na barra lateral esquerda, clique em **AI Agents** e abra a aba **Conversation AI**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/conversation-ai-dashboard.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=80d91aa15133ed56e249985684e6bb2c" alt="Painel de Agentes de Conversation AI" width="2880" height="1522" data-path="images/conversation-ai/conversation-ai-dashboard.png" />
</Frame>

O painel mostra o desempenho dos seus agentes: contatos únicos atendidos, ações executadas, compromissos agendados e tempo economizado.

***

## Passo 2: Criar um Bot

<Steps>
  <Step title="Clique em Create Bot">
    Clique no botão **+ Create Bot** no canto superior direito.
  </Step>

  <Step title="Escolha o Tipo de Bot">
    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.

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/create-bot-prompt-vs-flow.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=f21ff3f762c3ebdb4ecd896cbfaff92d" alt="Escolha entre Prompt Based Bot e Flow Based Builder" width="2880" height="1502" data-path="images/conversation-ai/create-bot-prompt-vs-flow.png" />
    </Frame>

    Este guia usa o **Prompt Based Bot**.
  </Step>

  <Step title="Escolha um Template">
    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

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/create-bot-templates.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=1670f1fbb94366f7f3ec30f1409cb067" alt="Escolha um template de bot" width="2880" height="1552" data-path="images/conversation-ai/create-bot-templates.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  Este guia segue o template de **Appointment booking** (agendamento de compromissos), o caso de uso mais comum para automação de WhatsApp.
</Info>

***

## Passo 3: Configurar as Definições do Bot

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/bot-settings-channels.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=c20f887b240c3aec489f624ce133c62f" alt="Definições do bot com canais selecionados" width="2880" height="1542" data-path="images/conversation-ai/bot-settings-channels.png" />
</Frame>

<Steps>
  <Step title="Dê um Nome ao seu Bot">
    Dê ao bot um nome reconhecível, por exemplo `Assistente de Agendamento WhatsApp`.
  </Step>

  <Step title="Defina o Status do Bot">
    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

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/bot-status-suggestive.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=16dfc6d6e4c4dac12e856aabdabfc2e1" alt="Opções de status do bot" width="2880" height="1546" data-path="images/conversation-ai/bot-status-suggestive.png" />
    </Frame>

    <Note>
      Comece com **Suggestive** durante os testes e mude para **Auto Pilot** quando confiar nas respostas do bot.
    </Note>
  </Step>

  <Step title="Selecione os Canais de Comunicação">
    Em **Supported Communication Channels/Providers**, selecione os canais onde o bot deve ficar ativo. O seu provedor de mensagens se conecta ao seu CRM como um provedor de conversas do tipo **SMS**, então selecione **SMS** para que o bot responda pelos canais do seu provedor (WhatsApp QR, iMessage e SMS Android). Você também pode habilitar **Live Chat**, **Chat Widget (SMS chat)**, **Instagram** e **Facebook**.

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/channels-sms-selected.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=9bf8e226ebf77ab521b5d258c2af4e28" alt="SMS selecionado em Supported Communication Channels" width="1828" height="456" data-path="images/conversation-ai/channels-sms-selected.png" />
    </Frame>
  </Step>

  <Step title="Informe o Nome do seu Negócio">
    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.
  </Step>
</Steps>

***

## Opcional: Nova Interface de Seleção de Canais (Labs)

O seu CRM traz uma interface mais nova para escolher canais, chamada **Conversations AI Channel Management**. Em vez de uma lista de caixas de seleção dentro de Bot Settings, você ganha uma aba **Agent Deployment** onde cada canal é configurado separadamente, com segmentação por tags em cada canal.

<Steps>
  <Step title="Habilite o Recurso no Labs">
    Vá em **Settings**, role para baixo e selecione **Labs**, e habilite **Conversations AI Channel Management**.

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/enable-new-ui.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=8164ea6eedbc1b3449b411b86b0f4dcf" alt="Habilitar Conversations AI Channel Management no Labs" width="2072" height="488" data-path="images/conversation-ai/enable-new-ui.png" />
    </Frame>
  </Step>

  <Step title="Abra o Agent Deployment">
    De volta ao seu bot, abra a aba **Agent Deployment**. Cada canal (SMS, WhatsApp, Instagram, Facebook, Live chat, Chat widget, Email) agora é um card próprio. Clique em **Configure** no canal em que o bot deve atuar.

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/select-channel.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=fc9c2e792b62f33b71f78e79f769012e" alt="Aba Agent Deployment com um card por canal" width="3010" height="1664" data-path="images/conversation-ai/select-channel.png" />
    </Frame>

    <Note>
      O seu provedor de mensagens continua se conectando como provedor de conversas do tipo **SMS**, então configure o card **SMS** para o bot responder nos seus números conectados (WhatsApp QR, iMessage e SMS Android).
    </Note>
  </Step>

  <Step title="Ative o Canal e Selecione os Números">
    Ative **Assign channel** e, em **Select phone number(s)**, marque **Select all**. Deixe os campos de tags em branco para funcionar com todos os números e chats, ou use **Has tags** / **Doesn't have tags** para restringir quais conversas o bot atende.

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/select-phone.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=432c65e7a6fa02e7e989f24a339b0365" alt="Diálogo Edit channel com Select all e filtros de tags" width="3020" height="1966" data-path="images/conversation-ai/select-phone.png" />
    </Frame>
  </Step>
</Steps>

### Por Que Isso É Melhor

* **Sem necessidade de workflow.** A segmentação é configurada direto nas definições de canal do bot de IA, em vez de na lógica de um workflow.
* **Um bot por número.** Para que um bot responda apenas em um número de WhatsApp, adicione a tag daquele número em **Has tags** (por exemplo `wa:+14304039444`, substituída pela tag do seu número). O bot será acionado somente nas conversas com essa tag.
* **Vários bots, vários números.** Crie vários bots de IA e atribua a cada um uma tag de número diferente, para que cada número de WhatsApp tenha seu bot dedicado sem nenhum workflow no meio.

***

## Passo 4: Configurar o Modo Auto-Pilot

Ajuste como o bot se comporta ao responder automaticamente.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/bot-settings-autopilot.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=26ef2fc4a60c8434fb12d4174f883681" alt="Configurações do modo auto-pilot" width="2876" height="1552" data-path="images/conversation-ai/bot-settings-autopilot.png" />
</Frame>

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

<Steps>
  <Step title="Crie uma Base de Conhecimento">
    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**.
  </Step>

  <Step title="Adicione Conteúdo">
    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
  </Step>

  <Step title="Adicione um Gatilho de Base de Conhecimento">
    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
    ```

    <Frame>
      <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/bot-training-kb-trigger.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=e7bb4dc917579fd5f846f9cb1dfe7e61" alt="Adicionar um gatilho de base de conhecimento" width="2866" height="1542" data-path="images/conversation-ai/bot-training-kb-trigger.png" />
    </Frame>

    <Info>
      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.
    </Info>
  </Step>
</Steps>

***

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

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/SojTbdU_ztm7g_31/images/conversation-ai/bot-goals-prompt.png?fit=max&auto=format&n=SojTbdU_ztm7g_31&q=85&s=6a692159dc192e30afc383324e8a891b" alt="Bot Goals com personalidade e prompt" width="2876" height="1518" data-path="images/conversation-ai/bot-goals-prompt.png" />
</Frame>

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

<AccordionGroup>
  <Accordion title="Agendamento de Compromissos">
    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
  </Accordion>

  <Accordion title="Atualizar Campos do Contato">
    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.
  </Accordion>

  <Accordion title="Parar o Bot (Detecção de Despedida)">
    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
  </Accordion>

  <Accordion title="Transferência para Humano">
    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.

    <Tip>
      Combine a transferência para humano com as [notificações internas](/pt-BR/automation/setup) 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.
    </Tip>
  </Accordion>

  <Accordion title="Transferência entre Bots">
    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.
  </Accordion>

  <Accordion title="Follow-ups Automáticos">
    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.
  </Accordion>

  <Accordion title="Resumo da Conversa (Preferências)">
    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**.
  </Accordion>
</AccordionGroup>

***

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

<Check>
  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.
</Check>

***

## 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 seu provedor de mensagens é 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 painel do seu provedor (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:

* Escreva para [**support@messagesync.ai**](mailto:support@messagesync.ai)

***

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="O bot responde a partir do meu próprio número de WhatsApp?">
    Sim. O bot responde através do número de WhatsApp que você conectou à sua subconta via o provedor de WhatsApp, em qualquer canal que você habilitar.
  </Accordion>

  <Accordion title="Qual canal eu seleciono para o bot responder no WhatsApp?">
    Selecione **SMS**. O seu provedor de mensagens 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 pelos canais do seu provedor (WhatsApp QR, iMessage e SMS Android).
  </Accordion>

  <Accordion title="Posso ter bots diferentes para finalidades diferentes?">
    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**.
  </Accordion>

  <Accordion title="O bot vai me interromper quando eu responder manualmente?">
    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.
  </Accordion>

  <Accordion title="O bot consegue lidar com imagens e notas de voz?">
    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.
  </Accordion>
</AccordionGroup>

***

Agora você está pronto para operar um agente de IA totalmente automatizado no WhatsApp usando **o seu provedor de WhatsApp + Conversation AI**.