Agendar Demo
Cases
Agendar Demo

Como usar campos personalizados

Adicione dados customizados aos seus contatos e conversas

Disponível em
todos os planos
Quem pode fazer
administradores e usuários com permissão de configuração

Nesta página5 seções

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

Módulo: Tela Principal > Menu Lateral > Seu Nome > Configurações > Campos personalizados

O que você precisa antes de começar

  • 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

ConceitoO 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

Criar um campo personalizado

  1. Acesse Tela Principal > Menu Lateral > Seu Nome > Configurações > Campos personalizados

  2. Clique em Criar campo

  3. Preencha:

    • Nome – nome descritivo do campo (ex: “Segmento”, “Origem do Lead”, “Valor do Contrato”)

    • Tipo – escolha o tipo de dado:

TipoDescriçãoExemplo
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:

ContextoOnde aparece
Contatos No perfil do contato, em listas e importações CSV
Conversas No painel de atendimento, durante conversas

4. (Opcional) Adicione uma descrição para ajudar outros usuários a entenderem o propósito do campo

5. Clique em Criar campo

O campo é criado imediatamente e fica disponível em toda a plataforma.

Limites e regras

RegraValor
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

ProblemaCausa provávelSoluçã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.

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 utilizando @.

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.

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

Este artigo ajudou?