Risolvere i Problemi Comuni di MailPoet: Troubleshooting

MailPoet è un plugin affidabile, ma come ogni software complesso possono verificarsi problemi tecnici che impediscono il corretto funzionamento delle campagne di email marketing. In questa guida analizziamo i problemi più comuni di MailPoet e forniamo soluzioni passo-passo per risolverli in modo autonomo.

Problema 1: Le Email Non Vengono Inviate

Il problema più frequente in assoluto: si crea una campagna, si preme “Invia”, ma le email non partono o restano bloccate in coda. Le cause possono essere molteplici.

Verificare il Sistema Cron di WordPress

MailPoet utilizza il sistema WP-Cron per gestire la coda di invio delle email. Se il cron non funziona correttamente, le email restano in attesa indefinitamente.

Per prima cosa, verificare che WP-Cron non sia disabilitato. Controllare il file wp-config.php alla ricerca della riga:

define('DISABLE_WP_CRON', true);

Se questa costante è impostata su true, il cron nativo di WordPress è disabilitato. Questo è comune su hosting che utilizzano cron di sistema. In tal caso, è necessario assicurarsi che il cron di sistema sia configurato per richiamare periodicamente il file wp-cron.php, tipicamente ogni 1-2 minuti.

Un comando cron corretto potrebbe essere:

*/2 * * * * /usr/bin/php /path/to/wordpress/wp-cron.php

In alternativa, MailPoet offre una opzione nelle proprie impostazioni per gestire il cron internamente, indipendentemente da WP-Cron. Questa opzione si trova in MailPoet > Impostazioni > Avanzate alla voce relativa al metodo di invio cron.

Verificare la Configurazione SMTP

Se si utilizza un server SMTP proprio (non il MailPoet Sending Service), la configurazione errata dei parametri SMTP è una causa frequente di mancato invio.

Controllare i seguenti parametri in MailPoet > Impostazioni > Invio:

• Host SMTP — deve corrispondere esattamente a quello fornito dal provider (ad esempio smtp.gmail.com, smtp.office365.com)
• Porta — tipicamente 587 per STARTTLS o 465 per SSL/TLS
• Metodo di autenticazione — solitamente Login con username e password
• Username — spesso coincide con il proprio indirizzo email completo
• Password — attenzione: per Gmail e altri provider con 2FA, è necessario generare una password specifica per le applicazioni

Dopo aver verificato i parametri, utilizzare il pulsante “Invia email di test” nelle impostazioni di MailPoet per verificare che la configurazione funzioni correttamente.

Limiti di Invio del Provider di Hosting

Molti provider di hosting condiviso impongono limiti al numero di email inviabili per ora o per giorno. Superando questi limiti, le email successive vengono rifiutate dal server.

• Hosting condiviso tipico — limite di 100-500 email per ora
• VPS e server dedicati — limiti generalmente più elevati o assenti
• Hosting WordPress gestito — limiti variabili, consultare la documentazione del provider

La soluzione definitiva è utilizzare il MailPoet Sending Service o un servizio SMTP professionale come Amazon SES, che non sono soggetti ai limiti del hosting.

Problema 2: Le Email Finiscono nello Spam

Le email vengono inviate correttamente ma i destinatari le trovano nella cartella spam. Questo problema compromette la efficacia delle campagne di email marketing e richiede un intervento sistematico.

Configurare la Autenticazione Email

La mancanza di autenticazione email è la causa principale delle consegne nello spam. Tre protocolli fondamentali devono essere configurati nel DNS del proprio dominio:

• SPF (Sender Policy Framework) — un record TXT nel DNS che specifica quali server sono autorizzati a inviare email per conto del proprio dominio. Esempio: v=spf1 include:spf.mailpoet.com ~all
• DKIM (DomainKeys Identified Mail) — una firma crittografica che verifica che il messaggio non sia stato alterato durante il transito. MailPoet Sending Service fornisce il record DKIM da aggiungere al DNS
• DMARC (Domain-based Message Authentication) — una policy che indica ai server riceventi come gestire le email che non superano i controlli SPF e DKIM. Un record DMARC base: v=DMARC1; p=quarantine; rua=mailto:dmarc@tuodominio.it

Per verificare che i record siano configurati correttamente, utilizzare strumenti online gratuiti come MXToolbox o Mail Tester.

Analizzare il Contenuto delle Email

Anche con autenticazione corretta, il contenuto delle email potrebbe attivare i filtri anti-spam:

