> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens e Coleta de Dados

> Configure pré-chat, mensagens automáticas, perguntas sugeridas e integração com Agente de IA no Live Chat.

# Mensagens e Coleta de Dados

Configure o comportamento do widget em relação a coleta de informações, mensagens automáticas e integração com Agente de IA.

***

## Coleta de Dados (Pré-chat)

Quando habilitada, exibe um formulário antes do início da conversa para capturar informações do visitante.

### Campos Disponíveis

Adicione campos customizáveis com os seguintes tipos:

| Tipo         | Mapeamento                     |
| ------------ | ------------------------------ |
| **Nome**     | Salvo como nome do contato     |
| **E-mail**   | Salvo como e-mail do contato   |
| **Telefone** | Salvo como telefone do contato |
| **Texto**    | Campo de texto livre           |

Cada campo pode ser marcado como **obrigatório** e ter um **placeholder** personalizado.

<Info>
  Os dados coletados no pré-chat são salvos automaticamente no contato criado pela conversa. Se o visitante já tiver um contato correspondente ao telefone ou e-mail informado, os dados são vinculados ao contato existente.
</Info>

***

## Mensagens Automáticas

### Mensagem de Boas-vindas

A primeira mensagem enviada automaticamente quando o visitante inicia o chat. Use para apresentar o atendente ou o agente de IA.

### Mensagem Offline

Exibida quando o atendimento não está disponível (fora do horário configurado ou quando o widget está desativado). Informe ao visitante quando receberá uma resposta.

### Perguntas Sugeridas

Adicione até **5 perguntas** que aparecem como botões clicáveis abaixo da mensagem de boas-vindas. O visitante pode clicar para enviar rapidamente.

Exemplos:

* "Quais são os planos disponíveis?"
* "Como funciona o suporte?"
* "Quero falar com um atendente"

***

## Agente de IA

Vincule um **Agente de IA** existente ao widget para responder automaticamente as mensagens dos visitantes.

<Steps>
  <Step title="Selecionar agente">
    Na configuração do widget, vá à aba **Agente de IA** e escolha um agente da lista de agentes disponíveis na instância.
  </Step>

  <Step title="Fallback humano">
    Ative a opção **Fallback Humano** para que, quando o agente não conseguir responder, a conversa seja transferida para um atendente humano.
  </Step>

  <Step title="Testar">
    Antes de publicar, use o botão **Testar Widget** para simular uma conversa e verificar o comportamento do agente.
  </Step>
</Steps>

<Warning>
  O agente precisa estar **ativo** para funcionar no widget. Agentes desativados não responderão, e as mensagens ficarão sem resposta automática.
</Warning>

### Fluxo de Atendimento

```
Visitante envia mensagem
        ↓
  Agente de IA ativo?
  SIM → Agente responde automaticamente
  NÃO → Conversa fica aguardando operador
        ↓
  Fallback Humano ativo?
  SIM → Notificação enviada ao operador
  NÃO → Sem resposta até operador verificar painel
```

<Info>
  Conversas do Live Chat aparecem na aba de conversas do painel Brainchat, ao lado das conversas de WhatsApp. Operadores respondem pelo mesmo painel unificado.
</Info>