1. [Ajuda](https://nuvia.ai/docs)
2. [Listas](https://nuvia.ai/docs/colecoes/19377988-listas)
3. [Registros](https://nuvia.ai/docs/colecoes/19429826-registros)

# 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

Atualizado em 3 de agosto de 2026

[Registros](https://nuvia.ai/docs/colecoes/19429826-registros)

1. [Como visualizar e exportar conversas](https://nuvia.ai/docs/artigos/15363594-como-visualizar-e-exportar-conversas)
2. [Como marcar um contato como “Não abordar”](https://nuvia.ai/docs/artigos/18174500-como-marcar-um-contato-como-nao-abordar)
3. [Como gerenciar empresas](https://nuvia.ai/docs/artigos/14590390-como-gerenciar-empresas)
4. [Como usar campos personalizados](https://nuvia.ai/docs/artigos/14580091-como-usar-campos-personalizados)

Nesta página

1. O que você precisa antes de começar
2. Conceitos fundamentais
3. Criar um campo personalizado
4. Limites e regras
5. Erros comuns e soluções

**Nesta página5 seções**

1. O que você precisa antes de começar
2. Conceitos fundamentais
3. Criar um campo personalizado
4. Limites e regras
5. Erros comuns e soluçõ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

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

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.

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

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

[AnteriorComo gerenciar empresas](https://nuvia.ai/docs/artigos/14590390-como-gerenciar-empresas)

Este artigo ajudou?

## Artigos relacionados

- [Como gerenciar listas e contatos](https://nuvia.ai/docs/artigos/14499469-como-gerenciar-listas-e-contatos)
- [Como configurar e usar Follow-ups Inteligentes na Nuvia](https://nuvia.ai/docs/artigos/14580483-como-configurar-e-usar-follow-ups-inteligentes-na-nuvia)
- [Glossário de termos da Nuvia](https://nuvia.ai/docs/artigos/14580494-glossario-de-termos-da-nuvia)
- [Como criar habilidades personalizadas para o agente de IA](https://nuvia.ai/docs/artigos/14590394-como-criar-habilidades-personalizadas-para-o-agente-de-ia)
- [Como usar variáveis em templates WhatsApp na Nuvia](https://nuvia.ai/docs/artigos/15353096-como-usar-variaveis-em-templates-whatsapp-na-nuvia)

[Registros](https://nuvia.ai/docs/colecoes/19429826-registros)

1. [Como visualizar e exportar conversas](https://nuvia.ai/docs/artigos/15363594-como-visualizar-e-exportar-conversas)
2. [Como marcar um contato como “Não abordar”](https://nuvia.ai/docs/artigos/18174500-como-marcar-um-contato-como-nao-abordar)
3. [Como gerenciar empresas](https://nuvia.ai/docs/artigos/14590390-como-gerenciar-empresas)
4. [Como usar campos personalizados](https://nuvia.ai/docs/artigos/14580091-como-usar-campos-personalizados)

## Ainda precisa de ajuda?

Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time.

[Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact)

---
Source: https://nuvia.ai/docs/artigos/14580091-como-usar-campos-personalizados
