> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como criar campos personalizados

> Crie campos para guardar informações dos seus clientes, como cidade, data de aniversário ou plano contratado, e use esses dados em mensagens, fluxos e campanhas

Todo contato já vem com nome, telefone e e-mail. Quando você precisa guardar outra informação sobre o cliente, como a cidade, a data de aniversário ou o plano que ele contratou, cria um campo personalizado. Ele passa a aparecer na ficha de todos os contatos, pronto para ser preenchido.

Com o dado guardado, você chama o cliente pelo que importa para ele: manda "Feliz aniversário!" no dia certo, separa quem mora em Campinas para uma promoção da loja de lá ou mostra só as opções do plano que a pessoa tem.

## Criar um campo

**1. Abra a tela de campos**

Clique em **Configurações** e, no grupo **Automação**, em **Campos**. A tela **Campos e Variáveis** abre na aba **Campos do Contato**, com a lista dos campos que já existem. Depois clique em **Novo Campo**.

![Tela Campos e Variáveis com o item Campos do menu e o botão Novo Campo numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/01-tela-campos.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=e58f97e8a2f0a7e6ac2ac13db86853bc)

**2. Dê um nome e escolha o tipo**

Na janela **Novo Campo Personalizado**:

1. Em **Nome**, digite como o campo vai se chamar, por exemplo `ultima_compra`.
2. Em **Tipo**, escolha o tipo de informação, como **Data**.
3. Clique em **Criar**. Aparece o aviso **Campo criado** e o campo entra na lista.

O nome aceita só letras sem acento, números e o sublinhado (`_`). Enquanto você digita, os espaços viram `_` e os acentos somem sozinhos: "Data de aniversário" fica `Data_de_aniversario`. Prefira nomes curtos, porque é por eles que você vai chamar o campo nas mensagens.

![Janela Novo Campo Personalizado com o nome ultima\_compra, o tipo Data e o botão Criar numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/02-novo-campo-data.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=6623ad947cf9ae3063cfa63f9196115e)

**3. Entenda os tipos**

O tipo define como o dado é preenchido na ficha do contato:

![Lista de tipos aberta com Texto, Número, E-mail, Telefone, Data, Seleção e Sim/Não](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/03-tipos.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=e3ce7a562d0e74911a520c27f2f9b396)

| Tipo | Quando usar | Exemplo |
| - | - | - |
| **Texto** | Qualquer informação escrita | Cidade, CPF, produto preferido |
| **Número** | Quantidades e valores | Pedidos no ano |
| **E-mail** | Um segundo e-mail do cliente | E-mail do financeiro |
| **Telefone** | Outro número de contato | Telefone do trabalho |
| **Data** | Um dia do calendário | Aniversário, data da última compra |
| **Seleção** | Uma resposta entre opções fixas | Plano contratado: Básico, Profissional ou Empresarial |
| **Sim/Não** | Uma resposta de sim ou não | Cliente VIP |

**4. Cadastre as opções de um campo de seleção**

Se escolheu **Seleção**, aparece o campo **Opções**. Digite uma opção em **Nova opção** e aperte Enter (ou clique no **+**). Repita para cada opção. Para tirar uma, clique no **×** ao lado dela.

Quando terminar, clique em **Criar**.

![Campo forma\_pagamento do tipo Seleção com as opções Pix, Cartão de crédito e Boleto, e o campo Nova opção e o botão Criar numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/04-opcoes.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=fa8e387224c8b5368c71400ab2ef5fe0)

> [!NOTE]
>
> Alguns nomes são reservados pelo sistema, como `nome`, `telefone`, `email` e `tags`, porque já existem em todo contato. Se você digitar um deles, a janela mostra o aviso e o botão **Criar** fica desligado. O mesmo acontece com um nome igual ao de um campo que já existe, mesmo com letras maiúsculas diferentes.

## Editar ou excluir um campo

**1. Abra o menu do campo**

Na lista, clique nos três pontinhos da coluna **Ações**, na linha do campo, e escolha **Editar** ou **Excluir**. Clicar direto na linha também abre a edição.

![Menu de ações do campo plano\_contratado aberto, com Editar e Excluir numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/05-menu-acoes.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=e94c7da12af5526e6fe7ecc8f207a972)

**2. Altere e salve**

Na janela **Editar Campo**, mude o nome, o tipo ou, num campo de seleção, acrescente e tire opções. Clique em **Salvar**. Aparece o aviso **Campo atualizado**.

![Janela Editar Campo do plano\_contratado com as opções Básico, Profissional e Empresarial, o campo Nova opção e o botão Salvar numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/06-editar.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=5913623def23e0f0ef50b40e7a23f910)

> [!WARNING]
>
> Nas mensagens, o campo é chamado pelo nome, como `{{plano_contratado}}`. Se você trocar o nome, revise os textos de fluxos, modelos e respostas que usam o nome antigo.

