Como usar formulários pré-chat
Nível: Iniciante Tempo de leitura: 5 min
O que é o formulário pré-chat
O formulário pré-chat é uma tela que aparece antes da conversa começar. O cliente preenche seus dados e só então acessa o chat.
Use quando você precisa identificar o cliente, qualificar o contato ou coletar informações que o agente vai usar durante o atendimento.
Ativando o formulário
Selecione o agente desejado, abra a aba Aparência e localize a seção Formulário de Pré-chat. Ative o toggle.
Com o toggle ativado, a tela de identificação passa a aparecer para todos os usuários que acessarem o chat pela primeira vez.
Adicionando campos ao formulário
Ao clicar em Adicionar campo, você escolhe entre dois grupos:
Campos padrão são os campos de identificação básica, disponíveis para todos sem configuração extra:
| Campo | O que coleta |
|---|---|
| Nome | Nome do visitante |
| Endereço de e-mail | |
| Número de celular | |
| CPF | CPF com validação automática |
| CNPJ | CNPJ com validação automática |
| Data de nascimento | Data formatada |
Campos personalizados são os campos criados pela sua organização em Conta → Campos personalizados. Qualquer campo cadastrado lá aparece aqui para ser adicionado ao formulário.
Não encontrou o campo que precisa? Crie-o primeiro em Conta → Campos personalizados.
Tipos de campo disponíveis
Os campos personalizados podem ter os seguintes tipos:
| Tipo | Input |
|---|---|
| Texto | Campo de texto livre |
| Campo com validação de formato | |
| Campo com máscara de telefone | |
| Data | Seletor de data |
| Número | Campo numérico |
| CPF | Campo com máscara e validação |
| CNPJ | Campo com máscara e validação |
| Seleção | Lista suspensa (uma opção) |
| Seleção múltipla | Caixas de seleção |
| Sim/Não | Toggle |
| Texto longo | Área de texto |
Configuração de cada campo
Cada campo tem três configurações:
- Label: o rótulo que o cliente vê (ex: "Nome completo", "Empresa")
- Placeholder: o texto de exemplo dentro do campo (ex: "Digite seu nome")
- Obrigatório: se ativado, o cliente não consegue avançar sem preencher
Campos obrigatórios garantem dados completos, mas formulários muito longos reduzem a taxa de início de conversa. O ideal é pedir apenas o que você realmente vai usar.
Como os dados aparecem no painel
As informações do pré-chat são salvas no perfil do contato automaticamente:
- Nome, email e WhatsApp vão para os campos de identificação do contato.
- Campos adicionais vão para a seção de campos personalizados do contato.
No painel de Contatos, todas essas informações ficam visíveis no perfil e podem ser usadas para segmentar campanhas de WhatsApp.
O agente tem acesso aos dados?
Sim. Todos os campos preenchidos ficam disponíveis como variáveis no system prompt. Use {{contact.chave}} para referenciar qualquer campo personalizado, onde chave é o identificador interno do campo.
Por exemplo, se você tem um campo personalizado com chave plano, use {{contact.plano}} no prompt:
Você é o assistente da Acme.
O cliente que está conversando é {{contact.nome}} e está no plano {{contact.plano}}.
Veja mais em: Como usar dados do pré-chat no prompt e nas ações
Casos de uso comuns
- Clínica: coleta nome, telefone e tipo de consulta antes de iniciar o agendamento
- E-commerce: coleta email e número do pedido para identificar o cliente na base de dados
- B2B: coleta nome, empresa e cargo para qualificar o lead antes do atendimento
- Suporte: coleta CPF ou número de contrato para agilizar a identificação