Invia email con WebBlocks Campaigns

Usa un sito di prova e un account con accesso al sito corretto. L’installazione richiede Super admin. Campaigns separa i permessi di visualizzazione, gestione, invio e modifica delle impostazioni. Poter modificare una campagna non implica poterla inviare o spedire un test del modello. Consulta Ruoli e permessi prima di delegare queste operazioni.

Il manifesto 0.7.4 richiede CMS ^1.92.0 e PHP >=8.3; il catalogo indica compatibilità con PHP ^8.3 e Laravel ^13.0. Verifica il risultato per l’installazione effettiva, compresi i requisiti del CMS. Usa l’archivio pubblicato nel catalogo dei plugin WebBlocks.

Chiedi all’amministratore dell’hosting di configurare un trasporto email funzionante e le esecuzioni di invio. Le impostazioni del mittente nel plugin non configurano SMTP. Gli indirizzi fittizi example.test sono dimostrativi; per la consegna reale usa caselle di prova sotto il tuo controllo. Conserva le credenziali del fornitore nella configurazione privata dell’applicazione host.

Campaigns serve per le campagne email. Non aggiunge alle schermate mostrate un editor visuale delle email, un calendario automatico o statistiche di apertura e clic. Contact Messages, gli invii di Forms e i contatti di Campaigns svolgono compiti diversi. L’invio di un modulo non autorizza automaticamente una newsletter.

1. Apri System → Plugins come Super admin.
2. Scegli Browse Plugin Catalog e trova WebBlocks Campaigns.
3. Leggi versione, risultato di compatibilità e note di rilascio.
4. Seleziona Install from Catalog, poi Enable Plugin nei dettagli.
5. Se l’amministratore fornisce lo ZIP pubblicato e attendibile, usa Plugin ZIP → Upload Plugin ZIP, esamina il pacchetto e attivalo.

Le nuove installazioni iniziano disattivate. L’installazione e l’attivazione del CMS corrente preparano le modifiche al database. Se compaiono avvisi di configurazione o migrazione, risolvili dai dettagli del plugin e con il flusso supportato dall’host prima di inserire contatti. Un’installazione riuscita non prova che funzionino trasporto email e invii pianificati.

Dopo l’attivazione trovi Campaigns, Contacts, Templates, Lists, Suppressed, Delivery problems e Settings nella navigazione. Controlla il sito selezionato in ogni schermata. Contatti, impostazioni e campagne appartengono a un sito; la lista di un altro sito non è il tuo pubblico corrente.

Apri Templates → Add template e verifica editor e campi di unione disponibili. Campaigns 0.7.4 corregge l’errore di compilazione della schermata presente in 0.7.3. Dopo l’aggiornamento prova sia la creazione sia la riapertura di un modello salvato.

Apri Campaigns Settings per il sito. L’esempio locale usa:

Controlla i valori e scegli Save. Questa versione accetta lotti di 1–500, limiti di 1–20000 e soglie di rimbalzo temporaneo di 0–50. La soglia zero disattiva il blocco automatico per rimbalzi temporanei ripetuti; non rende recapitabili gli indirizzi con errori permanenti.

L’aiuto di Most per hour descrive un tetto per una campagna in una singola esecuzione. Il contatore riparte per ogni campagna e invocazione. Non è una quota oraria mobile condivisa dall’intero sito o dal fornitore. Il controllo avviene prima di un lotto completo: un lotto più grande della disponibilità residua può superarla. Mantieni il lotto entro il limite scelto, pianifica consapevolmente la frequenza e usa la limitazione dell’host o fornitore quando serve garantire un ritmo reale.

Chiedi all’amministratore di verificare il mittente presso il fornitore e provare il recapito reale, comprese le risposte. Un ricevitore locale, un mailer di log o impostazioni salvate non dimostrano che un fornitore esterno autorizzi il tuo dominio all’invio.