**3. Confirme a exclusão**

Ao escolher **Excluir**, a janela **Excluir campo** pede confirmação. Clique em **Excluir** para apagar ou em **Cancelar** para desistir. Aparece o aviso **Campo excluído**.

![Janela Excluir campo com o aviso de que os dados serão removidos de todos os contatos e o botão Excluir destacado](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/07-excluir.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=9d5731b728af7a8f33791757c3258bf7)

> [!WARNING]
>
> A exclusão não pode ser desfeita. O valor que cada contato tinha nesse campo é apagado junto.

## Onde o campo é usado

### Na ficha do contato

Abra um contato em **Contatos**. Os campos aparecem em **Campos Personalizados**, do lado direito da ficha. A ficha mostra os três primeiros; clique em **Ver todos** para ver o resto.

Para preencher, clique no valor ao lado do nome do campo. Campo de texto, número ou data você digita e clica fora para salvar. Campo de **Seleção** ou **Sim/Não** abre a lista de opções. Campo vazio aparece como **Não Definido**. Veja mais em [Abrir e completar um contato](https://help.wizebot.com.br/tutoriais/gerenciador-contatos/contatos.md#abrir-e-completar-um-contato).

![Ficha da contato Fernanda Souza com a seção Campos Personalizados destacada, mostrando Cidade, aniversario e plano\_contratado preenchidos](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/09-ficha-contato.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=c7979a78566c1860c8d7978a0e5a4b89)

Para preencher o mesmo valor em muitos contatos de uma vez, marque os contatos na lista e use **Opções** > **Definir campo personalizado**.

### Nas mensagens, com variáveis

Nos textos de fluxos, mensagens e modelos, o campo entra como variável, entre chaves duplas. Na hora do envio, a WizeBot troca a variável pelo dado de cada cliente. Por exemplo, `Seu plano é o {{plano_contratado}}` chega como "Seu plano é o Profissional".

No editor de texto de um bloco do fluxo:

1. Clique no botão de chaves (`{ }`) da barra de formatação.
2. Em **Campos Personalizados**, clique no campo. A variável entra no texto onde estava o cursor.

O nome da variável é o nome do campo em letras minúsculas: o campo `Cidade` vira `{{cidade}}`.

![Lista de variáveis aberta num bloco do fluxo, com o botão de chaves e o campo plano\_contratado numerados](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/10-variavel-fluxo.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=bab69a4b88c2ef8d8581cc5c3c96d6e2)

Numa [campanha](https://help.wizebot.com.br/tutoriais/campanha/mensagem-em-massa.md), se parte dos contatos estiver com o campo vazio, a WizeBot avisa a porcentagem afetada e esses contatos recebem um "-" no lugar do valor.

### Nos fluxos, para guardar e conferir respostas

* No bloco **Entrada de dados**, em **Salvar resposta em**, escolha o campo que recebe o que o cliente digitou, como o CPF. Na **Mensagem interativa**, use **Salvar resposta do usuário** para guardar o botão que ele clicou. Veja [Blocos de conteúdo](https://help.wizebot.com.br/tutoriais/fluxos/blocos-conteudo.md).
* No bloco **Ação**, use **Definir campo** para gravar um valor e **Limpar campo** para apagar. No bloco **Condição**, confira o valor de um campo para mandar o cliente por caminhos diferentes. Veja [Blocos de lógica](https://help.wizebot.com.br/tutoriais/fluxos/blocos-logica.md).
* Numa [Integração HTTP](https://help.wizebot.com.br/tutoriais/fluxos/blocos-integracoes.md), guarde no campo um dado que voltou do seu sistema, como o código de rastreio.
* Num [formulário do WhatsApp](https://help.wizebot.com.br/tutoriais/whatsapp-flows/criar-formulario.md), cada pergunta pode salvar a resposta num campo.

> [!TIP]
>
> Crie o campo antes em **Configurações** > **Campos**. Os blocos do fluxo só mostram campos que já existem.

### Na importação de contatos

Ao [importar uma planilha](https://help.wizebot.com.br/tutoriais/gerenciador-contatos/importar.md), cada coluna extra, como **cidade**, pode ir para um campo que já existe ou para um campo novo, criado na hora com o nome que você digitar.

### No relatório de valores

Na tela de campos, clique em **Relatórios** para ver, contato por contato, o valor guardado em cada campo e quando ele foi preenchido. Use **Buscar por contato...** para achar uma pessoa e **Todos os campos** para filtrar um campo só. Clique em **Voltar** para retornar à lista.

![Relatório de campos com contatos, campos, valores e datas, e o filtro Todos os campos destacado](https://mintcdn.com/wizebot-d8529edc/PNBfVIv9snTLYCki/images/campos-personalizados/08-relatorios.png?fit=max\&auto=format\&n=PNBfVIv9snTLYCki\&q=85\&s=33ec016d94681eedeeed72c600687d82)

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.