Perguntas frequentes
Quais versões de PHP e de banco o Mautic 7 aceita?
A tabela oficial do Mautic 7 lista PHP 8.2, 8.3, 8.4 e 8.5. As versões mínimas do banco são MySQL 8.4 com InnoDB ou MariaDB 10.11.0. A página de requisitos relaciona 18 extensões do PHP e recomenda VPS ou servidor dedicado para executar a aplicação e seus comandos agendados. Fonte oficial.
Por que o Mautic precisa de cron?
Três tarefas do Mautic rodam fora do navegador: mautic:segments:update recalcula os segmentos, mautic:campaigns:update coloca os contatos novos nas campanhas e mautic:campaigns:trigger executa os eventos programados. Sem esses comandos no cron, o segmento não ganha contatos novos e a campanha não avança. A documentação recomenda espaçar os três para não rodarem no mesmo minuto. Fonte oficial.
Como o Mautic envia e-mails em fila?
Com a fila ligada, o Mautic grava cada mensagem num transporte de fila e um worker envia depois, pelo comando messenger:consume email. Se você iniciar esse processo pelo cron, a documentação orienta usar --memory-limit, --limit ou --time-limit para encerrá-lo após um teto de memória, de mensagens ou de tempo. Um supervisor pode manter o worker em execução contínua. Fonte oficial.
Qual é a diferença entre segmento dinâmico e segmento estático?
O segmento dinâmico tem filtros que o Mautic aplica na execução do cron para incluir e remover contatos. O estático não tem filtro: o contato entra por importação de CSV, por edição manual, por uma ação de campanha ou de formulário. Um contato adicionado à mão num segmento dinâmico continua nele mesmo quando deixa de atender aos filtros. Fonte oficial.
O que é um visitante anônimo no Mautic?
É o registro de um visitante rastreado que ainda não foi identificado, mesmo que tenha enviado um formulário sem identificador. O Mautic guarda o IP e as páginas vistas. Com a consulta por IP configurada, também mostra uma localização aproximada. O padrão é o GeoLite2 City da MaxMind. Esse registro fica fora dos segmentos e relatórios até a identificação. Fonte oficial.
Qual é a diferença entre o evento de espera e a condição numa campanha?
O evento de espera, chamado de Decision na interface, acompanha uma interação, como a abertura registrada de um e-mail. O caminho verde segue com essa interação. O vermelho segue após o prazo configurado na ação seguinte se a interação não foi registrada. A condição compara uma informação existente quando é executada. Ela pode ter atraso, mas não espera que o resultado da comparação mude. Fonte oficial.
Qual é a diferença entre e-mail de modelo e e-mail de segmento?
O e-mail de modelo é transacional por padrão e sai pelas campanhas, pelas ações de formulário e pelos gatilhos de pontos, inclusive mais de uma vez para o mesmo contato. O e-mail de segmento é de marketing por padrão e funciona como lista de envio: cada contato do segmento recebe uma vez, pelo comando mautic:broadcasts:send no cron. Fonte oficial.
Como o Mautic recebe os bounces dos e-mails?
Por dois caminhos. O primeiro é o webhook do provedor de envio, num endereço único para todos os transportes desde o Mautic 5, terminado em /mailer/callback. A documentação lista Amazon SES, SendGrid, Mailjet, SparkPost, Mandrill e Elastic Email. O segundo é a caixa monitorada por IMAP, lida pelo comando mautic:email:fetch. Fonte oficial.
Como colocar um formulário do Mautic no meu site?
A documentação recomenda o embed por JavaScript, que acompanha as mudanças feitas no formulário dentro do Mautic. O iframe é a alternativa quando o script não serve. A cópia do HTML no próprio site funciona, mas não recebe as alterações posteriores e desliga o perfil progressivo. Nas landing pages do Mautic, o token {form=ID} coloca o formulário na página. Fonte oficial.
Como o n8n se autentica na API do Mautic?
Você pode usar Basic Auth ou OAuth2 na credencial do Node Mautic, com a API habilitada na instância. O Basic Auth usa o nome de acesso e a senha do usuário. O OAuth2 usa o Client ID e o Client Secret de uma credencial criada no Mautic, com a URL de callback do n8n registrada como Redirect URI. Fonte oficial.
Como conferir se um webhook veio mesmo do Mautic?
Cada webhook tem uma chave secreta. O Mautic envia o cabeçalho Webhook-Signature com o HMAC-SHA256 do corpo bruto da requisição, codificado em base64. O workflow que recebe calcula a mesma assinatura com a chave e descarta a requisição quando as duas não batem. Fonte oficial.