Como criar e usar campos personalizados de contato
Nível: Intermediário Tempo de leitura: 6 min Plano necessário: Todos os planos
O que são campos personalizados
Campos personalizados são propriedades extras que você define para os contatos da sua organização. Enquanto os campos padrão (Nome, Email, Telefone) existem para todos, os campos personalizados permitem guardar qualquer informação relevante ao seu negócio, como plano contratado, número de cliente, empresa, cargo, data de vencimento etc.
Os valores ficam armazenados no perfil do contato e ficam disponíveis em três lugares automaticamente:
- System prompt do agente:
{{contact.chave}}é substituído pelo valor salvo - Campanhas de WhatsApp:
{{chave}}funciona como variável nos templates - API de envio:
{{chave}}embody_paramsé substituído ao enviar templates
Como criar um campo personalizado
- No painel, acesse Conta (menu lateral) e clique na aba Campos personalizados
- Clique em Adicionar campo
- Preencha as configurações:
| Campo | Descrição |
|---|---|
| Label | Nome visível para o visitante no formulário (ex: "Plano contratado") |
| Chave | Identificador interno usado nas variáveis (ex: plano). Auto-sugerida a partir do label, mas pode ser editada na criação. A chave fica travada depois de criada. |
| Tipo | Formato do dado (veja tabela abaixo) |
| Placeholder | Texto de exemplo que aparece no campo vazio |
- Para tipos Seleção e Seleção múltipla, informe as opções separadas por vírgula
- Clique em Criar campo
A chave não pode ser alterada depois de criada porque ela pode estar em uso em prompts e campanhas.
Tipos de campo disponíveis
| Tipo | Input | Valor armazenado |
|---|---|---|
| Texto | Campo livre | string |
| Campo com validação de formato | string | |
| Campo com máscara de telefone | número formatado | |
| Data | Seletor de data | YYYY-MM-DD |
| Número | Campo numérico | string numérica |
| CPF | Campo com máscara e validação | somente dígitos |
| CNPJ | Campo com máscara e validação | somente dígitos |
| Seleção | Lista suspensa (uma opção) | string |
| Seleção múltipla | Caixas de seleção | opções separadas por vírgula |
| Sim/Não | Toggle | "true" ou "false" |
| Texto longo | Área de texto | string |
Campos padrão do sistema
Além dos campos personalizados, a Wevi tem seis campos padrão que já existem para todos os contatos e não precisam ser criados:
| Campo | Mapeado para |
|---|---|
| Nome | contacts.display_name |
contacts.email |
|
contacts.phone |
|
| CPF | contacts.custom_fields.cpf |
| CNPJ | contacts.custom_fields.cnpj |
| Data de nascimento | contacts.custom_fields.data_nascimento |
Campos padrão também podem aparecer no formulário pré-chat (veja abaixo).
Vinculando campos ao formulário pré-chat
Ao configurar um agente, você pode usar qualquer campo personalizado (ou campo padrão) no formulário pré-chat:
- Acesse o agente, aba Aparência, seção Formulário de Pré-chat
- Ative o toggle
- Clique em Adicionar campo e escolha:
- Campo padrão: Nome, Email, WhatsApp, CPF, CNPJ ou Data de nascimento
- Campo personalizado: qualquer campo criado em Conta → Campos personalizados
- Configure se é obrigatório e, se quiser, edite o label e o placeholder para aquele agente
Quando o visitante preenche o formulário e inicia a conversa, os dados são salvos no perfil do contato automaticamente. A partir daí, ficam disponíveis em campanhas e no prompt.
Usando nos prompts
Use {{contact.chave}} no system prompt do agente:
Você é o assistente da Acme.
O cliente que está conversando é {{contact.nome}} da empresa {{contact.empresa}},
no plano {{contact.plano}}.
Se o plano for "enterprise", ofereça suporte prioritário.
Se for "basic", encaminhe para a central de autoatendimento.
Se o campo não estiver preenchido, o marcador é substituído por uma string vazia. Prefira prompts que funcionem mesmo com campos ausentes.
Usando nas campanhas
Os campos personalizados ficam disponíveis como variáveis no formulário de campanha. Ao configurar as variáveis do template, selecione Campo do contato e escolha o campo desejado.
Veja mais em: Como criar e gerenciar campanhas no WhatsApp →
Editando e excluindo campos
Para editar um campo personalizado existente:
- Acesse Conta → Campos personalizados
- Clique no ícone de lápis ao lado do campo
- Você pode editar o label, o placeholder e as opções (para Seleção e Seleção múltipla)
- A chave interna não pode ser alterada
Para excluir um campo, clique no ícone de lixeira. Os valores já salvos nos contatos são mantidos, mas o campo deixa de aparecer na interface.
Chaves reservadas
As seguintes chaves são reservadas para campos padrão do sistema e não podem ser usadas em campos personalizados: name, email, phone, cpf, cnpj, data_nascimento.
Preenchendo campos de outros sistemas
Você pode preencher campos personalizados de forma automática a partir de CRMs e outras ferramentas usando o Webhook de Contatos.
Veja mais em: Como usar o Webhook de Contatos →