Apri Lists, crea Studio notes e aggiungi una descrizione utile, per esempio «Notizie e aggiornamenti sui workshop di Northstar Studio». La lista separa questa newsletter dagli altri contatti. Le immagini includono anche Delivery test only, un pubblico tenuto distinto per la prova dei nuovi tentativi.

Una lista raggruppa contatti; non autorizza a scrivere loro. La campagna verifica comunque consenso e blocchi. Eliminare la lista rimuove il raggruppamento, senza cancellare i contatti né registrarne la revoca. Usa le funzioni di consenso e blocco per queste decisioni.

Scegli una lista specifica quando il messaggio ha un pubblico preciso. Everyone on this site è una selezione più ampia e deve essere intenzionale, non una scelta predefinita ignorata.

Apri Contacts → Import. L’importatore accetta CSV fino a 20 MB con virgola o punto e virgola come separatore e un eventuale byte-order mark UTF-8. Usa una riga di intestazione. Per questa prova il file è:

La riga duplicata di Ada e l’indirizzo non valido sono intenzionali. Conserva una copia pulita del file reale per indagare sulle righe scartate senza importarlo ripetutamente.

Seleziona file e consent basis corretta, registra il testo esatto valido quando i contatti hanno aderito e scegli Studio notes come lista. Il testo fittizio significa: «Sì, desidero ricevere via email notizie e workshop di Northstar Studio. Posso disiscrivermi in qualsiasi momento». Premi Continue.

Questi campi registrano la tua dichiarazione sul permesso del contatto; scegliere una base non ne prova l’esistenza. Usa la base e le evidenze effettivamente pertinenti. In questa versione, importare solo con base contrattuale non attiva il distinto indicatore di consenso operativo.

Nella schermata di mappatura verifica esplicitamente ogni colonna:

Controlla i suggerimenti automatici. Verifica soprattutto la colonna del nome invece di supporre che first_name sia stato riconosciuto correttamente. Mappa una sola colonna di indirizzi su Email e ignora quelle superflue. L’anteprima mostra righe di esempio; non ha ancora creato contatti.

Scegli Import soltanto quando mappatura, base, testo e lista sono corretti. L’esempio crea due contatti e salta due righe. Il contatto già presente per il nuovo tentativo rimane visibile nell’ambiente dimostrativo: il totale non coincide con i contatti importati da questo file.

L’interfaccia attuale riporta risultati aggregati. Non offre qui uno storico consultabile dei problemi per singola riga. Se i totali non tornano, cerca duplicati, indirizzi non validi o bloccati nel CSV originale prima di preparare una correzione.

Reimportare non azzera i dati. Nomi non vuoti possono aggiornare quelli esistenti; valori vuoti non li cancellano, e i campi personalizzati vengono uniti al contatto. L’importazione non annulla consensi concessi o revocati e non rimuove blocchi. Non usarla ripetutamente per aggirare una revoca.

Crea o modifica una pagina in bozza e aggiungi il blocco nativo Newsletter Sign-up. Per l’esempio imposta:

Salva il blocco e segui il flusso di revisione e pubblicazione della pagina. La pagina di iscrizione deve essere raggiungibile prima di usarla per acquisire iscritti reali. Senza lista, i contatti confermati vengono salvati senza tale associazione; scegli Studio notes intenzionalmente.

In questa versione titolo personalizzato, introduzione e testo di consenso sono impostazioni condivise tra le lingue della pagina. Tradurne il titolo non traduce automaticamente questi valori. Controlla lingua e testo mostrati al visitatore in ogni posizione prima di usare il blocco su un sito multilingue.

Apri la pagina pubblica con un indirizzo di prova controllato. Il visitatore fittizio è Robin Example, robin@example.test. Inserisci nome ed email, leggi il consenso, seleziona la casella e scegli Subscribe.

La pagina mostra Almost done. La richiesta è ancora in attesa e Robin non è stato aggiunto come contatto confermato. La risposta generica non rivela neppure se un indirizzo sia già iscritto o bloccato. Non dimostra l’arrivo dell’email di conferma.

