Como criar campos customizados no Mautic: enriqueça seus contatos com dados personalizados
Os campos customizados (Custom Fields) do Mautic permitem que você armazene qualquer informação adicional sobre seus contatos — além dos campos padrão como nome, email e telefone. Com eles, você pode criar segmentações precisas, personalizar campanhas e enriquecer seu CRM com dados específicos do seu negócio.
Neste guia completo, você vai aprender como criar campos customizados no Mautic, quais tipos estão disponíveis, como organizá-los em grupos e como usá-los em formulários, campanhas e segmentos.
- Onde criar: Admin (engrenagem) → Custom Fields → New.
- Para que servem: Armazenar dados específicos do seu negócio que os campos padrão não cobrem.
- Tipos disponíveis: Text, select, boolean, date, number, URL, textarea e outros.
- Aplicações: Formulários, segmentos, campanhas, tokens de personalização em emails.
O que são campos customizados no Mautic?
O Mautic vem com um conjunto de campos padrão para contatos: nome, sobrenome, email, telefone, empresa, cargo, cidade, estado, país, entre outros. Mas cada negócio tem necessidades específicas que esses campos não cobrem. É aqui que entram os campos customizados: você pode criar qualquer campo que sua estratégia exija, como “Porte da Empresa”, “Produto de Interesse”, “Data da Última Compra”, “Score de Qualificação”, “Origem do Lead”, “Número do Pedido” e muito mais.
Esses campos ficam disponíveis em toda a plataforma: podem ser preenchidos por formulários, atualizados por campanhas, usados como filtros em segmentos e inseridos em emails como tokens de personalização.
Onde criar campos customizados no Mautic
Acesse o painel administrativo clicando no ícone de engrenagem (⚙) no menu superior direito do Mautic. No menu lateral, clique em Custom Fields. Você verá todos os campos existentes (incluindo os padrão). Para criar um novo, clique em New.
Configurando um novo campo customizado
Na tela de criação, preencha os campos de configuração:
Label e Alias
O Label é o nome amigável do campo (ex.: “Porte da Empresa”). O Alias é o identificador interno, gerado automaticamente a partir do label (ex.: “porte_da_empresa”). O alias é usado em integrações e tokens — evite alterar manualmente depois de criado, pois pode quebrar integrações existentes.
Object
Define a qual entidade o campo pertence: Contact (contato) ou Company (empresa/companhia). Escolha conforme o dado que você quer armazenar.
Data Type (Tipo de dado)
O tipo determina como o dado é armazenado e como aparece nos formulários e relatórios.
| Tipo | Uso | Exemplo |
|---|---|---|
| text | Campo de texto curto | Cargo específico, código de cliente |
| textarea | Texto longo | Observações sobre o contato |
| select | Lista de opções (dropdown) | Porte: Micro, Pequena, Média, Grande |
| multiselect | Múltiplas seleções | Produtos de interesse |
| boolean | Verdadeiro/Falso (checkbox) | Aceita newsletter? Sim/Não |
| date | Data | Data da última compra, data de renovação |
| number | Número | Número de funcionários, valor do contrato |
| url | URL | Site da empresa, LinkedIn do contato |
Group (Grupo)
Campos podem ser organizados em grupos para facilitar a navegação no perfil do contato. O Mautic já vem com grupos padrão como “Core Fields”, “Social”, “Professional”. Você pode criar grupos personalizados (ex.: “Dados de Qualificação”, “Dados de Compra”) para manter o CRM organizado.
Default Value
Valor padrão do campo quando nenhum dado é informado. Útil para campos booleanos (ex.: “Aceita newsletter” começa como “Não”) ou selects com uma opção mais comum.
Required
Se marcado, o campo se torna obrigatório em todos os formulários onde for adicionado. Use com cautela — campos obrigatórios aumentam o atrito no preenchimento de formulários.
A opção “Publicly Updatable” determina se o campo pode ser atualizado por ações externas (como webhooks). Campos com dados sensíveis (score interno, classificação do lead) devem ter essa opção desativada para evitar manipulação externa.
Como usar campos customizados em formulários
Após criar o campo, ele fica disponível na lista de campos ao criar ou editar formulários (Components → Forms). Ao adicionar um campo ao formulário, você pode mapeá-lo para o campo customizado criado em “Mapped Contact Field”. Assim, o valor digitado pelo lead é salvo diretamente no campo customizado do contato no Mautic.
Usando campos customizados em segmentos
Os campos customizados aparecem como filtros na criação de segmentos (Contacts → Segments → Filters). Isso permite criar segmentações altamente precisas como “Todos os contatos com ‘Porte da Empresa’ = ‘Grande’ E ‘Produto de Interesse’ = ‘CRM’ E ‘Score’ maior que 50”.
Tokens de personalização em emails
Qualquer campo customizado pode ser usado como token de personalização nos emails do Mautic, usando a sintaxe: {contactfield=alias_do_campo}. Exemplo: se o alias do campo for “porte_empresa”, o token seria {contactfield=porte_empresa}. Isso permite criar emails altamente personalizados que mencionam o nome, empresa, cargo ou qualquer outro dado do contato.
Perguntas frequentes sobre campos customizados no Mautic
Posso importar dados para campos customizados via CSV?
Sim. Na importação de contatos (Contacts → Import), o Mautic permite mapear colunas do CSV para qualquer campo do contato, incluindo campos customizados. Basta associar o cabeçalho da coluna ao alias do campo customizado durante o processo de importação.
Há limite de campos customizados no Mautic?
Tecnicamente não há limite imposto pelo Mautic, mas há um limite prático de desempenho — muitos campos customizados podem tornar a tabela de contatos do banco de dados pesada. Recomenda-se criar apenas campos que serão efetivamente usados em segmentação, formulários ou campanhas.
Posso excluir um campo customizado depois de criado?
Sim, mas com cautela. Excluir um campo remove todos os dados armazenados nele para todos os contatos. Se o campo estiver sendo usado em formulários, segmentos ou tokens de email, esses usos precisarão ser atualizados manualmente após a exclusão. Prefira desativar o campo (despublicá-lo) em vez de excluí-lo se não tiver certeza.
Como atualizar um campo customizado automaticamente via campanha?
Use a ação “Update Contact” nas campanhas do Mautic. Você pode definir que, quando o contato realizar determinada ação (como clicar em um link ou preencher um formulário), o valor de um campo customizado seja atualizado automaticamente. Isso é útil para atualizar o estágio do funil, o produto de interesse ou qualquer dado de qualificação.
Posso usar campos de Empresa (Company) em formulários?
Sim. Se você criar um campo customizado com Object = “Company”, ele ficará disponível para mapeamento em formulários que coletam dados de empresa. Para que funcione corretamente, o Mautic precisa ter a funcionalidade de Companies habilitada (Admin → Configuration → Contact Settings → Use Companies).
Conclusão
Os campos customizados são um dos recursos mais poderosos do Mautic para personalização e segmentação avançada. Com eles, você transforma o Mautic em um CRM alinhado às necessidades específicas do seu negócio, capaz de armazenar, filtrar e usar qualquer dado relevante para suas estratégias de automação de marketing.
Antes de criar muitos campos, planeje quais dados realmente serão usados em segmentações e campanhas — qualidade e relevância valem mais do que quantidade. Para aprender mais sobre configurações avançadas do Mautic, acesse os conteúdos de Mautic no atraca.com.br ou consulte a documentação oficial de campos customizados.
Comentários