• Evitare parole trigger — termini come “gratis”, “offerta imperdibile”, “clicca subito”, “guadagna” in eccesso aumentano il punteggio spam
• Bilanciare testo e immagini — email composte solo da immagini o con pochissimo testo vengono penalizzate. Il rapporto ideale è almeno 60% testo e 40% immagini
• Evitare link abbreviati — URL abbreviati con bit.ly o simili sono spesso associati a comunicazioni fraudolente
• Includere testo in chiaro — MailPoet genera automaticamente la versione testuale delle email HTML, ma è consigliabile verificare che sia leggibile
• Link di disiscrizione visibile — MailPoet lo include automaticamente, ma verificare che sia presente e funzionante

Verificare le Blacklist

Il proprio dominio o IP di invio potrebbe essere finito in una blacklist a causa di segnalazioni spam precedenti. Utilizzare strumenti come MXToolbox Blacklist Check per verificare lo stato del proprio dominio e IP. Se risultano in blacklist, è necessario seguire la procedura di delisting specifica per ogni lista.

Problema 3: I Moduli di Iscrizione Non Vengono Visualizzati

I form di iscrizione creati con MailPoet non appaiono sul sito, oppure vengono mostrati in modo errato.

Conflitti con Plugin di Caching

I plugin di caching come WP Rocket, W3 Total Cache o LiteSpeed Cache possono servire versioni cachate delle pagine che non includono i moduli di MailPoet generati dinamicamente. Le soluzioni possibili sono:

• Escludere gli script di MailPoet dal minifying — aggiungere mailpoet alla lista delle esclusioni JavaScript nel plugin di caching
• Escludere le pagine con form dalla cache — se il form è presente solo su specifiche pagine, escluderle dalla cache
• Svuotare la cache — dopo aver creato o modificato un form, svuotare sempre la cache del sito
• Disabilitare la combinazione CSS — in alcuni casi, la combinazione dei file CSS interferisce con lo stile dei moduli di MailPoet

Conflitti con il Tema o Altri Plugin

Alcuni temi o plugin possono interferire con il rendering dei moduli di MailPoet. Per diagnosticare il problema:

1. Attivare temporaneamente un tema predefinito di WordPress (Twenty Twenty-Four o simile)
2. Se il form appare correttamente, il problema è nel tema — contattare lo sviluppatore del tema
3. Se il form continua a non apparire, disattivare tutti i plugin tranne MailPoet e riattivarli uno alla volta per identificare il conflitto

Verificare il Posizionamento del Form

Assicurarsi che il modulo sia correttamente inserito nella pagina:

• Widget — verificare che il widget di MailPoet sia posizionato in una area widget attiva nel tema corrente
• Blocco Gutenberg — verificare che il blocco MailPoet Form sia stato salvato e pubblicato correttamente
• Shortcode — verificare che lo shortcode [mailpoet_form id="X"] contenga il numero ID corretto del form
• Popup e slide-in — verificare le impostazioni di visualizzazione (pagine, tempi, frequenza)

Problema 4: Errori nella Importazione degli Iscritti

La importazione di iscritti da file CSV o da altre piattaforme di email marketing genera errori o risultati incompleti.

Formato del File CSV

Il file CSV deve rispettare requisiti specifici per essere importato correttamente:

• Codifica UTF-8 — salvare il file in formato UTF-8 per evitare problemi con caratteri accentati e speciali
• Separatore — MailPoet accetta virgola, punto e virgola o tabulazione come separatori. La virgola è il formato più sicuro
• Intestazioni — la prima riga deve contenere i nomi delle colonne (email, first_name, last_name)
• Email valide — gli indirizzi email devono essere nel formato standard. Email con errori di sintassi vengono scartate
• Limiti di dimensione — file molto grandi (oltre 50.000 righe) possono causare timeout. In tal caso, suddividere il file in blocchi da 10.000-20.000 contatti

Timeout durante la Importazione

Se la importazione si blocca o va in timeout, le cause tipiche sono:

• Limite di memoria PHP — aumentare il valore di memory_limit nel file php.ini ad almeno 256M
• Tempo di esecuzione PHP — aumentare max_execution_time ad almeno 300 secondi
• File troppo grande — suddividere in file più piccoli come indicato sopra

Problema 5: Invio Lento delle Campagne

Le email vengono inviate, ma il processo è estremamente lento — una campagna a 5.000 iscritti richiede ore o giorni per completarsi.

Cause e Soluzioni per la Lentezza di Invio