Apri il collegamento dalla tua casella di prova. La semplice apertura mostra la pagina di conferma; l’iscrizione non è confermata finché il visitatore non sceglie Yes, confirm my subscription.

Dopo quel clic compare l’esito positivo. Campaigns crea o aggiorna il contatto, registra il consenso esplicito e aggiunge l’iscritto confermato alla lista scelta.

Una nuova richiesta genera un token di conferma con scadenza di sette giorni; il collegamento precedente smette di funzionare quando il token viene sostituito. Richiedi un nuovo messaggio quando necessario, invece di condividere URL private. Una richiesta normale non annulla blocchi manuali o dovuti a reclami. La conferma può rimuovere i blocchi consentiti per disiscrizione o rimbalzo permanente; non è uno sblocco universale.

I dati di prova hanno attraversato gli endpoint reali di iscrizione e conferma con posta locale. Corpi dei messaggi e link privati sono stati scartati dopo la prova. L’arrivo in una casella reale resta una verifica separata per la produzione.

Apri Templates → Add template, compila i campi seguenti e premi Save. Il modello salvato si apre in Edit template, dove puoi modificarlo e controllarne l’anteprima.

Il modulo include Name, Subject, HTML body e Plain-text body. Usa Studio notes email come nome interno. In Subject inserisci:

Per HTML body parti da un esempio piccolo e leggibile:

Scrivi separatamente la versione in testo semplice:

Il testo semplice non viene convertito automaticamente dall’HTML. Controllali entrambi. Il modello contiene HTML scritto dall’operatore: usa codice attendibile e provane la resa nei client email.

I campi integrati comprendono email, first_name, last_name e unsubscribe_url. Possono essere disponibili anche campi importati come interest. La lista usa un campione di contatti recenti; un campo raro di un contatto vecchio potrebbe non essere riconosciuto. Verifica l’elenco effettivo e la validazione prima dell’accodamento.

{{ first_name | friend }} usa “friend” quando manca il nome. Casey mostra l’utilità del valore di riserva. I campi sconosciuti impediscono test e accodamento; l’assenza di riserva produce invece un avviso senza bloccare automaticamente l’invio.

Per le email commerciali inserisci un vero collegamento di disiscrizione nell’HTML e la sua URL nel testo semplice. La validazione cerca il campo riservato nell’insieme di oggetto e corpi; non garantisce un collegamento utilizzabile in ogni formato. Controlla entrambe le versioni.

Dopo aver salvato nel corretto editor, esamina Preview, inserisci un destinatario test email controllato e scegli Send test. Serve il permesso di invio. L’oggetto riceve il prefisso [TEST].

L’anteprima sostituisce i valori e mostra l’HTML come sorgente. Non è una simulazione visuale di un client email. Usa un contatto di esempio, normalmente il più vecchio del sito. Non supporre che sia Ada o che esista un selettore visibile. Controlla valori presenti e mancanti con dati di prova.

unsubscribe_url rimane vuoto nelle anteprime e nei test del modello. La URL specifica del destinatario viene inserita durante un vero invio di campagna. Un test riuscito non verifica quindi il percorso di disiscrizione. Per quello usa una piccola campagna approvata.

Nella prova abbiamo creato e salvato il modello dall’editor, riaperto il record e salvato una modifica all’oggetto. L’anteprima senza nome ha mostrato “friend” come previsto. Il test è poi arrivato al ricevitore SMTP locale. Questo verifica il flusso applicativo, non la consegna esterna. Prima della produzione controlla una casella reale, entrambi i formati, le riserve dell’oggetto, le risposte e il vero link del destinatario.

L’avviso sui valori di riserva può citare unsubscribe_url. Mantieni il campo riservato nel collegamento reale: il valore individuale viene generato durante l’invio. Sostituirlo con testo generico per nascondere l’avviso eliminerebbe la destinazione funzionante della disiscrizione.

