Como criar campos customizados no Mautic

Os campos padrão do Mautic — nome, e-mail, telefone, empresa, cargo — dão conta do básico, mas nenhum negócio cabe inteiro neles. A tese em uma frase: os campos customizados são o que transforma o Mautic num CRM do seu negócio, porque é o dado específico que você guarda em cada contato (porte, produto de interesse, estágio, origem) que alimenta a segmentação precisa, a automação certeira e a personalização real dos e-mails. Sem eles, você fica preso a envios genéricos; com eles, cada mensagem pode conversar com o dado que importa para aquele contato.

Antes de sair criando campos, vale entender o ciclo completo: um campo customizado nasce de uma necessidade de dado, é preenchido por alguma entrada e só entrega valor quando volta a ser usado em filtros, automações e tokens. O caminho é este:

O que são campos customizados no Mautic

O Mautic já traz um conjunto de campos padrão para os contatos: nome, sobrenome, e-mail, telefone, empresa, cargo, cidade, estado, país, entre outros. Cada negócio, porém, tem dados que esses campos não cobrem — e é aí que entram os campos customizados. Você cria o campo que a sua estratégia exige: "Porte da Empresa", "Produto de Interesse", "Data da Última Compra", "Origem do Lead", "Número do Pedido" e por aí vai.

Uma observação técnica que vale conhecer desde já: no Mautic, cada campo customizado de contato vira uma coluna real na tabela de contatos do banco de dados. Isso tem uma consequência prática direta — campos são baratos de usar, mas não de acumular. Crie os que serão de fato filtrados, preenchidos ou personalizados; campos criados "por precaução" só engordam a tabela sem entregar retorno.

Onde criar campos customizados no Mautic

Acesse o painel administrativo pelo ícone de engrenagem (⚙), no canto superior direito, e clique em Custom Fields no menu lateral. A tela lista todos os campos existentes, inclusive os padrão. Para criar um novo, clique em New e preencha a tela de configuração.

Configurando um novo campo customizado

Cada opção da tela de criação define um comportamento do campo. Vale entender o que cada uma faz antes de salvar.

Label e Alias

O Label é o nome amigável, o que aparece na interface (ex.: "Porte da Empresa"). O Alias é o identificador interno, gerado automaticamente a partir do label (ex.: porte_da_empresa). O alias é o que você usa em tokens e integrações — por isso, evite alterá-lo depois de criado: mudar o alias quebra os tokens de e-mail e as integrações que já apontam para ele.

Object

Define a qual entidade o campo pertence: Contact (o contato/indivíduo) ou Company (a empresa). Um campo de Contact guarda um dado da pessoa; um de Company, um dado da organização. Escolha conforme a natureza do dado, porque o objeto não muda depois da criação.

Data Type (Tipo de dado)

O tipo determina como o dado é armazenado e como o campo se comporta em formulários e relatórios. O Mautic oferece um leque amplo de tipos; a tabela abaixo reúne os mais usados no dia a dia.

Além desses, o Mautic ainda traz tipos como Datetime, Time, Country, Region, Timezone e Locale para casos mais específicos. Escolha sempre o tipo que reflete o dado real: um Select bem definido, por exemplo, mantém a base padronizada e evita que o mesmo dado entre escrito de dez formas diferentes.

Group

O campo Group organiza onde o campo aparece na ficha do contato. O Mautic separa os campos em grupos como Core, Social, Personal e Professional — escolha o grupo que faz sentido para o dado, de modo que o perfil do contato fique legível e os campos relacionados apareçam juntos.

Default Value

Valor assumido pelo campo quando nenhum dado é informado. Útil em campos Boolean (ex.: "Aceita newsletter" começa como "Não") ou em Selects com uma opção mais comum.

Required e visibilidade

Se marcado como Required, o campo se torna obrigatório em todo formulário onde for adicionado — use com parcimônia, porque cada campo obrigatório aumenta o atrito no preenchimento. Já a opção Publicly Updatable define se o campo pode ser atualizado por ações públicas, como o envio de um formulário ou o rastreamento. Campos com dado sensível (uma pontuação interna, uma classificação de lead) devem ficar com essa opção desativada, para que não possam ser sobrescritos de fora.

Como usar campos customizados em formulários