• Frequenza del cron — se WP-Cron viene attivato solo dalle visite al sito, un sito con poco traffico avrà invii molto lenti. Configurare un cron di sistema con frequenza di 1-2 minuti
• Limiti del hosting — i provider di hosting condiviso limitano spesso il numero di email per ora. MailPoet rispetta automaticamente questi limiti, rallentando la coda
• Batch size — nelle impostazioni avanzate di MailPoet è possibile regolare il numero di email inviate per batch. Un valore troppo basso rallenta il processo
• Risorse del server — su hosting con risorse limitate (CPU e RAM), il processo di invio compete con le richieste dei visitatori. Considerare un upgrade del piano hosting o il passaggio al MailPoet Sending Service
• Plugin pesanti — plugin che richiedono molte risorse durante il caricamento (page builder, plugin di sicurezza con scansioni attive) possono rallentare il cron. Verificare le performance generali del sito

Problema 6: Conflitti con Plugin di Caching

Oltre al problema dei form non visualizzati, i plugin di caching possono causare altri conflitti con MailPoet.

Pagina di Conferma Iscrizione Non Funzionante

Se la pagina di conferma iscrizione (double opt-in) non funziona correttamente, la causa potrebbe essere la cache della pagina. La URL di conferma contiene parametri univoci che la cache potrebbe ignorare. La soluzione è escludere dalla cache tutte le URL che contengono il parametro mailpoet.

Per WP Rocket, aggiungere nelle impostazioni avanzate le seguenti esclusioni:

• /mailpoet/(.*) nella sezione “Non memorizzare in cache queste pagine”
• mailpoet_router nei parametri di query da non cachare

Statistiche di Apertura Falsate

Alcune configurazioni di caching lato server (Varnish, nginx FastCGI cache) possono interferire con il pixel di tracciamento di MailPoet, generando statistiche di apertura inaccurate. La soluzione è escludere le URL di tracciamento di MailPoet dalla cache del server.

Newsletter con Contenuto Vecchio

Se le newsletter automatiche per nuovi articoli mostrano contenuto non aggiornato, la cache degli oggetti (Object Cache come Redis o Memcached) potrebbe servire dati obsoleti. Svuotare la object cache dopo la pubblicazione di un nuovo articolo, oppure configurare il plugin di caching per invalidare la cache sugli eventi di pubblicazione.

Problema 7: Errori nelle Tabelle del Database

MailPoet crea numerose tabelle nel database WordPress (con prefisso mailpoet_ o wp_mailpoet_). Tabelle corrotte o mancanti possono causare errori critici.

Tabelle Principali di MailPoet

Le tabelle fondamentali create dal plugin includono:

• mailpoet_subscribers — tutti gli iscritti e i relativi dati
• mailpoet_segments — le liste di distribuzione
• mailpoet_newsletters — le campagne email create
• mailpoet_sending_queues — la coda di invio delle email
• mailpoet_statistics_newsletters — le statistiche di invio
• mailpoet_statistics_opens — i dati di apertura
• mailpoet_statistics_clicks — i dati dei clic
• mailpoet_scheduled_tasks — le attività pianificate
• mailpoet_settings — le impostazioni del plugin

Come Riparare le Tabelle

Se MailPoet segnala errori relativi alle tabelle del database, procedere in questo ordine:

1. Eseguire un backup completo del database prima di qualsiasi intervento
2. Disattivare e riattivare il plugin — MailPoet verifica e ricrea le tabelle mancanti durante la attivazione
3. Utilizzare phpMyAdmin — selezionare le tabelle mailpoet_* e scegliere “Ripara tabella” per correggere errori di corruzione
4. Reinstallare il plugin — in casi estremi, disinstallare e reinstallare MailPoet. I dati nelle tabelle del database non vengono eliminati durante la disinstallazione standard, a meno che non si scelga esplicitamente di rimuovere tutti i dati

Problema 8: Compatibilità con la Versione PHP

MailPoet richiede una versione PHP adeguata per funzionare correttamente. Nel 2026, la versione minima consigliata è PHP 7.4, ma è fortemente raccomandato utilizzare PHP 8.1 o superiore.

Verificare la Versione PHP

Per controllare la versione PHP in uso, accedere alla dashboard WordPress e navigare in Strumenti > Salute del sito > Info > Server. In alternativa, la maggior parte dei pannelli di controllo hosting (cPanel, Plesk) mostra la versione PHP nelle impostazioni del dominio.

