Guida a JoeSMTP

Cos'è JoeSMTP

JoeSMTP è la piattaforma per inviare email e SMS ai tuoi contatti: campagne di marketing, newsletter e messaggi transazionali (conferme d'ordine, reset password, notifiche), il tutto con statistiche di recapito, apertura e click.

Ogni cosa che fai vive dentro un progetto: uno spazio di lavoro isolato con i suoi contatti, mittenti, campagne, crediti e chiavi API. Puoi avere più progetti (ad esempio uno per cliente o per brand) e passare dall'uno all'altro in un clic.

Concetti chiave

Pochi termini ricorrono in tutta la piattaforma. Tienili a mente e il resto sarà immediato.

Primo accesso

Al primo ingresso un breve tour di benvenuto ti guida attraverso l'interfaccia, poi si apre il wizard per creare il tuo primo progetto.

1. Crea il tuo progetto. Dai un nome (es. il nome della tua azienda). Puoi aggiungere subito eventuali campi personalizzati per i contatti, ma non è obbligatorio.
2. Ricevi i crediti di prova. Al primo progetto viene accreditato un pacchetto omaggio (una volta per account), con validità 12 mesi.
3. Trovi già un mittente pronto. Il progetto nasce con un mittente di sistema (smtp@joesmtp.it) già verificato, così puoi provare subito. Per usare il tuo dominio, aggiungi e verifica un mittente tuo.
4. Importa i contatti da CSV o creali a mano, quindi crea la prima campagna.

Cos'è un progetto

Un progetto è uno spazio di lavoro completamente isolato. Ogni progetto ha i propri:

• Contatti, liste e campi personalizzati
• Mittenti email verificati
• Campagne email e SMS
• Crediti e storico acquisti
• Chiavi API e impostazioni di aspetto

In questo modo puoi gestire più clienti o divisioni senza che i dati si mescolino mai.

Cambiare progetto attivo

Il selettore di progetto si trova in alto a sinistra nella barra laterale, sotto il logo.

• Con un solo progetto: compare solo il nome del progetto (etichetta “Progetto”).
• Con più progetti: compare un menu a tendina (“Progetto attivo”) da cui scegli su quale lavorare.

In alternativa, nella pagina Progetti puoi cliccare Attiva sulla riga del progetto desiderato. Il progetto attivo diventa il contesto per tutte le tue azioni (campagne, contatti, impostazioni).

Creare, attivare, eliminare

La pagina Progetti (menu “Account → Progetti”) elenca tutti i tuoi progetti con crediti, numero di contatti, campagne, data di creazione e stato.

Creare un progetto

Clicca + Crea nuovo progetto e indica un nome (obbligatorio, univoco). Facoltativamente aggiungi campi personalizzati. Alla creazione, il sistema in automatico:

• imposta il nuovo progetto come attivo;
• crea un mittente di sistema già verificato;
• genera le credenziali API (Client ID e Secret);
• accredita il pacchetto di prova (solo al primo progetto dell'account).

Attivare un progetto

Clicca Attiva sulla riga del progetto. Ce n'è sempre uno solo attivo per account.

Eliminare un progetto

Clicca Elimina sulla riga del progetto e conferma.

Aspetto e personalizzazione

Ogni progetto può avere uno stile applicato a tutte le sue email. Si configura in Impostazioni → Aspetto email.

Fascione JoeSMTP

Per impostazione predefinita ogni email si chiude con la fascia JoeSMTP («proudly done with JoeSMTP») e il link di disiscrizione. Puoi scegliere il colore di sfondo della fascia da una palette scura, così logo e testo restano leggibili.

La fascia non è più obbligatoria: con l'opzione “Aggiungi automaticamente il footer JoeSMTP” puoi disattivarla. In tal caso però la disiscrizione resta a tuo carico: devi inserire tu il segnaposto [UNSUBSCRIBE_LINK] nel corpo, nell'header o nel footer dell'email. In fase di invio viene sostituito con il link di disiscrizione univoco del destinatario.

Header e footer

Puoi definire un header (in cima) e un footer (in fondo, prima della fascia) in HTML, aggiunti automaticamente a tutte le email del progetto — utili per logo, disclaimer, link social. Lascia vuoto per non aggiungere nulla.

Colonne personalizzate

Nelle tabelle (ad es. Contatti) puoi scegliere quali colonne visualizzare e in che ordine con il pulsante Colonne: spunta quelle da mostrare e usa le frecce ↑/↓ per riordinarle. La scelta è salvata per progetto.

La tabella contatti

L'area Contatti è la base dati dei tuoi destinatari. In alto a sinistra trovi il contatore “X visibili · Y totali”: visibili sono quelli che rispettano i filtri attivi, totali l'intero database del progetto.

Colonne, ordinamento e paginazione

Le colonne standard sono Email, Nome, Cognome, Azienda, Città e Stato; con Colonne mostri anche telefono, provincia, nazione, lingua e i tuoi campi personalizzati, e puoi riordinarle con le frecce ↑/↓ (l'ordine è indipendente da quello dei campi). Scegli quante righe vedere per pagina (50, 100, 200, 500) e naviga con i pulsanti di paginazione.

Ordina cliccando l'intestazione della tabella: un primo click ordina in modo crescente (▲), un secondo click in decrescente (▼), un terzo click torna all'ordine predefinito (dal più recente inserito). Sia l'ordine delle colonne sia l'ultimo ordinamento scelto vengono memorizzati per progetto e riproposti alla riapertura della pagina.

Apri il dettaglio di un contatto cliccando sulla sua riga (o sull'icona 👁). L'icona ☰ apre invece la gestione rapida delle sue liste, dove puoi spuntare le liste esistenti oppure crearne una nuova al volo e aggiungerci subito il contatto.

Ricerca e filtri

• Ricerca rapida: il campo “Cerca per email, nome, azienda, telefono…” filtra istantaneamente le righe.
• Stato: mostra solo Attivi, Disiscritti, Bounced o Reclami.
• Lista: mostra solo i contatti che rispettano le regole di una lista salvata.
• Filtri avanzati: con Filtri costruisci condizioni su qualunque campo. Puoi scegliere se un contatto deve soddisfare tutte le condizioni (AND, predefinito) oppure almeno una (OR). Il numero di filtri attivi appare in un badge.

Aggiungere e modificare

Nuovo contatto

Clicca + Nuovo contatto: si apre un form con Email (obbligatoria), dati anagrafici, i campi personalizzati e le Liste a cui assegnarlo (spunta le liste desiderate). Al salvataggio il contatto nasce con stato Attivo. Se re-inserisci l'email di un contatto eliminato, viene automaticamente riattivato. In modifica puoi cambiare anche l'appartenenza alle liste.

Nei campi a scelta singola o multipla l'ultima voce è + Aggiungi opzione: se il valore che ti serve non è in elenco lo crei al volo, senza passare dalle impostazioni, e resta disponibile anche per i contatti successivi (vedi Opzioni che si aggiungono da sole).

Il form mostra solo i campi che hai scelto di rendere visibili in inserimento (vedi Quali campi mostrare in inserimento): puoi ridurli per un inserimento più rapido. Per inserire più contatti di fila usa Salva e aggiungi nuovo: salva il contatto e riapre subito un form vuoto, senza tornare alla rubrica.

Modifica ed eliminazione

Usa l'icona matita per modificare, la × per eliminare. L'eliminazione è un soft-delete: il record non viene rimosso fisicamente, così lo storico invii resta integro e il contatto è recuperabile re-importandolo.

Selezione multipla e azioni massive

Puoi agire su più contatti insieme. Spunta la casella all'inizio delle righe che ti interessano (la selezione si mantiene anche cambiando pagina): compare una barra con il numero di contatti selezionati e le azioni disponibili.

• Aggiungi a lista — inserisce i contatti selezionati in una lista statica esistente, oppure ne crea una nuova al volo.
• Cambia stato — imposta in blocco lo stato dei selezionati (es. disiscrivi in massa). La riattivazione una-tantum vale anche qui: i contatti già riportati ad Attivo una volta restano bloccati e vengono saltati.
• Elimina — soft-delete in blocco (recuperabili re-importando).
• Deseleziona — svuota la selezione.

Import da CSV

Clicca Importa CSV per caricare i contatti in blocco.

1. Carica il file trascinandolo nella dropzone o selezionandolo.
2. Mappa le colonne: associa ogni colonna del CSV a un campo (standard o personalizzato). Vedi un'anteprima delle prime righe. Se mappi un campo a scelta singola o multipla con l'elenco aperto, i valori del file non ancora previsti diventano nuove opzioni del campo (vedi Opzioni che si aggiungono da sole): un avviso nella mappatura ti ricorda quali campi si comportano così.
3. Scegli come gestire i duplicati (chiave = email): Skip (salta chi esiste già) o Update (aggiorna i campi).
4. Avvia l'import e leggi il report finale.

Il report indica Inseriti, Aggiornati, Riattivati, Scartati (email non valide o duplicate nel file) ed eventuali Errori.

Campi personalizzati

In Impostazioni → Campi progetto gestisci sia i campi di sistema sia i tuoi campi aggiuntivi.

I campi di sistema (email, nome, cognome, telefono, azienda, città, provincia, nazione, lingua) hanno il badge Default: non si possono eliminare, ma con Modifica puoi rinominarne l'etichetta (es. chiamare “Email” → “Posta elettronica”) e assegnare un valore predefinito. Il codice interno (merge tag) resta invariato.

Provincia, nazione e lingua sono campi di servizio: si valorizzano tipicamente da import CSV, API o gateway SMTP, quindi di base sono disattivati nella colonna Inserimento e nascosti nell'elenco contatti. Puoi attivarli quando ti servono: dall'interruttore Inserimento per vederli nel form del nuovo contatto, da Colonne nella pagina Contatti per mostrarli in tabella. Restano comunque sempre visibili nella scheda del contatto, modificabili e utilizzabili nei filtri e come merge tag ([PROVINCIA], [NAZIONE], [LINGUA]).

Per creare un campo aggiuntivo, clicca + Nuovo campo e indica:

• Etichetta: il nome visibile (es. “Settore”). Il codice interno usato nei merge tag viene generato in automatico dall'etichetta: non devi più inserirlo a mano.
• Tipo: Testo, Numero, Data, Sì/No, Scelta singola (una sola opzione, radio) o Scelta multipla (più opzioni insieme, checkbox). Per le due scelte inserisci l'elenco delle Opzioni.
• Consenti nuove opzioni in inserimento (solo scelta singola/multipla, attivo di default): l'elenco resta aperto e si arricchisce da solo mentre inserisci i contatti. Vedi Opzioni che si aggiungono da sole.
• Valore di default (opzionale): coerente col tipo, viene precompilato nel form quando crei un nuovo contatto.

I valori dei campi personalizzati sono disponibili come merge tag nelle email e SMS (es. {SETTORE}). Puoi definire fino a 100 campi per progetto.

Opzioni che si aggiungono da sole

Nei campi a scelta singola e scelta multipla l'elenco delle opzioni è aperto: non devi prevedere tutto in anticipo. Con l'impostazione Consenti nuove opzioni in inserimento attiva (lo è di default, anche sui campi che avevi già creato):

• Nel form contatto trovi, come ultima voce del campo, + Aggiungi opzione: scrivi la nuova opzione, viene salvata e subito selezionata.
• Nell'import CSV e via API un valore non ancora previsto viene aggiunto in automatico all'elenco e assegnato al contatto: non serve preparare le opzioni prima di importare.

L'opzione nuova resta per sempre e vale per tutti: la ritrovi nel form, nell'import, via API e nei filtri di liste e campagne. JoeSMTP evita i doppioni riconoscendo i valori equivalenti: se esiste già “Città di Roma”, scrivere “citta di roma” o “CITTÀ DI ROMA” non crea una seconda opzione, il contatto viene assegnato a quella esistente.

Se preferisci un elenco chiuso — per esempio perché quel campo alimenta report o automazioni e non vuoi sorprese — togli la spunta a Consenti nuove opzioni in inserimento: da quel momento le opzioni si modificano solo da qui, dal campo Opzioni. Nella tabella dei campi riconosci i campi ad elenco aperto dall'etichetta + nuove accanto alle opzioni.

Quali campi mostrare in inserimento

La colonna Inserimento della tabella campi ha un interruttore per ogni campo (di sistema o aggiuntivo): decide se il campo compare nel form di creazione di un nuovo contatto dal pannello. Disattivandone qualcuno rendi l'inserimento manuale più rapido, mostrando solo i campi che ti servono davvero. Di base sono attivi tutti tranne provincia, nazione e lingua, e puoi cambiarli in qualsiasi momento.

Attenzione: questo vale solo per l'inserimento. In modifica di un contatto e via API restano sempre disponibili tutti i campi: nasconderli non li elimina né cancella i valori già salvati. L'email è la chiave del contatto e resta sempre visibile.

Modificare il tipo di un campo

Puoi cambiare il tipo di un campo esistente, ma alcune conversioni sono a rischio di perdita di dati: quando lo sono, l'app te lo segnala e chiede una conferma esplicita. Sono sempre sicure le conversioni Scelta singola → Scelta multipla e Numero → Testo. Non è invece possibile trasformare una Scelta multipla in Scelta singola.

Liste e Segmenti

Trovi tutto nella pagina Liste (voce di menu a sinistra, sotto Contatti; ci arrivi anche con Gestisci liste dall'area Contatti). La pagina ha due schede:

Creare una lista

Nella scheda Liste clicca + Nuova lista e dai un nome: la lista nasce vuota. Poi ci aggiungi i contatti in più modi:

• Dall'area Contatti, selezionando una o più righe e usando Aggiungi a lista (vedi Azioni massive).
• Dal dettaglio del singolo contatto, nel riquadro Liste, dove vedi le liste a cui appartiene e puoi aggiungerlo o rimuoverlo.

Clicca sul nome di una lista (o su Apri) per aprirne il dettaglio: vedi tutti i contatti che ne fanno parte e puoi rimuoverli dalla lista con Rimuovi (il contatto non viene eliminato).

Creare un segmento

1. Nella scheda Segmenti clicca + Nuovo segmento e dai un nome (es. “Clienti Roma”).
2. Aggiungi una o più condizioni (Campo → Operatore → Valore) e scegli se combinarle in tutte (AND) o almeno una (OR).
3. Vedi in tempo reale quanti contatti corrispondono, poi salva. Aprendo il dettaglio del segmento vedi le condizioni e l'anteprima dei contatti corrispondenti.

Sia le liste sia i segmenti si usano allo stesso modo: come punto di partenza nei wizard delle campagne (email e SMS) e come filtro nell'area Contatti.

Stati e disiscrizione

Disiscrizione e messaggi di servizio

La disiscrizione ferma il marketing, non le comunicazioni di servizio. Un contatto disiscritto non entra più in nessuna campagna (email o SMS), ma continua a ricevere i messaggi transazionali inviati via API o dal gateway SMTP: aggiornamenti di termini e condizioni, ricevute, reset password, notifiche sul servizio. Sono infatti i messaggi che non hanno il link di disiscrizione, perché non si può rinunciare a riceverli finché si usa il servizio.

Fanno eccezione due casi, in cui il blocco vale anche per i transazionali:

• Bounced — la casella ha risposto con un errore permanente: non esiste, scrivere ancora è inutile.
• Reclami — il destinatario ha segnalato un tuo messaggio come spam: insistere danneggia la reputazione del tuo dominio, e quella pesa su tutti gli invii del progetto, campagne comprese.

In questi due casi la chiamata API riceve un errore esplicito (422) con il motivo del blocco.

Origine del contatto

Ogni contatto porta un'etichetta di provenienza (in sola lettura): Marketing se creato da pannello o import CSV, Transazionale se creato via API (es. da una conferma d'ordine). Utile per segmentare chi è entrato organicamente da chi arriva da sistemi automatici.

Storico modifiche

Aprendo il dettaglio di un contatto trovi in fondo una timeline con la cronologia delle modifiche: creazione, aggiornamenti dei dati, cambi di stato (con motivo e campagna che li ha innescati), disiscrizione, riattivazione ed eliminazione. Ogni voce riporta quando è avvenuta e come: manuale (dal pannello), import (CSV), api, smtp (gateway) o sistema (webhook del provider, es. bounce/reclamo/disiscrizione). Serve a ricostruire la storia di un indirizzo — utile per capire perché un contatto non riceve più le campagne.

Perché verificare un mittente

Un mittente è l'indirizzo email da cui parte l'invio. Per proteggere la reputazione e garantire il recapito, le email possono partire solo da mittenti verificati: la verifica dimostra che sei autorizzato a inviare da quel dominio (tramite record DNS SPF e DKIM).

I mittenti si gestiscono in Impostazioni → Mittenti. La tabella mostra email, nome visualizzato, dominio, stato e data di verifica.

Aggiungere e verificare

1. Clicca + Aggiungi mittente e indica Email e Nome visualizzato (quello che il destinatario vede come “Da”).
2. Il sistema registra il dominio e ti fornisce i record DNS (SPF, DKIM, ed eventualmente DMARC) da inserire. Lo stato diventa In verifica. Può capitare di trovare diversi record da pubblicare: è normale, la verifica per te resta una sola.
3. Aggiungi tutti i record DNS presso il tuo provider di dominio (Aruba, GoDaddy, Cloudflare…). Se un record è indicato come opzionale/consigliato (es. DMARC) e ne hai già uno sul dominio, lascia quello esistente.
4. Torna in JoeSMTP e clicca Istruzioni DNS per ri-controllare. Quando la propagazione è completata lo stato passa a Verificato.

Sistema, rimozione, riverifica

• Mittente di sistema: mostra il badge “di sistema”, è già verificato e utilizzabile subito (indirizzo smtp@joesmtp.it).
• Modificare il nome: usa Modifica per cambiare il nome visualizzato (quello che il destinatario vede come “Da”). L'email non è modificabile, perché è legata alla verifica DNS del dominio: per un altro indirizzo aggiungi un nuovo mittente. Il nuovo nome vale per le prossime campagne.
• Rimuovere: usa Rimuovi. L'operazione è bloccata se il mittente è usato da campagne attive.
• Riverifica: se cambia il provider di invio del progetto, i mittenti esistenti possono essere ri-registrati e riportati temporaneamente a “In verifica”.

Dashboard e statistiche

La voce Campagne (homepage) è il tuo cruscotto. In alto quattro indicatori aggregati su tutte le campagne inviate del progetto:

• Campagne inviate — totale storico
• Destinatari totali — con dettaglio dei consegnati
• Tasso apertura medio e Tasso click medio

Campagne inviate, pianificate e bozze

La tabella Campagne inviate elenca lo storico con colonne Nome, Sender, Inviata, Destinatari, Consegnate, Aperture, Click, Bounce, l'icona occhio per aprire il dettaglio e l'icona 📋 Duplica. Se presenti, le Campagne pianificate compaiono in una tabella separata, dove puoi Modifica, Duplicare o Annulla la programmazione.

Duplica una campagna (email o SMS) con l'icona 📋: viene creata una copia in bozza («Copia di …») e si apre il wizard già precompilato con contenuto, mittente e filtri della campagna originale. Puoi modificare tutto e poi inviare o programmare: l'originale non viene toccato e i destinatari sono ricalcolati dai filtri.

Più in basso, la tabella Bozze raccoglie le campagne mai avviate: il wizard salva una bozza a ogni passaggio, e qui le ritrovi tutte. Su ogni riga trovi Riprendi (riapre il wizard dal punto in cui eri), 📋 Duplica e 🗑 Elimina.

Eliminare una campagna. Il cestino compare sulle bozze e sulle campagne annullate o fallite. Le campagne già inviate non si eliminano: restano nello storico con le loro statistiche, perché documentano invii fatti e crediti consumati. Anche una campagna in invio non è eliminabile: attendi che finisca. L'eliminazione è definitiva e porta via anche la coda e l'elenco destinatari di quella campagna.

Creare una campagna

Da Nuova campagna parte un wizard in 4 passi. Naviga con Avanti e Indietro; la campagna viene salvata come bozza ad ogni passaggio, così puoi riprenderla quando vuoi.

1 · Dati

• Nome interno — solo per te, per ritrovare la campagna (es. “Newsletter Maggio”).
• Oggetto email — ciò che il destinatario legge in posta.
• Preheader (facoltativo) — l'anteprima di testo accanto all'oggetto.
• Mittente — scegli tra i mittenti verificati/attivi.

2 · Destinatari

Scegli il punto di partenza (tutti i contatti o una lista salvata) e aggiungi eventuali filtri sui campi, scegliendo se combinarli in tutte (AND) o almeno una (OR) delle condizioni. Clicca Aggiorna anteprima per vedere l'elenco e soprattutto il conteggio finale: “X destinatari corrispondono ai filtri” e i crediti necessari.

Editor e template

Il passo 3 · Editor è dove crei il contenuto. Due modalità:

• Editor visuale — l'editor drag-and-drop (Stripo) per costruire l'email senza scrivere codice.
• Incolla HTML — per chi ha già un HTML pronto (ha priorità sull'editor visuale).

Template

Nella sezione “Parti da un template” trovi i preset di sistema e i template salvati del tuo progetto. Con Salva come template conservi il contenuto attuale per riusarlo nelle prossime campagne.

Campi merge (personalizzazione)

Nel pannello “Campi disponibili” clicca un campo per inserirlo nel punto del cursore. Al momento dell'invio i segnaposto vengono sostituiti col dato reale: “Ciao {NOME}!” diventa “Ciao Mario!”.

Versione web del messaggio

Alcuni programmi di posta bloccano le immagini o scompaginano il layout. Per questo puoi offrire ai destinatari un link che apre la stessa email in una pagina web: il classico “Non vedi bene questo messaggio? Aprilo nel browser”.

È un campo facoltativo: si chiama [WEBVERSION_LINK] e lo trovi tra i Campi disponibili del passo contenuto (oppure lo puoi inserire nell'header/footer di progetto da Impostazioni → Aspetto email, così finisce in tutte le campagne). Se non lo usi, non cambia nulla.

• Come si usa: inseriscilo come indirizzo di un link (nell'editor visuale: seleziona il testo, crea il collegamento e incolla [WEBVERSION_LINK] come URL). Al momento dell'invio viene sostituito con l'indirizzo della pagina personale di quel destinatario.
• Un link per destinatario: ogni invio ha il suo indirizzo univoco, quindi la pagina mostra l'email già personalizzata (nome, campi merge, header e footer, esattamente come è stata ricevuta).
• Pagina pubblica: chi apre il link non deve fare login. L'indirizzo è un codice casuale non indovinabile e la pagina è esclusa dai motori di ricerca, ma tieni presente che chiunque riceva il link vede quel messaggio (compreso il link di disiscrizione al suo interno): non inserire dati riservati nelle email che vuoi rendere consultabili online.
• In anteprima il link compare ma non è ancora attivo: diventa reale solo con l'invio.

Invio e pianificazione

Il passo 4 · Riepilogo e invio mostra il recap (nome, oggetto, mittente, destinatari, crediti necessari/disponibili) e un'anteprima renderizzata su un destinatario campione, così verifichi i campi merge. L'anteprima è fedele all'invio: include automaticamente header, footer e link di disiscrizione del progetto (il link di disiscrizione mostrato è però solo un esempio, non funzionante fino all'invio reale).

Nella card Header e footer puoi scegliere, per questa campagna, cosa aggiungere. Gli interruttori compaiono solo se pertinenti: Header personale e Footer personale appaiono solo se li hai definiti in Impostazioni → Aspetto email, mentre Footer JoeSMTP compare solo se la fascia non è disattivata a livello di progetto. Gli interruttori personali partono attivi se hai usato l'editor visuale e spenti se hai incollato l'HTML (in quel caso di solito il template porta già il suo header/footer); la fascia JoeSMTP è invece proposta sempre attiva. L'anteprima si aggiorna a ogni scelta — e se togli la fascia JoeSMTP senza aver inserito [UNSUBSCRIBE_LINK], vedrai comparire il box minimo di disiscrizione, esattamente come nell'invio reale.

Invia subito o pianifica

• Invia subito — la campagna parte immediatamente. Servono crediti sufficienti per l'intero invio.
• Pianifica — scegli data e ora. Il controllo crediti avviene al momento dell'invio effettivo, quindi puoi programmare anche se ora i crediti non basterebbero (purché ci siano quando parte).

Premi Invia campagna per confermare.

Report e dettaglio

Dall'icona occhio apri il dettaglio della campagna: stato, oggetto, mittente, date, l'anteprima del contenuto inviato e le statistiche.

Più in basso, l'elenco paginato dei destinatari con lo stato riga per riga (Recapitato / Aperto / Click). Gli stati della campagna sono: Bozza Programmata In invio Inviata Annullata.

Creare una campagna SMS

Da Nuova campagna SMS parte un wizard in 3 passi (Dati → Destinatari → Riepilogo), simile a quello email ma pensato per gli SMS.

1 · Dati

• Nome interno — per ritrovare la campagna.
• Mittente — vedi sotto (max 11 caratteri).
• Testo SMS — il messaggio, con contatore caratteri/segmenti in tempo reale.

2 · Destinatari

Seleziona liste e filtri come per le email. Solo i contatti con un numero di telefono valido vengono inclusi: usa Aggiorna anteprima per vedere quanti sono e i crediti necessari.

Testo, segmenti e costi

Il costo di un SMS dipende dal numero di segmenti, calcolati in base alla lunghezza del testo:

Il sistema rileva automaticamente l'Unicode e ricalcola. Il costo mostrato è segmenti × costo per SMS, per destinatario. Ricorda: pool crediti unico con le email, indicativamente 1 SMS = 30 crediti (come 30 email).

Campi merge

Come per le email, puoi inserire segnaposto cliccando i campi disponibili: [NOME] [COGNOME] [AZIENDA] e i tuoi campi personalizzati. Vengono sostituiti all'invio.

Mittente, STOP e invio

Mittente SMS

Il mittente è un nome alfanumerico di massimo 11 caratteri. Deve contenere almeno una lettera e non può richiamare enti, banche, forze dell'ordine o brand noti. A differenza delle email non richiede verifica DNS.

Disiscrizione (STOP)

In fondo a ogni SMS viene aggiunto automaticamente il link di disiscrizione (“STOP sms” + link breve), unico per ogni destinatario, per rispettare le norme sulla privacy. Non serve inserirlo a mano.

Invio

Nel passo Riepilogo scegli Invia subito o Pianifica e conferma con Invia campagna SMS. Se i crediti non bastano per l'invio immediato, la piattaforma ti propone di programmarlo.

Cosa sono le automazioni

Una campagna normale parte subito o a una data che scegli tu. Un'automazione invece resta in attesa e parte da sola quando succede qualcosa: un nuovo iscritto, un compleanno, un click su una campagna precedente.

Si compone di due cose:

• un trigger — cosa fa entrare un contatto nel flusso;
• una sequenza di messaggi, ognuno con il proprio ritardo.

Ogni contatto percorre il flusso con il proprio orologio: se Mario si iscrive oggi e Anna fra tre settimane, ognuno riceve il primo messaggio al momento giusto per sé.

Ogni messaggio di un'automazione può essere una email o un SMS: la scelta è per singolo messaggio, quindi un flusso può anche alternarli (vedi Email o SMS).

Creare un'automazione

Vai su Automazioni e usa + Nuova automazione, oppure parti da una delle cinque ricette in fondo alla pagina, che precompilano il trigger:

• Benvenuto — un messaggio (o una serie) appena il contatto entra in rubrica;
• Compleanno / anniversario — ogni anno, in corrispondenza di una data del contatto;
• Follow-up campagna — a chi ha (o non ha) cliccato una campagna già inviata;
• Riattivazione inattivi — a chi non apre né clicca da un po' di tempo;
• Recupero carrello — parte su un evento del tuo software e si ferma da sola quando il contatto compra (vedi Fermare il flusso).

I trigger disponibili

Restringere il pubblico

Al trigger puoi aggiungere una lista o un segmento come punto di partenza e dei filtri sui campi, esattamente come nel wizard di una campagna. Un contatto entra solo se soddisfa sia il trigger sia i filtri.

Mentre configuri, in fondo alla finestra vedi quanti contatti entrerebbero con quella configurazione: è il modo più rapido per accorgersi di un trigger sbagliato (0 contatti) o troppo largo.

Fermare il flusso quando succede qualcosa

Nella sezione Comportamento c'è il campo Esci dal flusso se il contatto fa…: ci scrivi il nome di un evento che il tuo software segnala a JoeSMTP (lo stesso meccanismo del trigger Evento applicativo (API), vedi la sezione API). Chi compie quell'evento esce dal flusso entro pochi minuti e i messaggi che non sono ancora partiti vengono annullati.

È il modo di gestire il recupero carrello: tre solleciti a chi ha lasciato il carrello pieno, che devono smettere nel momento in cui la persona compra. Basta che il tuo sito mandi l'evento acquisto.

Il nome dell'evento va scritto identico a quello che manda il tuo software, maiuscole comprese: acquisto e Acquisto sono due eventi diversi.

• Contano solo gli eventi che arrivano dopo che il contatto è entrato nel flusso: quello che aveva fatto prima non lo fa uscire.
• L'evento di stop non può essere lo stesso che fa entrare i contatti: entrerebbero per uscire subito dopo.
• L'uscita compare nella tabella Chi è nel flusso con il motivo, così è sempre chiaro perché una persona ha smesso di ricevere i messaggi.

Attenzione a non confonderlo con la pausa dell'automazione: quella ferma i nuovi ingressi, ma i messaggi già in coda partono comunque. L'evento di stop invece li annulla, perché riguarda un fatto preciso di quella persona.

Un avvertimento sulle aperture

Le aperture sono un dato gonfiato: la protezione privacy di Apple Mail apre le email al posto dell'utente. Per far scattare decisioni automatiche i click sono molto più affidabili. Un flusso “non ha aperto” finirà per escludere anche persone che avevano letto.

Messaggi e ritardi

Apri l'automazione e usa + Aggiungi messaggio. Per ognuno indichi un nome interno (non lo vede il destinatario) e dopo quanto va inviato.

Il ritardo si conta dal messaggio precedente; per il primo, da quando il contatto entra nel flusso. Con ritardo 0 il messaggio parte appena possibile: se metti due messaggi di fila a 0, escono nello stesso controllo, uno subito dopo l'altro, non a distanza di minuti. Se cadono dentro un orario di silenzio aspettano comunque la fine della finestra.

Esempio di una serie di benvenuto: Benvenuto dopo 0 giorni, Come iniziare dopo 2 giorni, Offerta di prova dopo 5 giorni. Un contatto che entra il 1° del mese riceve i tre messaggi il 1°, il 3° e l'8°.

Email o SMS

Quando aggiungi un messaggio scegli anche il canale: Email oppure SMS. La scelta vale per quel singolo messaggio, quindi un flusso può essere tutto email, tutto SMS o misto — e anche il primo messaggio può essere un SMS.

Un caso tipico di flusso misto: email di benvenuto subito, e dopo tre giorni un SMS breve di promemoria a chi non ha ancora reagito.

• Un SMS costa molto più di una email: il costo per messaggio è scritto accanto alla voce SMS quando lo scegli.
• I contatti senza numero di telefono saltano i messaggi SMS e proseguono con i successivi: non escono dal flusso e non vanno in errore. Il dettaglio dell'automazione ti dice quanti sono.
• Sugli SMS non esistono aperture e click: nelle statistiche del flusso quei numeri riguardano solo i messaggi email.
• Il canale non si cambia dopo: se hai sbagliato, elimina il messaggio e ricrealo.

Gli orari di silenzio valgono per entrambi i canali, ma con gli SMS conviene sempre impostarli: una email notturna è una seccatura, un SMS notturno è un reclamo.

Comporre il contenuto

Con Componi si apre il normale editor delle campagne del canale scelto: per le email template, blocchi, HTML incollato, campi merge, header e footer funzionano esattamente come sempre; per gli SMS ritrovi testo, mittente, campi merge e contatore di caratteri. Cambiano solo due cose: non ci sono i destinatari (li decide il trigger) e non c'è la pianificazione (la decide il ritardo). Il pulsante finale è Salva contenuto.

Nella sequenza ogni messaggio mostra il suo stato: Pronto ha un contenuto, Da comporre è ancora vuoto. Finché c'è un messaggio da comporre l'automazione non può essere attivata.

Riordinare

Le frecce spostano un messaggio su o giù. Se ci sono già contatti dentro al flusso ti viene chiesta conferma: dopo il riordino riceveranno il messaggio che occupa la posizione in cui si trovano, non quello che stavano aspettando.

Attivare e mettere in pausa

Un'automazione appena creata è in pausa: non fa nulla. Con Attiva comincia a lavorare, ma solo dopo alcuni controlli:

• deve avere almeno un messaggio;
• ogni messaggio deve avere un contenuto;
• ogni messaggio deve avere un mittente: approvato per le email, indicato per gli SMS.

Attivare un'automazione non manda nulla ai contatti già in rubrica: arruola chi soddisfa il trigger da quel momento in poi. L'unica eccezione è il trigger “Ingresso in un segmento” con l'opzione che assorbe anche lo storico, e in quel caso la piattaforma te lo dice esplicitamente.

Mettere in pausa ferma i nuovi ingressi e gli avanzamenti. I messaggi già finiti in coda partono comunque: erano stati promessi al contatto e trattenerli lascerebbe sequenze a metà.

Orari di silenzio

Con Non inviare dalle … alle … eviti che un messaggio parta di notte: un invio che cadrebbe nella finestra viene spostato alla prima ora utile. Senza questa impostazione il benvenuto può arrivare alle 3 del mattino.

Rientrare nel flusso

Di norma ogni contatto percorre un'automazione una volta sola. Spuntando Un contatto può rientrare nel flusso può ripercorrerla: indispensabile per i compleanni (una volta all'anno) e per gli eventi che si ripetono.

Crediti

Ogni messaggio di un'automazione costa come la campagna dello stesso tipo: una email quanto una email, un SMS quanto un SMS (molto di più). Se i crediti finiscono, gli invii vengono rimandati (non persi né falliti): riprendono da soli quando ricarichi, senza buchi nella sequenza.

Chi è nel flusso

Nel dettaglio dell'automazione, la tabella Chi è nel flusso risponde alla domanda “perché a questa persona non è arrivato niente?”. Per ogni contatto vedi lo stato, quanti messaggi ha ricevuto, quando riceverà il prossimo e, se è uscito, il motivo.

Cronologia apre la sequenza completa degli eventi di quel contatto: quando è entrato, quali messaggi sono stati messi in coda, eventuali rinvii e il motivo dell'uscita. Il registro viene conservato 365 giorni.

Esci fa uscire subito un contatto dal flusso: non riceverà altri messaggi di quell'automazione.

Quanto tempo passa prima che parta?

Le automazioni vengono controllate ogni pochi minuti, non istantaneamente. Un ritardo di qualche minuto tra il momento previsto e l'invio effettivo è normale. Se dopo un quarto d'ora non è ancora successo nulla, controlla: l'automazione è attiva? i messaggi sono Pronti? il contatto è nella tabella degli iscritti? ci sono crediti? sei dentro un orario di silenzio?

Cosa sono i form di iscrizione

Un form è il modulo con cui le persone si iscrivono alle tue comunicazioni dal tuo sito. Lo costruisci qui, ottieni una riga di codice, la incolli nel sito: da quel momento chi si iscrive finisce dritto nella rubrica del progetto.

Puoi averne quanti vuoi, ognuno diverso: uno nel footer che chiede solo l'email, uno che si apre in popup sul blog e chiede anche il nome, uno dedicato a una campagna specifica che iscrive a una lista sua.

Il form vive dentro una cornice isolata ospitata sui nostri server. Vuol dire due cose pratiche: la grafica del tuo sito non può sballarne il layout, e quello che le persone digitano non passa mai dalle pagine del tuo sito.

Creare un form

Vai su Form e usa + Nuovo form: ti chiede solo un nome e dove deve apparire. Tutto il resto si imposta subito dopo, nell'editor, con l'anteprima accanto.

Il nuovo form nasce sospeso: puoi lavorarci con calma, il codice non mostra ancora niente nel sito. Quando è pronto, Attiva.

Scegliere i campi

Nella scheda Campi spunti quelli che il form deve chiedere. Puoi cambiare l'etichetta che vede il visitatore, aggiungere un segnaposto e decidere quali sono obbligatori.

L'email c'è sempre ed è sempre obbligatoria: è la chiave con cui il contatto viene riconosciuto. I campi disponibili sono quelli del progetto: se te ne serve uno che non c'è, crealo in Impostazioni › Campi e torna qui.

Meno campi chiedi, più persone completano. Se ti servono altre informazioni, valuta il layout a due passi: chiedi l'email in pagina e il resto dopo, quando l'iscrizione è già al sicuro.

Liste di destinazione

Puoi collegare il form a una o più liste: chi si iscrive ci entra automaticamente. È facoltativo — senza liste il contatto resta comunque in rubrica.

Compaiono solo le liste vere e proprie, non i segmenti: a un segmento non ci si iscrive, ci si finisce dentro soddisfacendone le condizioni.

In pagina o in popup

Quando si apre il popup

• Appena la pagina è pronta — il più invadente, usalo solo se sai cosa stai facendo;
• Dopo qualche secondo — l'impostazione predefinita (5 secondi);
• Dopo aver scrollato — scatta a una percentuale di pagina: chi è arrivato a metà articolo sta leggendo davvero;
• Quando sta per uscire — il puntatore esce dalla finestra. Sul telefono non esiste un gesto equivalente: lì ripiega su un'attesa;
• Al click su un elemento — apri il form quando clicca il tuo bottone «Iscriviti». Serve il selettore CSS dell'elemento: se non sai cos'è, chiedilo a chi cura il sito.

Non riproporlo per (giorni) evita di ripresentare il popup a chi l'ha già chiuso. Il valore predefinito è 7 giorni; a 0 riappare ogni volta, ed è il modo migliore per farsi odiare.

Aspetto

Nella scheda Aspetto imposti i testi (titolo, sottotitolo, bottone, messaggio di ringraziamento) e la grafica del riquadro: sfondo, colore del testo, colore di accento (il bottone), bordo, angoli, carattere, allineamento ed eventuale immagine di testa.

Le caselle di testo restano volutamente neutre, con un bordo grigio sottile, e non seguono i colori che scegli. Non è una dimenticanza: un campo che somiglia a tutti gli altri campi del web è un campo che le persone compilano senza pensarci. Quello che personalizzi è la cornice, non la casella in cui si scrive.

L'anteprima a destra non è una simulazione: è la pagina vera che vedranno i visitatori. Si aggiorna dopo ogni salvataggio.

Per il popup imposti anche la posizione (al centro, in un angolo in basso, o come fascia) e quanto scurire la pagina dietro.

Conferma via email (doppio opt-in)

Con la conferma attiva, chi si iscrive non entra subito: resta in attesa e riceve una email con un link da cliccare. Solo dopo il click diventa un contatto attivo e comincia a ricevere i tuoi messaggi.

Costa qualche iscritto in meno e regala una lista che funziona: restano fuori gli indirizzi digitati male, quelli finti e le iscrizioni fatte da qualcun altro al posto tuo.

Nell'attesa il contatto compare in rubrica con lo stato pending e non riceve nulla: né campagne, né automazioni.

Puoi personalizzare oggetto, mittente e corpo della mail di conferma. Il corpo deve contenere la scritta [CONFIRM_LINK]: è il punto in cui finisce il link di conferma, e senza di quello chi si iscrive non potrebbe mai confermare.

Metterlo nel sito

La scheda Codice contiene la riga da incollare nel sito. È tutto quello che serve: nessun foglio di stile da aggiungere, nessuna libreria da installare.

• per un form in pagina (o a due passi), incollalo dove vuoi che appaia;
• per un popup va bene ovunque, anche in fondo al modello di pagina.

Se il sito è fatto con WordPress, Shopify o simili, cerca il blocco «HTML personalizzato» o «codice»: è lì che va incollato.

Link diretto

Ogni form ha anche un link diretto: la stessa identica cosa, ma come pagina a sé. Utile in una chat, nella bio di un social o dietro un QR code — funziona anche se non hai un sito.

Siti autorizzati

In Comportamento puoi elencare i domini autorizzati a usare il form, uno per riga. Serve nel caso qualcuno copi il tuo codice e lo incolli altrove. Lasciando il campo vuoto non c'è nessun vincolo. Un dominio copre anche i suoi sottodomini.

Iscritti e prova del consenso

La scheda Iscrizioni elenca chi si è iscritto da quel form, con data, indirizzo IP e pagina di provenienza. Insieme al testo della casella di consenso che ha accettato, è la prova che quell'iscrizione c'è stata: conservala, è ciò che ti serve se qualcuno contesta di essere in lista.

Se in seguito cambi il testo del consenso, le iscrizioni già raccolte conservano quello di allora: era quello che avevano sotto gli occhi.

Eliminando un form, le iscrizioni raccolte restano, e i contatti restano in rubrica: il form era solo la porta da cui sono entrati.

Mandare un benvenuto

I contatti che arrivano da un form hanno provenienza form di iscrizione (la vedi nella loro scheda). Puoi usarla per far partire un messaggio automatico: crea un'automazione con trigger Nuovo contatto e origine Iscritto da un form.

Se il form usa la conferma via email, il benvenuto parte dopo la conferma: prima il contatto è in attesa, e le automazioni non toccano chi è in attesa.

Cosa sono i transazionali

I messaggi transazionali sono email o SMS inviati a un singolo destinatario tramite API, tipicamente da un tuo sistema in reazione a un evento: conferme d'ordine, reset password, codici OTP, notifiche di spedizione.

Registro e filtri

La voce Transazionali mostra il registro di tutti i messaggi inviati via API per il progetto (di default gli ultimi 7 giorni). Colonne: Data, Destinatario, Oggetto, Stato, Statistiche e l'icona di dettaglio.

Con Filtri restringi per intervallo di date, Canale (email/SMS) e Stato:

Inviate consegnate   In coda in attesa o in ritentativo   Fallite non recapitabili. La ricerca cerca su destinatario, numero e oggetto.

Dettaglio messaggio

L'icona di dettaglio apre tutte le informazioni del singolo messaggio: mittente, destinatari (incl. CC/BCC), oggetto, corpo HTML/testo, header personalizzati, ID messaggio, numero di tentativi, ultimo errore e le date di ogni evento (inviato, consegnato, aperto, cliccato, bounce).

Invio via API

I transazionali si inviano con due endpoint (vedi la sezione API per sviluppatori per l'autenticazione):

• POST /api/1.0/email-send — email transazionale. Il mittente (FROM_EMAIL) deve essere un mittente approvato del progetto; il destinatario viene aggiunto/aggiornato tra i contatti con flag transazionale.
• POST /api/1.0/sms-send — SMS transazionale. Nessuna verifica del mittente e nessun inserimento del contatto (se il numero esiste già, le statistiche vengono collegate).

Ogni invio consuma crediti come un'email/SMS di campagna. I log compaiono in tempo reale nella pagina Transazionali.

Come funzionano i crediti

I crediti sono l'unità di consumo degli invii, con pool unico per email e SMS. Le tariffe esatte sono sempre indicate in Impostazioni → Crediti (es. 1 email = 1 credito, 1 SMS = 30 crediti). Il saldo residuo è visibile anche in basso nella barra laterale.

Acquistare un pacchetto

In Impostazioni → Crediti, sezione Acquista pacchetto, ogni pacchetto mostra crediti, prezzo e quante email o SMS ci puoi fare.

1. Clicca Acquista sul pacchetto scelto.
2. Inserisci/conferma i dati di fatturazione (se non già salvati).
3. Ricevi le istruzioni per il bonifico (intestatario, IBAN, causale).
4. Alla conferma del pagamento i crediti vengono accreditati e ricevi la ricevuta.

Lo Storico acquisti elenca data, pacchetto, crediti, importo, metodo e stato: In attesa Confermato Rifiutato.

Nello storico puoi trovare anche righe con metodo Omaggio e importo € 0,00: sono crediti regalati dal gestore della piattaforma. Si sommano al saldo e valgono 12 mesi come quelli acquistati.

Scadenza dei crediti

I crediti sono validi 12 mesi dall'accredito. Gli invii consumano prima i crediti più vicini alla scadenza. La sezione Prossima scadenza evidenzia quanti crediti stanno per scadere e quando (in rosso se ≤15 giorni, arancione se ≤60), e la tabella Crediti per scadenza mostra ogni lotto con origine e data.

Dati di fatturazione

In Impostazioni → Fatturazione imposti l'intestazione della ricevuta emessa ad ogni acquisto. I dati vengono riusati per gli acquisti successivi.

• Tipo intestatario: Azienda/Ente oppure Persona fisica.
• Intestatario / Ragione sociale, Indirizzo, CAP, Città — obbligatori.
• Codice fiscale e/o Partita IVA — ne serve almeno uno.
• Email per la ricevuta — se vuota, si usa quella dell'account.

Profilo e password

In Impostazioni:

• Profilo — aggiorna Nome, Cognome ed Email dell'account (l'email deve essere univoca), poi Salva.
• Password — inserisci password attuale, nuova (min. 8 caratteri) e conferma, poi Aggiorna password.

Panoramica Impostazioni

La pagina Impostazioni raccoglie in schede tutto ciò che riguarda il progetto attivo e l'account:

Panoramica e autenticazione

Ogni progetto ha credenziali API proprie per integrazioni con i tuoi sistemi (CRM, e-commerce, form). Le trovi in Impostazioni → API: Client ID e Client Secret.

Come si autentica una chiamata

1. Chiama POST /api/1.0/auth con Client ID e Secret.
2. Ottieni un access token (Bearer) valido per una durata limitata (indicata nella pagina API).
3. Usa l'header Authorization: Bearer <token> nelle chiamate successive; alla scadenza richiedi un nuovo token.

Endpoint e Swagger

I parametri del contatto e dei messaggi si scrivono in MAIUSCOLO, come i merge tag (es. EMAIL, NOME, TELEFONO).

Far scattare (o fermare) un'automazione dal tuo software

Con POST /api/1.0/evento comunichi che è successo qualcosa. Lo stesso evento può avviare o fermare un flusso, a seconda di come hai configurato le automazioni:

• i flussi con trigger Evento applicativo (API) e quel nome arruolano il contatto;
• i flussi che indicano quel nome come evento di stop ne fanno uscire chi è già dentro, annullando i messaggi non ancora spediti (vedi Fermare il flusso).

In entrambi i casi l'effetto arriva entro pochi minuti. Servono due campi: EMAIL (se il contatto non esiste viene creato) e EVENTO, il nome che hai scritto nell'automazione — il confronto è esatto, maiuscole comprese. Puoi allegare un oggetto DATI: viene conservato per riferimento ma non influisce su chi entra o esce dal flusso; per restringere il pubblico si usano i filtri dell'automazione.

La risposta è 202: l'evento è stato preso in carico, l'eventuale invio avviene dopo. Non è un endpoint di invio: per mandare una singola email usa email-send.

Apri la documentazione API (Swagger) →

Privacy, cookie e documenti legali

Nel gruppo Privacy e cookie del menu laterale trovi i documenti sempre consultabili:

Consenso ai cookie

Al primo accesso compare un banner cookie. I cookie tecnici e funzionali (necessari a login e navigazione) sono sempre attivi; gli altri partono solo dopo il tuo consenso, per categoria:

Domande frequenti

“Nessun mittente approvato”: cosa faccio?

Devi verificare almeno un mittente. Vai in Impostazioni → Mittenti, aggiungilo e completa la verifica DNS, oppure usa il mittente di sistema per le prime prove. Vedi Aggiungere e verificare.

Non ho crediti sufficienti per inviare subito

Puoi pianificare la campagna: il controllo dei crediti avviene al momento dell'invio. In alternativa acquista un pacchetto in Impostazioni → Crediti.

La campagna dice “nessun destinatario”

I filtri o la lista di partenza non raggiungono alcun contatto. Allarga i criteri nel passo Destinatari. Per gli SMS ricorda che servono contatti con telefono valido.

Le statistiche di apertura/click sono a zero o “N/A”

Servono gli eventi di tracciamento (webhook). Se non sono configurati, la piattaforma non riceve aperture/click. Per gli SMS queste metriche non esistono per natura del canale.

Ho disiscritto un contatto per errore

Puoi riportarlo ad Attivo una sola volta dalla scheda del contatto. Dopo la riattivazione lo stato resta bloccato. Vedi Stati e disiscrizione.

Ho eliminato un contatto: è perso?

No: l'eliminazione è un soft-delete. Re-importando la stessa email il contatto viene riattivato con i dati precedenti.