Risolvi prima un trasporto mancante o inutilizzabile. I mailer log, array e null non provano la consegna esterna; il plugin rifiuta il test se il mailer non è disponibile. Non usare un pubblico reale per diagnosticare la configurazione SMTP di base.

Apri Campaigns → Add campaign. Inserisci November studio notes, scegli Studio notes email, seleziona Studio notes e il canale Commercial. Salva la bozza.

Una campagna commerciale richiede consenso marketing con base adeguata, come consenso esplicito o rapporto con un cliente esistente. Gli indirizzi bloccati sono esclusi. Il canale distinto Operational richiede consenso operativo; cambiarlo non aggira un blocco. Il blocco dell’indirizzo vale per entrambi i canali Campaigns.

Il numero di contatti utilizzabili per marketing non garantisce che tutti ricevano questa campagna. Appartenenza alla lista, base valida e blocchi modificano il pubblico effettivo. Esamina totale e registro dei destinatari.

Bozze e campagne in pausa sono modificabili; quelle in coda o in invio non lo sono liberamente. Modello e valori dei contatti vengono letti durante il dispatch, non congelati interamente all’accodamento. Mantieni stabili modello e pubblico durante l’esecuzione. Non cancellare un modello ancora necessario.

Quando la bozza è pronta, scegli Queue for sending. Si creano righe per gli indirizzi idonei. L’accodamento da solo non consegna messaggi. Nell’esempio include Ada, Casey e Robin ormai confermato.

Usa Pause per fermare ulteriori elaborazioni mentre controlli. Nella prova locale il dispatcher è stato eseguito con campagna in pausa e i destinatari sono rimasti in attesa.

Queue for sending riprende una campagna in pausa. Se il pubblico è invariato, non duplica le righe. Può però aggiungere contatti diventati idonei: non elimina i precedenti e non ricostruisce il pubblico da zero. Cambiare lista dopo una pausa non rimuove automaticamente gli indirizzi già accodati.

Prima di riprendere, controlla i destinatari in attesa e i cambiamenti del pubblico. Per un pubblico sostanzialmente diverso prepara una campagna verificata separatamente, senza supporre che pausa e modifica azzerino quella precedente.

L’amministratore dell’hosting esegue il comando nell’applicazione host del CMS:

Per un’esecuzione controllata di una campagna, sostituisci 123 con il suo vero identificatore:

L’impostazione predefinita è un lotto. Non esiste l’opzione --dry-run in questa versione. Dispatch può inviare email: usa solo la campagna prevista e il trasporto verificato. Con il nostro lotto di uno servono più invocazioni per il pubblico dimostrativo.

Pianifica le esecuzioni ripetute con lo scheduler o cron supportato dall’host. Avviare lo scheduler Laravel non registra automaticamente il comando Campaigns: serve un’attività pianificata esplicita. Il dispatch non richiede di per sé un queue worker separato. Valuta insieme frequenza, lotto e limiti del fornitore, tenendo presente che Most per hour opera per esecuzione.

Il test ha invocato manualmente il comando contro il ricevitore locale isolato. Non ha verificato scheduler di produzione, quote del fornitore o consegna esterna.

Una vera campagna commerciale fornisce un link individuale di disiscrizione. Aprendolo, il visitatore vede una conferma. Un semplice GET non revoca il consenso: una normale scansione dei link non disiscrive così qualcuno a sua insaputa.

Unsubscribe me completa l’operazione e mostra l’esito positivo. Nell’esempio Casey lo ha fatto dopo l’accodamento ma prima dell’invio.

Campaigns registra un blocco dell’indirizzo specifico per sito e revoca il consenso marketing. Dispatch controlla di nuovo: la riga di Casey diventa Skipped invece di essere inviata. Un pubblico accodato non garantisce quindi la consegna.

La disiscrizione pubblica crea un blocco che interessa anche Campaigns Operational. Gli altri messaggi del CMS seguono flussi diversi; non promettere che una sola azione controlli ogni email dell’host.

