--- title: "Criando campos personalizados" url: https://ajuda.botconversa.com.br/aula/criando-campos-personalizados section: "Organizando clientes" date_modified: 2026-09-06T18:35:20.325155+00:00 language: pt-BR --- # Criando campos personalizados [Vídeo da aula](https://www.youtube.com/watch?v=eR7dX27BHXQ) **Tempo de leitura:** ~5 min**Para quem é:** Dono do negócio | Gestor | Marketing ## Resposta rápida Um **campo personalizado** é uma informação sua sobre o contato — por exemplo, tamanho de roupa, cidade, ou data da última compra. Você cria o campo em **Configurações**, escolhe o tipo (Texto, Número, Data ou Data e Hora) e depois preenche o valor à mão ou capturando a resposta do cliente em um fluxo. ## Antes de começar - Liste quais informações sobre seus clientes você quer guardar. Cada uma vira um campo. ## O que é um campo personalizado Pense numa ficha de cliente em papel. Além de nome e telefone, você anota coisas que importam para o seu negócio: "tamanho M", "prefere atendimento à tarde", "última compra em março". No BotConversa, cada uma dessas anotações é um **campo personalizado**. A diferença para a etiqueta é simples: a etiqueta só diz se o contato pertence ou não a um grupo. O campo guarda um **valor** — um texto, um número ou uma data. ### Campos do Usuário × Campos do Robô Existem **duas abas** em Configurações → Campos, e elas servem para coisas diferentes: Aba O que guarda Exemplos Quando usar **Campos do Usuário** Dados **permanentes** do contato — ficam para sempre no Cartão do Usuário. `cidade`, `tamanho_roupa`, `data_aniversario`, `valor_pedido` Tudo que você quer saber sobre o cliente: perfil, preferências, histórico. **Campos do Robô** Variáveis **internas** que o fluxo usa durante a execução (sessão). Não fazem parte do perfil do cliente. `tentativas_resposta`, `etapa_atual`, contadores temporários Lógica interna de fluxo, contagem em loops, marcadores de estado. > Para **guardar dados do cliente**, sempre use **Campos do Usuário**. Campos do Robô existem para controle interno do bot. ### Identificando o tipo do campo Cada tipo tem uma forma diferente de armazenar e exibir: - **Texto** — qualquer string (cidade, observação, ID externo). Sem máscara. - **Número** — só dígitos (idade, quantidade, valor de pedido). Permite comparações `>`, `<`, `=` em condições de fluxo. - **Data** — formato `DD/MM/AAAA` (data de aniversário, vencimento). Em fluxos, pode receber o valor por **link externo** (calendário) além da digitação. - **Data e Hora** — formato `DD/MM/AAAA HH:MM` (próximo agendamento, horário de consulta). Também aceita preenchimento via **link externo** de seleção. > **Limpar valores em massa:** se você quer **zerar** um campo personalizado para vários contatos de uma vez, use a **ação em massa** "Limpar valor de campo personalizado" em **Contatos** (com filtros aplicados). ## Passo a passo ### Passo 1: Abra a tela de Campos 1. No menu lateral, vá em **Configurações**. 2. Entre em **Automação** e depois em **Campos**. 3. Fique na aba **Campos do Usuário** (são os dados do contato). ![Tela de campos em Configuracoes na aba Campos do Usuario](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/criando-campos-personalizados/passo-1.png) Tela de campos em Configuracoes na aba Campos do Usuario ### Passo 2: Crie o campo 1. Clique em **Criar**. 2. Dê um **Nome** ao campo (ex.: `tamanho_roupa` ou `cidade`). 3. Escolha o **Tipo** de informação que ele vai guardar: - **Texto** — para informações escritas (cidade, plano, observação). - **Número** — para valores numéricos (quantidade, idade). - **Data** — para uma data simples (data de aniversário). - **Data e Hora** — para data com horário (agendamento de consulta). 4. Se quiser, escreva uma **Descrição**. 5. Clique em **Criar campo**. ![Janela de criar campo com o seletor de tipo](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/criando-campos-personalizados/passo-2.png) Janela de criar campo com o seletor de tipo ### Passo 3: Preencha o valor do campo Há duas formas de preencher: **À mão:** abra o **Cartão do Usuário** (em Contatos ou no Inbox), vá na seção **Campos Personalizados**, clique em **+**, escolha o campo e digite o valor. **Automaticamente:** dentro de um fluxo, você pergunta algo ao cliente (ex.: "Qual o seu tamanho?") e manda salvar a resposta no campo `tamanho_roupa`. A partir daí, toda vez que alguém responder, o valor é guardado sozinho naquele contato. ## Dicas - Escolha o tipo certo logo no começo. Um campo de **Data** permite, mais tarde, montar lembretes e condições baseadas na data; um campo de Texto não tem essa esperteza. - Use nomes claros e sem espaços (ex.: `data_ultima_compra`). Isso facilita reaproveitar o campo nos fluxos. - Depois de capturar um dado, você pode usá-lo para personalizar mensagens (ex.: "Olá, vi que você é de São Paulo!") e para filtrar contatos. ## Casos de uso **Loja de roupas:** você cria o campo `tamanho_roupa` (Texto). No fluxo de boas-vindas, o robô pergunta o tamanho e salva. Depois, quando chega uma coleção nova, você filtra por tamanho e avisa só quem veste aquele número. **Clínica:** o campo `data_consulta` (Data e Hora) guarda o horário marcado por cada paciente. Você usa esse dado para programar lembretes automáticos. ## Perguntas frequentes Qual a diferença entre campo personalizado e etiqueta? A etiqueta agrupa (o contato tem ou não tem o rótulo). O campo guarda uma informação com valor (texto, número ou data). Use etiqueta para separar grupos e campo para registrar um dado específico. Posso usar o valor de um campo dentro de uma mensagem? Sim. Você pode inserir o conteúdo de um campo no meio de uma mensagem para personalizá-la, como chamar o cliente pelo dado que ele informou. O que são os "Campos do Robô"? São variáveis que o robô usa internamente durante a conversa, separadas dos dados do contato. Para guardar informações sobre seus clientes, use sempre a aba **Campos do Usuário**. Dá para filtrar contatos por um campo personalizado? Sim. Na tela de Contatos, em **Filtros**, escolha **Campo personalizado** e defina o valor que você procura.