Ir para o conteúdo
Promovaweb

Contatos e segmentos no Mautic

Montar a lista de cada envio cruzando planilhas toma tempo e deixa contatos de fora. No Mautic, cada contato é uma ficha com os campos que você criar. O segmento dinâmico guarda os filtros, como a cidade ou o cargo informado no cadastro, e o cron recalcula a lista a cada execução.

Ficha e sumário da página

Referência técnica
Mautic 7.2.2
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Visitante anônimo e contato identificado
  2. Campos padrão e campos personalizados
  3. Segmentos dinâmicos e estáticos
  4. Segmento público e central de preferências
  5. Onde os segmentos trabalham

Visitante anônimo e contato identificado

O Mautic separa os contatos em dois grupos. O visitante anônimo é o registro de um visitante rastreado que ainda não foi identificado. Ele pode ter enviado um formulário sem preencher um identificador, como o e-mail. O Mautic guarda o endereço IP, as páginas abertas e a pontuação acumulada. Com um serviço de consulta por IP configurado, também mostra uma localização aproximada. O padrão é o GeoLite2 City da MaxMind, cuja estimativa pode apontar uma cidade diferente da localização do visitante.

Esses registros ficam escondidos na listagem padrão, para não encher a tela de linhas sem nome. A consequência prática vai além da tela: o visitante anônimo não entra em segmentos nem em relatórios. Acessos de robôs, de ferramentas de monitoramento e de navegadores com a opção de privacidade ligada nem chegam a virar registro, porque o Mautic filtra esse tráfego na chegada.

O contato identificado é o registro de um visitante que já se identificou, por um formulário ou por outra origem, como a importação de um CSV ou a sincronização com um CRM. A documentação descreve o caminho comum: o contato começa como visitante e, em algum momento, informa nome, e-mail ou um perfil de rede social. A partir daí o registro carrega o histórico das visitas anteriores e entra nos filtros dos segmentos.

Campos padrão e campos personalizados

Cada contato é uma ficha com campos. Alguns vêm da instalação, como e-mail, nome, sobrenome e cidade. Outros você cria na tela de campos personalizados, aberta pela engrenagem do canto superior direito, escolhendo o tipo do valor e o grupo que define onde o campo aparece na ficha do contato. A mesma tela cria campos para as empresas.

A listagem marca cada campo com ícones que dizem o que o campo permite. O cadeado indica um campo usado pela instalação, que não pode ser removido. A lista indica que o campo serve de filtro em segmentos. O asterisco marca preenchimento obrigatório no formulário de contato. O globo indica que o campo aceita atualização pública pela URL do pixel de rastreamento, o recurso que deixa o seu site gravar um valor na ficha do visitante.

Desde o Mautic 5, os campos que identificam um contato ou uma empresa, como e-mail, nome e os campos marcados como identificador único, não aceitam edição do valor padrão. A criação e a remoção de colunas podem acontecer em segundo plano quando create_custom_field_in_background está ligado. Nesse modo, os comandos mautic:custom-field:create-column e mautic:custom-field:delete-column aplicam ao banco as alterações feitas no painel. O campo novo fica indisponível até a criação da coluna.

Segmentos dinâmicos e estáticos

O segmento é uma lista de contatos usada para enviar e-mails, iniciar campanhas ou analisar um grupo. O segmento dinâmico tem filtros, combinados com os operadores And e Or. Um Or abre um grupo novo de filtros, que pode ter os próprios And. Com os filtros prontos, o Mautic coloca e tira contatos do segmento conforme cada ficha atende ou deixa de atender às condições.

Essa atualização não acontece no momento da edição da ficha. A documentação registra que os segmentos são reconstruídos na frequência do cron, pelo comando mautic:segments:update, que processa 300 contatos por lote no padrão. O mesmo ciclo alimenta as campanhas, que recebem os contatos novos pelo comando seguinte:

  1. Ficha do contato

    city = Curitiba

    O valor gravado pelo formulário, pela API ou pela importação.

  2. Filtro do segmento

    City equals Curitiba

    A condição gravada no segmento dinâmico.

  3. Reconstrução

    mautic:segments:update

    O cron confere as fichas em lotes de 300 e atualiza a lista.

  4. Campanha

    mautic:campaigns:update

    Os contatos novos do segmento entram na campanha.

O caminho de um contato até a campanha, com um filtro de exemplo: o filtro do segmento dinâmico, o comando de cron que reconstrói a lista e o comando que coloca os contatos novos nas campanhas que usam o segmento como fonte.

O segmento estático não tem filtro. O contato entra por edição em lote, pela ficha individual, por uma ação de campanha, por uma ação de envio de formulário, por um gatilho de pontos ou por upload de CSV. O segmento dinâmico também aceita contatos adicionados à mão. Esses contatos continuam na lista mesmo quando a ficha deixa de atender aos filtros.

Segmento público e central de preferências

Você controla a exibição do segmento na central de preferências pela opção Available in Preference Center. Essa é a página que o contato abre para escolher o que quer receber. A central também precisa ter o bloco de lista de segmentos. O campo de nome público permite mostrar um nome diferente do usado no painel, como Novidades do produto. A visibilidade para outros usuários do Mautic tem uma opção própria, Visible to other Users.

A documentação do construtor descreve como públicos os segmentos disponíveis como fonte de contatos. A documentação de segmentos usa essa mesma exigência para a ação de campanha que adiciona contatos a uma lista existente. A exibição na central de preferências tem controle próprio. Um segmento inativo some dos filtros de outros segmentos e da lista de fontes das campanhas.

Onde os segmentos trabalham

O segmento é a ponte entre o cadastro e o envio. O e-mail de segmento vai uma vez para cada contato da lista. A campanha usa o segmento como porta de entrada e o modifica pela ação de mudar os segmentos do contato. O formulário do seu site faz o mesmo no envio, com a ação de mesmo nome.

Com o n8n na outra ponta, o Node Mautic adiciona e remove contatos de segmentos pela API. Um cadastro aprovado no checkout entra no segmento de clientes na mesma execução do workflow, sem esperar o cron. O próximo assunto é o fluxo que transforma essas listas em sequência de mensagens, na página Campanhas.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.