Apri il registro e controlla totali, righe e motivi. La campagna conclusa mostra 2 sent, 0 failed, 1 skipped: Ada e Robin sono stati accettati dall’SMTP locale, Casey saltato dopo la disiscrizione.

La campagna può risultare Sent quando tutte le righe sono definitive, comprese Failed e Skipped. La percentuale conta destinatari elaborati, non recapiti riusciti. Una campagna terminata con omissioni non rappresenta un successo totale.

Indaga con il filtro dello stato e i motivi raggruppati in Why not sent. Se il mailer non è disponibile, i destinatari possono essere saltati e la campagna concludersi comunque. Correggere la configurazione non fa reinviare le righe saltate dal pulsante riservato ai falliti. Valuta consapevolmente una nuova campagna per riconsiderare quegli indirizzi.

Apri Suppressed per il registro degli indirizzi. Casey rimane elencato con motivo Unsubscribed, indipendentemente dalla scheda del contatto.

Usa i controlli manuali per bloccare un indirizzo e registra il motivo appropriato. Rimuovere un blocco non ripristina il consenso: una revoca marketing resta valida finché non viene concesso correttamente un nuovo consenso. Reimportare l’indirizzo non elimina il blocco.

Revocare il marketing è diverso dal creare un blocco dell’indirizzo. Il primo modifica il permesso commerciale; il secondo blocca entrambi i canali Campaigns. Quando indaghi su un’esclusione, considera insieme motivo, registrazione del consenso e canale previsto.

La lista separata Delivery test only contiene un indirizzo fittizio. Il ricevitore SMTP ha rifiutato intenzionalmente il primo tentativo con una risposta temporanea di casella piena. Il registro mostra una riga Failed e Try 1 failed again.

Leggi il motivo e risolvi la causa prima di scegliere l’azione. Il nuovo tentativo riporta i falliti in attesa, riutilizza le stesse righe e ricontrolla consenso e blocchi al momento dell’invio. Non crea duplicati per lo stesso indirizzo. Esegui nuovamente Dispatch dopo aver richiesto il tentativo.

Il secondo tentativo locale è riuscito perché il ricevitore era predisposto ad accettarlo. Dimostra la meccanica del nuovo tentativo, non la risoluzione di un guasto reale del fornitore. Ripetere senza modifiche un errore di autenticazione o policy del mittente difficilmente aiuta.

Apri Delivery problems per gli errori registrati. L’evento temporaneo rimane anche dopo il successo: è uno storico, non necessariamente un blocco attuale.

Gli errori permanenti di indirizzo possono causare un blocco immediato. I rimbalzi temporanei ripetuti possono raggiungere la soglia del sito. Blocchi di policy o mittente ed errori sconosciuti non vengono considerati automaticamente indirizzi inesistenti. Controlla classificazione e risposta del fornitore invece di bloccare manualmente tutto il pubblico dopo un errore dell’host.

Prima dei contatti reali, ripeti l’intero flusso sulle versioni compatibili effettive. Conferma sito corretto e permesso di invio separato. Importa un piccolo pubblico controllato, verifica consensi e liste e completa una conferma pubblica con casella reale.

Crea e salva il modello nell’interfaccia funzionante. Prova riserve dell’oggetto, formati HTML e testo, link dei destinatari e risposte. Verifica fornitore reale, autorizzazione del mittente e recapito. Esegui una piccola campagna approvata, controlla ogni stato e prova pausa, disiscrizione e un nuovo tentativo scelto con attenzione. Verifica infine pianificazione esplicita e ritmo di invio rispetto ai limiti del fornitore.

Mantieni significativo il testo del consenso quando cambia la newsletter. Esamina i blocchi senza ripristinare silenziosamente il permesso. La lista organizza, la campagna è un lavoro di invio e il registro documenta ciò che è stato realmente elaborato.

Per altri flussi consulta Crea moduli personalizzati con WebBlocks Forms, Ruoli e permessi e il riferimento di Campaigns.