Este guia prático mostra como instalar o Mautic passo a passo, cobrindo requisitos, preparação do servidor, instalação via Composer ou pacote, configuração pós-instalação, agendamento de tarefas e resolução de problemas. Destinado a administradores e profissionais de marketing técnico, o artigo explica comandos, parâmetros de configuração, boas práticas de segurança e manutenção para garantir uma instalação estável e segura do Mautic.
Visão geral do Mautic e requisitos
O Mautic é uma plataforma de automação de marketing open source que permite que empresas e organizações gerenciem suas campanhas de marketing digital de maneira eficaz e estratégica. Através de suas funcionalidades, como gerenciamento de leads, segmentação de contatos, automação de e-mails e análise de métricas, o Mautic facilita a personalização da comunicação com o público-alvo, aumentando a efetividade das campanhas e otimizando os recursos investidos em marketing. O papel do Mautic é essencial para organizar equipes de marketing e engenheiros técnicos que buscam uma ferramenta acessível e flexível que possa integrar-se a diversos sistemas existentes.
Uma das principais razões pelas quais técnicos e equipes de marketing escolhem o Mautic é sua natureza open source, que permite total liberdade para adaptar e personalizar a plataforma de acordo com as necessidades específicas de cada organização. Além disso, a comunidade ativa que desenvolve e atualiza o Mautic constantemente oferece um suporte valioso e uma vasta gama de integrações com outras ferramentas populares no mercado. Isso possibilita que as empresas não apenas implementem suas estratégias de marketing, mas também mantenham-se competitivas em um ambiente digital em constante evolução.
Para garantir uma instalação bem-sucedida e o funcionamento suave do Mautic, é fundamental atender a certos requisitos. Aqui está um checklist detalhado dos requisitos necessários para instalar o Mautic em produção:
- Versões recomendadas de PHP: 7.2 ou superior. O Mautic exige funcionalidades específicas que são suportadas apenas em versões recentes do PHP. Utilizar uma versão atualizada também garante melhores desempenho e segurança.
- Extensões PHP obrigatórias:
- openssl
- curl
- mbstring
- xml
- json
- gd
- intl
- xmlwriter
- zip
- pdo_mysql (ou pdo_pgsql para PostgreSQL)
Cada uma dessas extensões fornece funcionalidades necessárias para o Mautic realizar suas operações, como envio de e-mails, manipulação de dados e geração de relatórios.
- Bancos de dados suportados: MySQL, MariaDB e PostgreSQL. O desempenho e a compatibilidade do Mautic são otimizados para funcionar com esses sistemas de gerenciamento de banco de dados, permitindo uma integração mais fluida com a plataforma.
- Servidor web recomendado: Apache ou Nginx. Ambos os servidores são amplamente utilizados e bem suportados pelo Mautic, oferecendo as funcionalidades necessárias para o correto funcionamento da aplicação, como reescrita de URLs e gestão de múltiplos hosts virtuais.
- Dependências opcionais:
- Composer: um gerenciador de pacotes para PHP que facilita a instalação e atualização de bibliotecas necessárias ao Mautic.
- Redis: um sistema de armazenamento em cache que pode melhorar a performance do Mautic ao reduzir a carga no banco de dados.
- Elasticsearch: uma poderosa ferramenta de busca e análise que pode ser integrada ao Mautic para melhorar a pesquisa de dados e relatórios.
Embora não sejam obrigatórias, essas ferramentas podem melhorar significativamente o desempenho e a funcionalidade do Mautic.
Atender a esses requisitos garante não apenas a instalação correta do Mautic, mas também assegura que a plataforma operará com segurança, eficácia e desempenho otimizados. É crucial que cada um dos componentes seja configurado corretamente, pois qualquer omissão ou erro na configuração pode levar a problemas de desempenho ou até mesmo à falha completa da plataforma.
Nos próximos capítulos, abordaremos a preparação do servidor para a instalação do Mautic, aprofundando-nos nos passos necessários para garantir que sua infraestrutura esteja pronta para receber a aplicação. Será discutido desde a escolha do sistema operacional até a instalação das versões corretas de PHP, bem como a configuração do banco de dados e ajustes de permissões necessárias. Uma preparação adequada do servidor formará a base para garantir que a instalação do Mautic seja bem-sucedida e que a configuração inicial leve a uma instância estável e segura.
Preparando o servidor para instalação
Preparar o servidor para a instalação do Mautic é uma etapa crucial para garantir que a aplicação funcione de maneira estável e segura. Nesta fase, você vai definir o ambiente onde o Mautic será instalado, garantindo que todos os requisitos necessários estejam atendidos. A seleção correta do sistema operacional, a instalação das versões apropriadas do PHP e suas extensões, assim como a configuração do banco de dados e do servidor web são passos fundamentais. Seguem as orientações detalhadas para preparar seu servidor.
Escolha do Sistema Operacional
Para um ambiente de instalação do Mautic, recomenda-se utilizar distribuições Linux populares como Ubuntu LTS ou CentOS. Ambas são estáveis, amplamente suportadas e possuem uma vasta documentação.
- Ubuntu LTS: É uma escolha popular por sua simplicidade e a comunidade ativa. A versão mais recente é recomendada.
- CentOS: Famoso por sua robustez, é uma boa alternativa em ambientes empresariais.
Instalação das Versões Corretas de PHP e Extensões
O Mautic requer PHP na versão 7.3 ou superior, então, após escolher o sistema operacional, você deve instalar o PHP e suas extensões necessárias. Uma lista básica das extensões que você deve instalar inclui:
- php
- php-mysql ou php-pgsql (dependendo do banco de dados escolhido)
- php-gd
- php-curl
- php-mbstring
- php-xml
Os comandos para instalação variam de acordo com o sistema operacional. Por exemplo, no Ubuntu, você executaria:
apt update
apt install php php-mysql php-gd php-curl php-mbstring php-xml
No CentOS, use:
yum install php php-mysql php-gd php-curl php-mbstring php-xml
Configuração do Banco de Dados
O Mautic suporta diversos bancos de dados, como MySQL, MariaDB e PostgreSQL. Neste exemplo, vamos utilizar o MySQL. Siga estas etapas para criar um banco de dados e um usuário com privilégios mínimos:
1. Acesse o console do MySQL:
mysql -u root -p
2. Crie um banco de dados:
CREATE DATABASE nome_do_banco;
3. Crie um usuário para o Mautic:
CREATE USER ‘nome_usuario’@’localhost’ IDENTIFIED BY ‘senha_forte’;
4. Conceda privilégios ao usuário criado:
GRANT ALL PRIVILEGES ON nome_do_banco.* TO ‘nome_usuario’@’localhost’;
5. Atualize os privilégios:
FLUSH PRIVILEGES;
6. Saia do console:
EXIT;
Certifique-se de usar uma senha forte para o usuário do banco de dados e não conceda mais privilégios do que os necessários.
Ajustes de Permissões de Diretórios
Após a configuração do banco de dados, você precisa ajustar as permissões dos diretórios em que o Mautic será instalado. A seguir, as permissões recomendadas:
- public/: Este diretório deve ser acessível ao servidor web. Por isso, é importante garantir que ele tenha permissões adequadas.
- cache/, logs/: Estes diretórios requerem permissões de escrita pelo servidor, que permite que o Mautic armazene temporariamente as informações e grave logs de atividades.
Exemplo de comandos no terminal para ajustar as permissões:
chown -R www-data:www-data /caminho/pasta_do_mautic/public
chmod -R 755 /caminho/pasta_do_mautic/public
chown -R www-data:www-data /caminho/pasta_do_mautic/cache
chmod -R 775 /caminho/pasta_do_mautic/cache
chown -R www-data:www-data /caminho/pasta_do_mautic/logs
chmod -R 775 /caminho/pasta_do_mautic/logs
Criação de VHost para Apache ou Bloco de Servidor para Nginx
A configuração do servidor web é outro aspecto essencial. Dependendo de sua escolha entre Apache ou Nginx, as configurações variam.
- Para Apache:
– Crie um novo arquivo de configuração VHost em /etc/apache2/sites-available/nome_do_dominio.conf com o seguinte conteúdo:
ServerName nome_do_dominio
DocumentRoot /caminho/pasta_do_mautic/publicAllowOverride All
Require all grantedErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
– Habilite o site e o módulo de reescrita:
a2ensite nome_do_dominio.conf
a2enmod rewrite - Para Nginx:
– Crie um bloco de servidor no /etc/nginx/conf.d/nome_do_dominio.conf com conteúdo semelhante a:
server {
listen 80;
server_name nome_do_dominio;root /caminho/pasta_do_mautic/public;
index index.php index.html index.htm;location / {
try_files $uri $uri/ /index.php?$query_string;
}location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
}
}
– Reinicie o Nginx:
systemctl restart nginx
Segurança Inicial
Para aumentar a segurança do seu servidor, algumas medidas devem ser implementadas:
1. Configure um firewall básico para proteger as portas abertas. Para o UFW, que é comum em Ubuntu:
ufw allow ‘Apache Full’
ufw allow OpenSSH
ufw enable
2. Crie um usuário não-root para a administração do sistema:
adduser nome_usuario
usermod -aG sudo nome_usuario
3. Prepare o servidor para TLS utilizando o Certbot para facilitar a implementação de certificados SSL:
apt install certbot python3-certbot-apache
Agora que seu servidor está preparado com todas as configurações necessárias, você está pronto para seguir para a instalação do Mautic. Lembre-se de que cada etapa é vital para o funcionamento eficaz da aplicação, e pequenos descuidos podem causar problemas futuros. Na próxima seção, você aprenderá a instalar o Mautic em seu servidor já preparado.
Instalação passo a passo do Mautic
Instalação passo a passo do Mautic
Instalar o Mautic pode ser feito de duas maneiras principais: via Composer ou utilizando pacotes/ZIP. Ambas as abordagens têm suas vantagens e podem ser escolhidas conforme a preferência do usuário ou as necessidades do projeto. Aqui estão os passos necessários para cada método de instalação, detalhando desde a configuração de permissões até a verificação final para assegurar que a instalação foi bem sucedida.
Instalação via Composer
Passo 1: Acesso ao seu servidor
- Conecte-se ao servidor via SSH utilizando um terminal.
- Use um comando similar a este para conectar: ssh usuario@seu_servidor.
Passo 2: Navegação até o diretório desejado
- Entre no diretório onde deseja instalar o Mautic.
- Para mudar de diretório: cd /caminho/para/diretório.
Passo 3: Instalação do Composer (se ainda não estiver instalado)
- Baixe e instale o Composer com o seguinte comando: curl -sS https://getcomposer.org/installer | php.
- Mova o Composer para um local acessível: mv composer.phar /usr/local/bin/composer.
Passo 4: Criando o projeto Mautic
- Execute o comando para criar o projeto: composer create-project mautic/recommended-project mautic.
- Esse processo pode levar alguns minutos. Aguarde até que a instalação esteja completa.
Passo 5: Configurando permissões
- chown -R www-data:www-data /caminho/para/diretório/mautic (ajuste a propriedade do diretório).
- chmod -R 755 /caminho/para/diretório/mautic (permite que o servidor web tenha acesso ao aplicativo).
- chmod -R 775 /caminho/para/diretório/mautic/app/cache (permite acesso de gravação ao cache).
- chmod -R 775 /caminho/para/diretório/mautic/app/logs (permite acesso de gravação aos logs).
Passo 6: Configuração inicial do arquivo .env
- Navegue até o diretório onde o Mautic foi instalado: cd /caminho/para/diretório/mautic.
- Edite o arquivo .env: nano .env.
- Altere a variável MAUTIC_URL para a URL base que você configurou (ex.: http://seusite.com/mautic).
- Defina o APP_ENV para prod (produção) e ajuste o MAUTIC_DEBUG para false após a instalação inicial.
Passo 7: Executando as migrations e comandos de instalação
- Execute o comando para garantir que a instalação está correta: php bin/console mautic:install.
- Siga as instruções na tela para completar a instalação inicial.
Passo 8: Verificando requisitos no navegador
- Acesse a URL do Mautic em seu navegador: http://seusite.com/mautic.
- Verifique se a página de login aparece corretamente, o que indica uma instalação bem-sucedida.
Instalação por pacote/ZIP
Passo 1: Acesso ao servidor
- Conecte-se ao servidor da mesma forma que na instalação via Composer.
Passo 2: Navegação até o diretório desejado
- Entre no diretório onde deseja instalar o Mautic.
Passo 3: Download do Mautic
- Baixe o pacote do Mautic diretamente do site oficial: wget https://www.mautic.org/download/latest.
- Extraia o pacote com: unzip latest.zip.
- Remova o arquivo ZIP após a extração: rm latest.zip.
Passo 4: Configurando permissões
- chown -R www-data:www-data /caminho/para/diretório/mautic.
- chmod -R 755 /caminho/para/diretório/mautic.
- chmod -R 775 /caminho/para/diretório/mautic/app/cache.
- chmod -R 775 /caminho/para/diretório/mautic/app/logs.
Passo 5: Configuração inicial do arquivo config/local.php
- Crie e edite o arquivo: nano app/config/local.php.
- Defina a URL base corretamente e as configurações do banco de dados como indicado: ‘base_url’ => ‘http://seusite.com/mautic’.
- Insira os detalhes do banco de dados, como nome, usuário e senha.
Passo 6: Executando migrations e instalação
- Execute: php bin/console mautic:install.
- Siga as instruções apresentadas.
Passo 7: Verificação no navegador
- Acesse a URL do Mautic para confirmar a instalação: http://seusite.com/mautic.
- Observe a tela de login, que confirmará que a instalação foi correta.
Solução de erros comuns
- Se aparecer a mensagem de “Requisitos não atendidos”, verifique as versões do PHP e das extensões necessárias.
- Caso o acesso ao Mautic não funcione, revise as configurações de permissões e a configuração do servidor web.
Testando a instalação
Para confirmar que sua instalação foi bem sucedida, acesse as seguintes páginas e verifique as mensagens esperadas:
- Página de login do Mautic: deve exibir campos para nome de usuário e senha.
- Página de configuração inicial (se ainda não logado): deve guiar para as etapas de configuração básica.
O Mautic está agora instalado e funcionando corretamente no seu servidor. A partir daqui, você pode prosseguir com a configuração pós-instalação e as integrações essenciais para otimizar seu uso da plataforma.
Configuração pós instalação e integrações essenciais
Depois de realizar a instalação do Mautic, há várias etapas cruciais que devem ser concluídas para garantir que sua instância esteja otimizável, segura e funcionando de maneira eficaz. Este capítulo aborda a configuração pós-instalação, abrangendo configurações de e-mail e cron jobs, ativação de HTTPS, adequações de segurança, instalação de plugins e integrações necessárias.
Configuração de E-mail
A capacidade de enviar e-mails é uma das funcionalidades mais importantes do Mautic. É essencial configurar um servidor SMTP para que as comunicações sejam feitas de maneira eficaz. Você pode usar provedores comuns de e-mail, como Gmail, SendGrid ou Amazon SES. O procedimento para a configuração varia um pouco dependendo do provedor, mas as seguintes diretrizes podem ser aplicadas:
- Vá até Configurações > E-mail > Configuração de e-mail.
- Selecione “SMTP” como o tipo de e-mail.
- Insira as informações solicitadas, como host, porta, usuário e senha:
- Host: smtp.seuprovedor.com
- Porta: 587 (para TLS) ou 465 (para SSL)
- Usuário: [email protected]
- Senha: sua-senha
- Ative a autenticação conforme necessário.
- Escolha o tipo de segurança (TLS ou SSL) de acordo com seu provedor.
Dicas de Autenticação
Certifique-se de que a autenticação 2FA (dois fatores) está desativada para a conta de e-mail utilizada, ou esteja preparado para usar tokens de autenticação. Depois de tudo configurado, faça um teste de envio de e-mail:
- Vá até “Teste de E-mail”.
- Envie um e-mail de teste para um endereço válido e verifique sua caixa de entrada.
Medidas Anti-Spam Básicas
Para diminuir as chances de que seus e-mails sejam marcados como spam, siga estas práticas recomendadas:
- Implemente o SPF (Sender Policy Framework) no DNS do domínio.
- Configure o DKIM (DomainKeys Identified Mail) para assinar seus e-mails.
- Utilize a autenticação do DMARC.
- Evite palavras frequentemente associadas a spam e mantenha sua lista de contatos limpa.
Configuração de Cron Jobs
O Mautic requer a configuração de cron jobs para garantir que tarefas automáticas, como o envio de e-mails e o rastreamento de leads, sejam executadas corretamente. As seguintes entradas devem ser adicionadas ao crontab:
* * * * * php /caminho/para/seu/mautic/bin/console mautic:leadlists:update * * * * * php /caminho/para/seu/mautic/bin/console mautic:emails:send * * * * * php /caminho/para/seu/mautic/bin/console mautic:campaigns:reap 0 * * * * php /caminho/para/seu/mautic/bin/console mautic:campaigns:trigger
Frequência e Propósito de Cada Linha
- * * * * * – Atualiza listas de leads a cada minuto.
- * * * * * – Envia e-mails em tempo real a cada minuto.
- * * * * * – Executa a limpeza de campanhas a cada minuto.
- 0 * * * * – Aciona campanhas uma vez por hora.
Esses cron jobs são essenciais para o funcionamento contínuo do Mautic e sua eficácia em gerenciar campanhas.
Ativação de HTTPS e Ajustes de Segurança
A ativação de HTTPS é crítica para garantir a segurança dos dados e a privacidade dos usuários. Para configurar, recomenda-se usar um certificado SSL de um provedor reconhecido ou um serviço gratuito como o Let’s Encrypt.
- Instale o certificado SSL em seu servidor.
- Configure o servidor web (Apache ou Nginx) para redirecionar todo o tráfego HTTP para HTTPS.
Ajustes de Segurança Adicionais
- Desativar listas de diretórios.
- Configurar firewall e outras proteções no servidor.
- Manter o Mautic atualizado; problemas de segurança frequentemente estão relacionados a versões desatualizadas.
Instalação e Configuração de Plugins e Integrações
Após a configuração básica do Mautic, é hora de maximizar suas funcionalidades através de plugins e integrações:
1. Integração com CRM:
Conecte o Mautic ao seu CRM, como Salesforce ou HubSpot, para melhor gerenciamento de leads. Aqui está como fazer:
- Acesse o menu de plugins do Mautic.
- Selecione o plugin disponível para seu CRM e siga as instruções de instalação.
2. Rastreio de Site e Pixel:
Configure o rastreamento de site e pixels para medir a eficácia de suas campanhas.
- Vá na seção de rastreamento do Mautic.
- Copie o código de rastreamento e cole em todas as páginas que deseja monitorar.
Verificações Pós-Integração
Após cada integração, é fundamental realizar testes para garantir que tudo esteja funcionando corretamente. Isso inclui verificar se os contatos estão sendo sincronizados e se as tags estão sendo aplicadas como esperado.
Este capítulo abordou as configurações essenciais e recomendações pós-instalação do Mautic, garantindo que a plataforma esteja preparada para desempenhar seu papel nas suas estratégias de marketing automatizado. A manutenção e monitoramento eficaz serão abordados no próximo capítulo, que dará continuidade a este processo, assegurando que sua instância de Mautic permaneça estável e segura.
Manutenção, escalabilidade e resolução de problemas
Manutenção, Escalabilidade e Resolução de Problemas para Mautic
Políticas de Backup
Para garantir a integridade e disponibilidade dos dados da sua instância do Mautic, é fundamental estabelecer uma política de backup eficaz. Os backups devem englobar tanto os diretórios que armazenam os arquivos do Mautic quanto os bancos de dados que contêm suas informações essenciais.
- Diretórios a serem salvos:
- /var/www/html/mautic
- /var/www/html/mautic/app/config
- /var/www/html/mautic/plugins (se personalizados)
- /var/www/html/mautic/media (se houver uploads)
- Banco de Dados:
- Utilize ferramentas como mysqldump para criar uma cópia de segurança do seu banco de dados Mautic.
- Frequência sugerida:
- Realizar backup diário para ambientes de produção e semanalmente para ambientes de testes.
- Garanta que os backups sejam armazenados em múltiplas localizações, como armazenamento local e nuvem.
Procedimentos de Restauração Testados
Os procedimentos de restauração devem ser testados regularmente para garantir que funcionem quando necessário. Uma abordagem comum inclui:
- Restauração de Banco de Dados:
- Utilize o comando de restauração do banco de dados do seu gerenciador SQL, por exemplo, mysql -u usuario -p database < backup.sql.
- Restauração de Arquivos e Diretórios:
- Extraia os arquivos do backup nos diretórios corretos, sobrescrevendo os existentes.
- Verificação:
- Após a restauração, cheque logs e a integridade das informações na interface do Mautic.
Estratégia de Atualização do Mautic
Para manter sua instância de Mautic atualizada e segura, as atualizações devem ser realizadas com planejamento:
- Planejamento de Updates:
- Escolha horários de baixa demanda, como à noite ou fins de semana, para atualizar o Mautic.
- Notifique os usuários sobre possível downtime antes da atualização.
- Diversas etapas de atualização:
- Realize um backup completo antes de aplicar qualquer atualização.
- Testes em um ambiente de staging antes de aplicar no ambiente de produção são cruciais.
- Utilize a interface do Mautic para aplicar atualizações ou atualize via linha de comando usando Composer.
Monitoramento de Logs e Métricas
O monitoramento contínuo de logs e métricas ajuda a diagnosticar problemas rapidamente. Preste atenção a:
- Arquivos de Log Importantes:
- /var/www/html/mautic/app/logs/mautic.log
- /var/www/html/mautic/app/logs/prod.log
- O que procurar:
- Erros relacionados a falhas na execução de cron jobs.
- Exceções não tratadas que podem indicar problemas de configurações ou plugins.
- Mensagens de falhas nos envios de e-mails.
Otimização de Desempenho
A configuração eficiente de recursos é crucial para um Mautic fluido:
- Uso de Cache:
- Configure um sistema de cache como Memcached ou Redis para acelerar o carregamento de páginas.
- Maximize a utilização de técnicas de cache em seu servidor web (ex: nginx ou Apache).
- Filas:
- Implemente filas para processamento de campanhas, o que melhora a performance em picos de acesso.
- Tuning de Servidor Web:
- Revise a configuração do seu servidor para otimizar o uso de memória e recursos.
- Examine e ajuste o número de processos ou threads permitidos em seu servidor web.
Orientações para Escalar para Múltiplos Servidores
Quando a demanda por sua instância do Mautic aumenta, pode ser necessário escalar vertical ou horizontalmente:
- Escalonamento Horizontal:
- Utilize balanceadores de carga para distribuir o tráfego entre várias instâncias do servidor.
- Sincronize banco de dados e informações através de uma solução centralizada.
- Escalonamento Vertical:
- Aumente a capacidade do servidor existente (memória, CPU) para lidar com mais solicitações.
Troubleshooting: Problemas Comuns
Problemas técnicos podem ocorrer com frequência. Aqui estão algumas soluções para problemas comuns:
- Erros 500:
- Ger geralmente informativo; verifique logs para entender a origem.
- Certifique-se de que as permissões dos arquivos estejam corretas (por exemplo, 755 para diretórios, 644 para arquivos).
- Falhas de Envio de E-mail:
- Revise a configuração de SMTP, certificando-se de que as credenciais estão corretas.
- Considere a implementação de logs de e-mail para monitorar entregas.
- Permissões:
- Verifique se a conta que roda o servidor web tem as permissões necessárias nos diretórios do Mautic.
Checklist de Segurança Operacional
Mantenha sua instância segura com práticas operacionais rigorosas:
- Atualizar regularmente o Mautic e seus plugins.
- Reveja e limite as permissões de acesso ao sistema.
- Implemente autenticação de dois fatores onde for possível.
Recomendações para Testar Mudanças em Ambiente de Staging
Antes de aplicar atualizações e mudanças para o ambiente de produção:
- Clone sua instância de produção para um ambiente de staging.
- Realize testes abrangentes, incluindo mudanças de configuração, instalação de plugins e atualizações.
- Implemente um plano de rollback para a produção caso os testes falhem.
Conclusions
Com a instalação e configuração correta do Mautic, você garante automação de marketing eficiente e segura. Revise requisitos, mantenha cron jobs e TLS ativos, faça backups regulares e atualizações planejadas. Monitore desempenho e integre SMTP e APIs conforme necessário. Seguindo este guia, a sua instância de Mautic ficará pronta para crescer com campanhas confiáveis e operações de longo prazo.
Leave a Reply