Os Campos Inteligentes (campos personalizados) permitem que você adicione informações extras aos contatos e conversas da Nuvia além dos campos nativos (nome, telefone, e-mail). Com eles, você pode armazenar dados específicos do seu negócio — como segmento do cliente, origem do lead, valor do contrato ou qualquer informação relevante para sua operação.
Disponível em: todos os planos.
Quem pode fazer: administradores e usuários com permissão de configuração.
Módulo: Menu lateral > Campos Inteligentes (ou acesso via configuração de listas)
O que você precisa antes de começar
Ter acesso ao módulo de Campos Inteligentes no menu lateral
Saber qual tipo de dado você quer armazenar (texto, número ou data)
Definir em qual contexto o campo será usado (contatos, conversas ou ambos)
Conceitos fundamentais
Conceito
| O que é
| Quando usar
|
Campo Inteligente
| Campo personalizado que armazena dados extras em contatos ou conversas
| Quando os campos nativos (nome, telefone, e-mail) não são suficientes para sua operação
|
Contexto do campo
| Define onde o campo aparece: Contatos, Conversas ou Misto
| Escolha conforme o uso. Campos de Contato ficam no perfil; campos de Conversa ficam no contexto do atendimento
|
Slug
| Identificador técnico gerado automaticamente a partir do nome do campo
| Usado internamente. Você não precisa se preocupar com ele
|
Campos personalizados são globais: uma vez criado, o campo fica disponível em toda a plataforma — em listas, importações CSV, filtros de busca e contexto de atendimento.
Os valores ficam no contato: os dados de campos personalizados são armazenados no registro do contato (ou conversa), não na lista. Se um contato aparece em múltiplas listas, o valor do campo é o mesmo em todas.
Criar um campo personalizado
No menu lateral, clique em Campos Inteligentes
Clique em Criar campo
Preencha:
Nome — nome descritivo do campo (ex: "Segmento", "Origem do Lead", "Valor do Contrato")
Tipo — escolha o tipo de dado:
Tipo
| Descrição
| Exemplo
|
Texto
| Texto livre
| "Enterprise", "Indicação do João"
|
Número
| Valor numérico
| 50000, 12
|
Data
| Data
| 2026-03-15
|
Contexto — onde o campo será usado:
Contexto
| Onde aparece
|
Contatos
| No perfil do contato, em listas e importações CSV
|
Conversas
| No painel de atendimento, durante conversas
|
(Opcional) Adicione uma descrição para ajudar outros usuários a entenderem o propósito do campo
Clique em Salvar
O campo é criado imediatamente e fica disponível em toda a plataforma.
💡 Dica: Use nomes claros e objetivos para os campos. Campos como "Segmento do Cliente" ou "Data de Primeiro Contato" são mais úteis do que "Campo 1" ou "Extra".
Usar campos personalizados em listas
Campos personalizados podem ser adicionados como colunas em listas, permitindo visualizar e editar os dados diretamente na tabela.
Adicionar como coluna
Abra a lista desejada
Clique em Adicionar coluna
Selecione Campo customizado
Escolha o campo personalizado na lista de campos disponíveis
A coluna é adicionada à tabela
Editar valores
Células de campos personalizados são editáveis diretamente na tabela:
Clique na célula para editar
Digite o novo valor
Pressione Enter para salvar ou Escape para cancelar
⚠️ Importante: Ao editar um valor de campo personalizado na lista, você está editando o registro do contato. A alteração será refletida em todas as listas onde esse contato aparece.
Usar campos personalizados em importações CSV
Ao importar um CSV, você pode mapear colunas do arquivo para campos personalizados existentes.
Durante o Passo 2 — Mapeamento de colunas da importação CSV, no dropdown de campo de destino, os campos personalizados aparecem como opções
Selecione o campo customizado correspondente à coluna do CSV
O sistema importará os valores do CSV para o campo personalizado de cada contato
Para o passo a passo completo da importação CSV, consulte Como importar contatos via CSV.
💡 Dica: Se o campo personalizado ainda não existe, crie-o antes de iniciar a importação. Campos criados após o início do wizard não aparecem nas opções de mapeamento.
Limites e regras
Regra
| Valor
|
Tipos de campo disponíveis
| Texto, Número, Data
|
Contextos disponíveis
| Contatos, Conversas
|
Valores aceitos
| Primitivos: texto, número ou data. Não aceita objetos ou listas aninhadas
|
Escopo do campo
| Global — disponível em toda a plataforma após criado
|
Escopo do valor
| Vinculado ao registro do contato — compartilhado entre listas
|
Limite de campos por conta
| Sem limite definido
|
Erros comuns e soluções
Problema
| Causa provável
| Solução
|
Campo personalizado não aparece no mapeamento do CSV
| O campo foi criado depois de abrir o wizard de importação
| Feche o wizard, confirme que o campo existe em Campos Inteligentes e reinicie a importação
|
Valor importado aparece em branco
| A coluna do CSV não foi mapeada para o campo correto
| Verifique o mapeamento no Passo 2 da importação. A coluna do CSV precisa estar associada ao campo personalizado
|
Edição de campo na lista altera o valor em outra lista
| Comportamento esperado
| Campos personalizados são do registro do contato, não da lista. A alteração se reflete em todos os lugares
|
Campo do tipo Número aceita texto
| Dados inválidos importados via CSV
| Garanta que a coluna do CSV contém apenas valores numéricos antes de mapear para um campo do tipo Número
|
Perguntas frequentes
Posso criar campos com tipos além de Texto, Número e Data?
No momento, apenas esses 3 tipos estão disponíveis para campos personalizados. Para dados que não se encaixam nesses tipos, use o tipo Texto como alternativa.
Os campos personalizados aparecem nos filtros de busca?
Campos personalizados podem ser usados como filtros em listas (via views e filtros). Na Busca (módulo de prospecção), os filtros são baseados em campos estruturados do provider de dados, não em campos customizados.
Posso excluir um campo personalizado?
A exclusão de um campo personalizado remove o campo e seus valores de todos os registros. Verifique se o campo não está sendo usado em listas, funis inteligentes ou integrações antes de excluir.
Os campos personalizados são acessíveis pela IA nos Funis Inteligentes?
Sim. Campos personalizados do contexto Contatos ficam disponíveis como dados adicionais do contato durante as conversas gerenciadas por Funis Inteligentes. A IA pode consultar e usar esses valores para personalizar o atendimento.
Posso usar campos personalizados como variáveis em templates de WhatsApp?
Sim. Ao configurar variáveis de template em uma campanha de WhatsApp, os campos personalizados aparecem como opções de mapeamento para as variáveis {{1}}, {{2}}, etc. Consulte Como usar variáveis em templates WhatsApp para mais detalhes.
Qual a diferença entre um campo personalizado e uma coluna customizada da lista?
Um campo personalizado é global — pertence ao registro do contato e é compartilhado entre todas as listas. Uma coluna customizada é local — pertence a uma lista específica e armazena dados extras que só fazem sentido naquele contexto. Use campos personalizados para dados universais (ex: segmento, origem) e colunas customizadas para dados contextuais (ex: notas de campanha, score local).