Depois de criado, o campo fica disponível na montagem de formulários (Components → Forms). Ao adicionar um campo ao formulário, mapeie-o para o campo customizado na opção de campo de contato (Contact Field) do próprio elemento — assim, o valor digitado pelo lead é gravado diretamente no campo customizado do contato. É o caminho mais comum para alimentar um campo customizado a partir do site. Para o passo a passo de formulários, veja criação de formulários e páginas de destino no Mautic.

Usando campos customizados em segmentos

Todo campo customizado aparece como filtro na criação de segmentos (Contacts → Segments → Filters). É isso que permite uma segmentação realmente fina — por exemplo: "Porte da Empresa = Grande E Produto de Interesse = CRM E pontuação acima de 50". Como os segmentos dinâmicos se recalculam pelo cron de segmentos, o contato entra e sai do grupo conforme o valor do campo muda. A estratégia de agrupamento rende um artigo à parte em gerenciamento de contatos e listas no Mautic.

Tokens de personalização em e-mails

Qualquer campo customizado pode ser inserido nos e-mails do Mautic como token, na sintaxe {contactfield=alias}. Se o alias for porte_empresa, o token é {contactfield=porte_empresa}. Para não deixar um espaço vazio quando o campo não estiver preenchido, use a variação com valor padrão: {contactfield=porte_empresa|sua empresa}. É esse mecanismo que faz um disparo em massa soar como uma mensagem escrita para uma pessoa só.

Perguntas frequentes sobre campos customizados no Mautic

Para que servem os campos customizados no Mautic?

Servem para armazenar informações específicas do seu negócio que os campos padrão do Mautic (nome, e-mail, telefone, empresa, cargo) não cobrem — porte da empresa, produto de interesse, data da última compra, origem do lead. Depois de criados, esses campos ficam disponíveis em toda a plataforma: podem ser preenchidos por formulários, filtrados em segmentos, atualizados por campanhas e inseridos em e-mails como tokens de personalização.

Qual a diferença entre um campo de Contato (Contact) e um de Empresa (Company)?

No momento de criar o campo você escolhe o objeto ao qual ele pertence. Um campo de Contact guarda um dado do indivíduo (cargo, aniversário, produto de interesse); um campo de Company guarda um dado da organização (faturamento, segmento de atuação, número de filiais) e fica disponível quando o formulário ou o registro coleta dados de empresa. Escolha o objeto conforme a natureza do dado — ele não muda depois.

Posso importar dados para campos customizados via CSV?

Sim. Em Contacts → Import você envia o CSV e mapeia cada coluna do arquivo para um campo do Mautic, inclusive os campos customizados que você criou. Basta associar o cabeçalho da coluna ao campo correspondente durante o processo de importação. O Mautic casa o registro pelo campo de identificação único (o e-mail, por padrão) e atualiza o contato existente em vez de duplicar.

Como atualizar um campo customizado automaticamente por campanha?

Use a ação Update contact dentro de uma campanha. Quando o contato realiza uma ação prevista no fluxo — clica num link, envia um formulário, atinge uma pontuação —, o Mautic grava o novo valor no campo customizado sem intervenção manual. É assim que se mantém atualizado um dado como estágio do funil, produto de interesse ou origem do lead.

Como uso um campo customizado num e-mail?

Qualquer campo customizado vira token de personalização no formato {contactfield=alias}, onde "alias" é o identificador interno do campo. Se o alias for porte_empresa, o token é {contactfield=porte_empresa}. Os tokens funcionam no assunto e no corpo do e-mail; use a variação {contactfield=alias|valor} para exibir um texto padrão quando o campo estiver vazio.

Conclusão

Os campos customizados estão entre os recursos mais poderosos do Mautic: são eles que moldam a plataforma às necessidades reais do seu negócio, permitindo armazenar, filtrar, automatizar e personalizar com base em qualquer dado que importe para a sua estratégia de automação de marketing. E, como todo o Mautic, isso vem sem custo de licença — a plataforma é open source e gratuita.

Antes de criar em série, planeje: cada campo deve ter um uso claro em segmentação, formulário, campanha ou personalização. Qualidade e relevância dos dados valem mais do que quantidade de campos. Para conectar esse recurso ao dia a dia da ferramenta, veja como usar o Mautic; e, para a referência oficial de cada opção, a documentação de campos customizados do Mautic é a fonte definitiva.