Problemi Comuni Legati a PHP

• PHP 7.2 o inferiore — MailPoet potrebbe non funzionare o generare errori fatali. Aggiornare immediatamente a PHP 8.1+
• Estensioni PHP mancanti — MailPoet richiede le estensioni mbstring, xml, curl e openssl. Verificare che siano abilitate nella configurazione PHP
• Aggiornamento PHP senza test — prima di aggiornare la versione PHP in produzione, eseguire un test in ambiente di staging per verificare la compatibilità con tutti i plugin installati

Problema 9: Errori di Memoria PHP

Messaggi come Fatal error: Allowed memory size exhausted indicano che PHP non ha memoria sufficiente per eseguire le operazioni di MailPoet.

Soluzioni per Errori di Memoria

• Aumentare memory_limit — modificare il valore nel file php.ini o wp-config.php aggiungendo: define('WP_MEMORY_LIMIT', '256M');
• Ottimizzare il database — tabelle di MailPoet molto grandi (specialmente le statistiche) consumano memoria durante le query. Utilizzare le funzioni di pulizia integrate di MailPoet per rimuovere dati obsoleti
• Ridurre il numero di plugin attivi — ogni plugin caricato consuma memoria. Disattivare i plugin non essenziali
• Contattare il provider di hosting — se il problema persiste, potrebbe essere necessario un piano hosting con risorse maggiori

Problema 10: Analisi dei File di Log

Quando i problemi non sono evidenti, i file di log forniscono informazioni preziose per la diagnosi.

Log di MailPoet

MailPoet registra le proprie attività nei log accessibili da MailPoet > Impostazioni > Avanzate > Logging. Abilitare il logging a livello “Tutto” durante la diagnosi, ricordando di riportarlo a livello “Errori” una volta risolto il problema, per evitare un consumo eccessivo di spazio su disco.

Log di WordPress

Per abilitare il log degli errori di WordPress, aggiungere al file wp-config.php:

define('WP_DEBUG', true);

define('WP_DEBUG_LOG', true);

define('WP_DEBUG_DISPLAY', false);

Gli errori verranno registrati nel file wp-content/debug.log. Cercare nel file le righe che contengono “MailPoet” per filtrare gli errori rilevanti. Ricordare di disabilitare il debug in produzione una volta completata la diagnosi.

Log del Server Email

Se si utilizza un SMTP proprio, i log del server email (tipicamente in /var/log/mail.log su server Linux) contengono informazioni dettagliate sugli errori di consegna, i bounce e i rifiuti da parte dei server destinatari.

Procedura di Diagnosi Generale

Quando si incontra un problema con MailPoet di cui la causa non è chiara, seguire questa procedura sistematica:

1. Aggiornare MailPoet — verificare di utilizzare la versione più recente del plugin, che potrebbe contenere correzioni per il problema riscontrato
2. Verificare la compatibilità — controllare che la versione di WordPress, PHP e del tema siano compatibili con la versione di MailPoet installata
3. Controllare lo stato del sistema — in MailPoet > Impostazioni > Avanzate, la sezione “Stato del sistema” mostra eventuali problemi rilevati automaticamente
4. Testare con tema predefinito — attivare temporaneamente un tema WordPress predefinito per escludere conflitti con il tema attuale
5. Disattivare gli altri plugin — disattivare tutti i plugin tranne MailPoet per verificare se il problema è causato da un conflitto
6. Abilitare i log — attivare il logging dettagliato di MailPoet e WordPress per raccogliere informazioni diagnostiche
7. Consultare la documentazione — la knowledge base ufficiale di MailPoet contiene guide dettagliate per la risoluzione dei problemi più comuni
8. Contattare il supporto — per gli utenti Premium, il supporto prioritario è disponibile tramite ticket

Conclusioni

La maggior parte dei problemi di MailPoet ha soluzioni semplici e documentate. La configurazione corretta del cron di WordPress, la autenticazione email tramite SPF/DKIM/DMARC e la gestione dei conflitti con i plugin di caching risolvono la stragrande maggioranza delle problematiche riscontrate dagli utenti.

Per problemi più complessi o specifici del proprio ambiente server, non esitare a contattare il nostro team di assistenza tecnica. Offriamo supporto specializzato per la configurazione e la risoluzione dei problemi di MailPoet su WordPress. Visita anche la nostra pagina dedicata al software newsletter per scoprire come possiamo aiutarti a gestire al meglio il tuo email marketing.