Il pacchetto è n8n-nodes-email-spam-tester. Il codice sorgente e le release sono disponibili su GitHub ed è pubblicato su npm tramite GitHub Actions con un'attestazione di provenienza, così chiunque può verificare da quale commit è stata generata una versione.
Connessione
Su un'installazione self-hosted di n8n, apri Settings › Community Nodes, premi Install e inserisci n8n-nodes-email-spam-tester. Quindi ottieni una chiave tramite il modulo qui sopra, crea una credenziale Email Spam Tester API in n8n e incollala. La chiave è gratuita ed è associata all'indirizzo email che hai inserito. Non è richiesta alcuna password e non ti viene inviato nulla via email. Se perdi la chiave, richiedine un'altra con lo stesso indirizzo: quelle precedenti continueranno a funzionare.
Il nodo
Email Spam Tester ha quattro risorse:
- Test Address › Create restituisce un indirizzo monouso valido per un'ora. Invia l'email dall'origine che normalmente gestisce i tuoi invii (Gmail, SMTP o il tuo ESP), perché metà dei controlli analizza ciò che viene aggiunto da quel mittente. Attivando Check Folder at Email Providers, ottieni anche circa 30 caselle di prova presso 14 provider e un indicatore da inserire nell'oggetto. Quelle di Gmail sono caselle di prova pubbliche: chiunque vi abbia accesso può vedere l'oggetto, il nome del mittente e la cartella, quindi per le email riservate non usare il controllo della cartella.
- Report › Get recupera il report tramite il relativo ID del test. Attivando Wait for Report, il nodo attende fino all'arrivo e al completamento dei controlli dell'email, per un massimo di 15 minuti. Può anche attendere il piano di correzione generato dall'AI, che arriva circa un minuto dopo i controlli. Report › Get Many elenca i report precedenti, indicando per ciascuno cosa è cambiato rispetto al test precedente dello stesso dominio.
- Folder Check › Get indica Inbox, Promotions, Spam o non ricevuta per ogni provider. La tabella è completa circa mezz'ora dopo l'invio.
- Permanent Mailbox crea, elenca e chiude indirizzi che non scadono, uno per ogni dominio di invio, mentre Get Emails recupera le email arrivate in uno di questi indirizzi.
Per impostazione predefinita, un report contiene dieci campi: l'ID del test, il punteggio su 100 e quello classico da 0 a 10, l'oggetto, il mittente, un riepilogo, i problemi, gli avvisi, i titoli delle correzioni e il link. Disattiva Simplify per ottenere tutti i controlli con le relative prove. Il nodo può essere usato anche come strumento per AI Agent di n8n.
Il trigger
Email Spam Tester Trigger avvia un workflow quando un report è pronto: per un'email inviata a uno dei tuoi indirizzi di test oppure per ogni email che raggiunge una casella di posta permanente. Iscrivi una casella di posta permanente alla tua newsletter e ogni numero arriverà nel workflow con il relativo punteggio e i problemi rilevati.
Workflow da cui iniziare
- Prima di inviare una campagna, crea un indirizzo di test, inviagli il modello con il nodo Send Email, attendi il report e, se il punteggio è inferiore a 70, pubblica i problemi su Slack invece di procedere con l'invio.
- Un controllo settimanale di un dominio di invio: un Schedule Trigger, gli stessi tre passaggi e una riga in Google Sheets con il punteggio e la data.
- Per ogni nuova email in una casella di posta permanente con un punteggio inferiore a 70, invia le correzioni al responsabile della newsletter.
Limiti
Una chiave consente 50 test al giorno, 3 dei quali con il controllo della cartella, e fino a 5 caselle di posta permanenti che ricevono 300 email al giorno ciascuna. Il limite si applica a ogni chiave ed è condiviso con Zapier se usi la stessa chiave anche lì. Una volta superato, Test Address › Create si interrompe indicando il motivo e quando sarà nuovamente disponibile. I test sul sito web non vengono conteggiati.
Dati
Un report di test è accessibile pubblicamente a chiunque disponga del relativo link, come sul sito. I report delle email inviate a una casella di posta permanente si aprono solo con la tua chiave. L'email viene eliminata due giorni dopo la ricezione e il relativo report dopo 90 giorni. L'informativa sulla privacy descrive la gestione delle chiavi, mentre la documentazione dell'API elenca tutte le chiamate effettuate dal nodo.