# Criar campos personalizados

> Crie campos para guardar uma informação de cada contato, como a cidade ou o plano de interesse, e use o valor nas mensagens dos fluxos.

Endereço: https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/
Tipo: Tutorial · Básico

Atualizado em: 24/10/2026

> **Resposta rápida**
>
> Em **Fluxos**, aba **Campo Personalizados**, clique no **Adicionar** do topo, dê um nome, escolha o tipo e clique em **Continuar**. Para mostrar o valor numa mensagem, digite `{` no texto e escolha o campo.

**Antes de começar**

- Acesso à área **Fluxos** no seu usuário. Veja [Administradores e permissões](https://help.nextags.com.br/tutoriais/configuracoes/administradores-e-permissoes/).
- Saber se a informação muda de um contato para outro (campo personalizado) ou é uma só para a conta inteira. Para o segundo caso, veja [Campos do bot](https://help.nextags.com.br/tutoriais/fluxos/campos-do-bot/).

## Passo a passo

### Passo 1: Abra a tela de campos

No menu da esquerda, clique em **Fluxos** e depois na aba **Campo Personalizados**.

![Tela Campo Personalizados: o botão Adicionar, a lista de campos com as colunas Tipo e Caixa de Entrada e, embaixo, a seção Campo Personalizados do Bot.](https://help.nextags.com.br/_img/fluxos-dados/campos-tela.webp)
*A tela de campos, com as partes numeradas.*

1. **Campo Personalizados**, nas abas da área Fluxos.
2. **Adicionar**: cria um campo do contato.
3. **Tipo**: o tipo de cada campo.
4. **Caixa de Entrada**: mostra ou esconde o campo no painel do contato, na conversa.
5. **Campo Personalizados do Bot**: outra lista, com valores que valem para a conta toda. Veja [Campos do bot](https://help.nextags.com.br/tutoriais/fluxos/campos-do-bot/).

### Passo 2: Crie o campo

Clique em **Adicionar**, no topo da tela, e preencha a janela **Adicionar Novo**.

![Janela Adicionar Novo de um campo personalizado: nome Plano de interesse, tipo Seleção única e as opções Start e Pro.](https://help.nextags.com.br/_img/fluxos-dados/campos-novo.webp)
*A janela Adicionar Novo de um campo do contato.*

1. **Nome**: como o campo aparece nas listas e nas mensagens.
2. **Tipo**: **Texto**, **Número**, **Data**, **Data e hora**, **Verdadeiro/Falso**, **Texto longo**, **Seleção única** ou **Seleção múltipla**.
3. **Opções**: só nos tipos de seleção. Escreva uma opção por linha; **Adicionar Novo** abre mais uma linha.
4. **Continuar** cria o campo.

A **Descrição** é opcional e aparece embaixo do nome, na lista de campos.

> **Escolha bem o tipo:**
> Depois de criado, o campo pode mudar de nome, de opções e de descrição (menu **⋮** › **Editar**), mas não de tipo. Para outro tipo, crie um campo novo.

### Passo 3: Decida se o campo aparece na conversa

O interruptor da coluna **Caixa de Entrada** decide se o campo aparece no painel do contato, na conversa.

![Coluna Caixa de Entrada da lista de campos personalizados: o campo Cidade com o interruptor ligado e o CPF com ele desligado.](https://help.nextags.com.br/_img/fluxos-dados/campos-caixa.webp)
*A coluna Caixa de Entrada da lista de campos.*

1. Ligado: o campo **Cidade** aparece no painel do contato.
2. Desligado: o **CPF** continua guardado no contato, mas não aparece na conversa.

### Passo 4: Use o campo numa mensagem

No editor do fluxo, clique no texto da mensagem e digite `{` seguido do começo do nome do campo. Escolha o campo na lista.

![Texto de uma mensagem no editor de fluxo: ao digitar uma chave e o começo do nome, a lista sugere o campo Cidade.](https://help.nextags.com.br/_img/fluxos-dados/variavel-campo.webp)
*A lista de campos ao digitar uma chave e o começo do nome.*

1. A lista mostra os campos com esse nome. Ao escolher **Cidade**, o texto fica com `{{Cidade}}`, que chega ao contato com o valor dele.

Também dá para clicar no ícone **</>**, no canto do texto, para abrir a lista. Para guardar a resposta do contato no campo, use a pergunta [Adquirir Dados](https://help.nextags.com.br/tutoriais/fluxos/perguntar-e-salvar-resposta/). Para preencher o campo durante o fluxo, use a ação **Definir Campo Personalizado**: veja [Etiquetas e campos no fluxo](https://help.nextags.com.br/tutoriais/fluxos/etiquetas-e-campos-no-fluxo/).

## Editar, mover ou excluir um campo

Clique no **⋮** do campo:

![Menu de um campo personalizado aberto: Editar, Ver Análise, Mover para Pasta, Obter ID e Excluir.](https://help.nextags.com.br/_img/fluxos-dados/campos-menu.webp)
*O menu de um campo personalizado.*

1. **Editar**: muda o nome, a descrição e, nos tipos de seleção, as opções.
2. **Ver Análise**: abre a análise do campo numa nova aba.
3. **Mover para Pasta**: leva o campo para uma pasta. Aparece quando a área já tem pastas.
4. **Obter ID**: copia o número do campo, usado na API e em integrações.
5. **Excluir**: apaga o campo. O app pede confirmação e avisa que não dá para desfazer.

> **Mudou o nome? Confira as mensagens:**
> A variável leva o nome do campo, como `{{Cidade}}`. Depois de renomear, abra os fluxos que usam o campo e confira se as mensagens continuam certas.

## Pronto: como conferir

- O campo aparece na lista de **Campo Personalizados**, com o tipo escolhido.
- Com o interruptor **Caixa de Entrada** ligado, o campo aparece no painel do contato. Veja [Etiquetas e campos personalizados na conversa](https://help.nextags.com.br/tutoriais/caixa-de-entrada/etiquetas-e-campos-na-conversa/).
- Para testar a mensagem com o valor de verdade, veja [Testar o fluxo](https://help.nextags.com.br/tutoriais/fluxos/testar-fluxo/).

## Se não funcionou

### Apareceu "O nome já existe, por favor escolha outro nome."

Já existe um campo com esse nome. Use outro nome ou aproveite o campo que já existe (use a lupa, em cima da lista, para achar o campo, também dentro das pastas).

### Apareceu "This name is reserved. Please choose any other name"

A plataforma reserva alguns nomes para uso próprio. Escolha outro nome para o campo.

### O campo não aparece na conversa

Ligue o interruptor **Caixa de Entrada** do campo, na lista de **Campo Personalizados**.

### Não acho o campo na lista do editor

A lista do editor abre quando você digita `{` ou clica no ícone **</>**. Depois da chave, escreva parte do nome: a lista filtra pelo que você digitou. Se o campo foi criado com o editor aberto, recarregue a página do fluxo.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou guardar dados dos meus contatos em campos personalizados na NexTags. Leia este tutorial: https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados.md

Meu negócio: [descreva o que você vende] e o que quero saber de cada cliente: [ex.: cidade, plano de interesse, data de nascimento].

Para cada informação, sugira o nome do campo e o tipo (Texto, Número, Data, Data e hora, Verdadeiro/Falso, Texto longo, Seleção única ou Seleção múltipla, com as opções). Depois, escreva uma mensagem de boas-vindas que use pelo menos dois desses campos no formato {{Nome do campo}}.
```

> **Campos pela API:**
> Para criar campos e preencher o valor de um contato a partir do seu sistema, use a API: [Criar campo personalizado](https://docs.nextags.com.br/referencia/campos-personalizados/criar-campo-personalizado/) e [Preencher campo do contato](https://docs.nextags.com.br/referencia/campos-personalizados/preencher-campo-do-contato/).
