Email e SMTP
Configura l'invio delle email transazionali dal tuo dominio con SMTP, SPF, DKIM e DMARC, e gestisci bounce e deliverability.
Blu Pantheon invia email transazionali: inviti alla Console, reimpostazione password, conferme di prenotazione, promemoria, riepiloghi di conversazione e notifiche di sistema. Puoi lasciare l'invio all'infrastruttura predefinita oppure usare il tuo server SMTP, così che i messaggi partano dal tuo dominio e siano coerenti con la tua identità aziendale.
Prima di iniziare
- Ruolo Amministratore tenant oppure permesso config:integrations:write
- Accesso alla gestione DNS del dominio da cui vuoi inviare
- Credenziali del server SMTP (host, porta, utente, password)
- Un indirizzo mittente dedicato, es. noreply@acme.it
Modalità di invio disponibili
| Modalità | Mittente | Quando usarla |
|---|---|---|
| Infrastruttura Blu Pantheon | noreply@notifiche.blupantheon.com | Avvio rapido, nessuna configurazione DNS |
| Dominio verificato con delega | noreply@acme.it | Vuoi il tuo dominio senza gestire un server SMTP |
| SMTP proprio | noreply@acme.it | Policy aziendale che impone il transito dal tuo relay |
Quale scegliere
Se non hai vincoli, la delega del dominio è la scelta migliore: mantieni il tuo mittente senza gestire un server. L'SMTP proprio è necessario solo se la tua organizzazione impone che tutta la posta transiti da un relay controllato.
Verifica del mittente
Aggiungi il dominio
Premi Aggiungi dominio e inserisci acme.it. La Console genera i record DNS da pubblicare.
Pubblica i record DNS
Copia i record nella zona DNS del dominio. Se non gestisci tu il DNS, inoltrali al tuo fornitore o all'ufficio IT: sono record di sola pubblicazione, non modificano la posta in arrivo.
Attendi la propagazione
Di norma bastano pochi minuti, in casi limite fino a 48 ore, in funzione del TTL impostato.
Avvia la verifica
Premi Verifica adesso. Lo stato passa a Verificato quando tutti i record sono corretti. In caso di errore la Console indica quale record manca o non corrisponde.
Imposta il mittente predefinito
Seleziona noreply@acme.it come mittente e assistenza@acme.it come indirizzo di risposta.
Non usare un mittente che non controlli
Impostare come mittente un dominio di cui non gestisci il DNS fa finire i messaggi nella posta
indesiderata o li fa rifiutare del tutto. Indirizzi come @gmail.com o @libero.it come
mittente sono sempre da evitare.
Configurazione SMTP
| Variabile | Obbligatoria | Default | Descrizione | Esempio |
|---|---|---|---|---|
SMTP_HOST | Sì | — | Nome host del server SMTP. Non indicare il protocollo né la porta. | smtp.acme.it |
SMTP_PORT | Sì | 587 | Porta di connessione. 587 con STARTTLS è la scelta consigliata; 465 usa TLS implicito. | 587 |
SMTP_SECURE | No | starttls | Modalità di cifratura: starttls per la porta 587, ssl per la porta 465. La porta 25 in chiaro non è ammessa. | starttls |
SMTP_USER | Sì | — | Utenza di autenticazione sul server SMTP. | noreply@acme.it |
SMTP_PASSWORD | Sì | — | Password o token applicativo. Viene cifrata e non è più visibile dopo il salvataggio. | password applicativa dedicata |
SMTP_FROM_ADDRESS | Sì | — | Indirizzo mittente. Deve appartenere a un dominio verificato. | noreply@acme.it |
SMTP_FROM_NAME | Sì | — | Nome visualizzato accanto al mittente. | ACME Assistenza |
SMTP_REPLY_TO | No | — | Indirizzo a cui arrivano le risposte degli utenti. Consigliato: una casella presidiata. | assistenza@acme.it |
SMTP_TIMEOUT_MS | No | 10000 | Timeout di connessione in millisecondi. | 10000 |
SMTP_POOL_SIZE | No | 5 | Connessioni simultanee verso il server. Riducilo se il relay applica limiti stringenti. | 5 |
Porta 587 oppure 465
Usa la 587 con STARTTLS: è lo standard per l'invio autenticato ed è supportata da tutti i fornitori. La 465 con SSL implicito è un'alternativa valida se il tuo relay non espone la 587. La porta 25 non è utilizzabile: è riservata al transito fra server ed è bloccata dalla maggior parte delle reti cloud.
Record DNS
Pubblica i tre record seguenti sulla zona di acme.it. Sostituisci i valori di esempio con
quelli generati nella tua Console.
SPF
Autorizza i server che possono inviare posta per conto del tuo dominio.
Nome: acme.it
Tipo: TXT
TTL: 3600
Valore: "v=spf1 include:spf.blupantheon.com include:_spf.acme.it -all"Un solo record SPF per dominio
Se hai già un record SPF non aggiungerne un secondo: unisci le direttive nell'unico record
esistente. Due record SPF sullo stesso nome rendono la valutazione non conforme e la posta
viene rifiutata. Attenzione anche al limite di 10 ricerche DNS: troppi include
invalidano il record.
DKIM
Firma crittograficamente i messaggi, dimostrando che non sono stati alterati in transito.
Nome: bp2026._domainkey.acme.it
Tipo: TXT
TTL: 3600
Valore: "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxK7pQ2vZ9nF3tR6mWq8Lh4YcJ1dEbN0sPfGvHkT5uXaOiC2wRl8ZyMnBpQdVsA7eKgTxU9jFwHrIm4NcOb1YvDlEqSt0ZgPaMxKcRuJnW5HfXbTyLoQeVpAdIiGkBsNmCzUwRlYpOxHvTqEfJaKdSbMnGuIwZcVtLrPyXeQdBfAoHkNmTsUvRiCgYxJlEpQwZaDbMcNfTvHrKuIoSyXgLqBeAdPnRwMvTkCzYiJfHxUqEbGaLsOdNpQrVmWtXcYeZgAhBiCjDkElFmGnHoIpJqKrLsMtNuOvPwQxRySzT0U1V2W3X4Y5Z6a7b8c9QIDAQAB"Il valore reale è generato dalla Console ed è specifico del tuo tenant. Il selettore
(bp2026) cambia a ogni rotazione della chiave: ne verrai avvisato con 30 giorni di anticipo.
DMARC
Indica ai server riceventi come comportarsi con i messaggi che non superano SPF e DKIM, e dove inviare i rapporti.
Nome: _dmarc.acme.it
Tipo: TXT
TTL: 3600
Valore: "v=DMARC1; p=none; rua=mailto:dmarc@acme.it; ruf=mailto:dmarc@acme.it; fo=1; adkim=r; aspf=r; pct=100"Nome: _dmarc.acme.it
Tipo: TXT
TTL: 3600
Valore: "v=DMARC1; p=quarantine; pct=25; rua=mailto:dmarc@acme.it; adkim=s; aspf=s"Nome: _dmarc.acme.it
Tipo: TXT
TTL: 3600
Valore: "v=DMARC1; p=reject; rua=mailto:dmarc@acme.it; adkim=s; aspf=s"Parti da p=none
Per almeno 2 settimane raccogli i rapporti senza bloccare nulla. Servono a scoprire quali sistemi inviano email a tuo nome: gestionali, newsletter, sistemi di firma digitale.
Analizza i rapporti aggregati
Verifica che tutte le fonti legittime superino SPF o DKIM. Correggi le configurazioni mancanti prima di procedere.
Passa a p=quarantine con pct ridotto
Inizia con pct=25, poi 50, poi 100, monitorando i rapporti a ogni passaggio.
Arriva a p=reject
Solo quando nessuna fonte legittima fallisce l'allineamento. È il livello che protegge effettivamente il tuo dominio dallo spoofing.
Non passare direttamente a p=reject
È l'errore più costoso: blocca immediatamente tutte le email legittime inviate da sistemi non ancora configurati, incluse fatture, ordini e comunicazioni contrattuali. La progressione graduale è obbligatoria nella pratica.
Test di invio
Verifica la connessione
Il pulsante Verifica connessione apre una sessione verso il server, negozia TLS e autentica le credenziali senza inviare messaggi. Se fallisce qui, il problema è nella configurazione SMTP.
Invia a un indirizzo di prova
Indica un indirizzo su un fornitore esterno, per esempio una casella personale su un dominio diverso dal tuo: la posta interna spesso non applica i controlli SPF e DKIM e maschera i problemi.
Controlla le intestazioni del messaggio ricevuto
Nel messaggio ricevuto verifica che compaiano spf=pass, dkim=pass e dmarc=pass.
Prova un'email reale del sistema
Invia un invito a un utente di prova e verifica che arrivi, che il mittente sia corretto e che il collegamento funzioni.
dig +short TXT acme.it
dig +short TXT bp2026._domainkey.acme.it
dig +short TXT _dmarc.acme.itGestione dei bounce
| Tipo | Significato | Comportamento della piattaforma |
|---|---|---|
| Hard bounce | Indirizzo inesistente o dominio non valido | L'indirizzo è sospeso immediatamente, nessun nuovo invio |
| Soft bounce | Casella piena, server temporaneamente non disponibile | Fino a 5 tentativi in 24 ore, poi sospensione temporanea |
| Reclamo per spam | L'utente ha segnalato il messaggio | Sospensione immediata e permanente |
| Rifiuto per policy | Bloccato da regole del destinatario | Registrato, nessun nuovo tentativo automatico |
| Timeout | Nessuna risposta dal server | Ritentativo con attesa crescente |
Un indirizzo sospeso non riceve più email finché non viene riabilitato manualmente:
Individua l'indirizzo nell'elenco
Filtra per Sospesi e cerca l'indirizzo.
Verifica il motivo
Il dettaglio riporta il codice SMTP restituito dal server ricevente e il messaggio originale.
Correggi la causa
Se l'indirizzo è errato, correggilo nell'anagrafica del contatto. Se la casella era piena, attendi la conferma dell'utente.
Riabilita l'indirizzo
Premi Riabilita. L'operazione è tracciata nell'audit log.
Non riabilitare gli indirizzi che hanno segnalato spam
Continuare a inviare a chi ha segnalato il messaggio danneggia gravemente la reputazione del tuo dominio e mette a rischio il recapito di tutte le altre email.
Template delle email di sistema
| Modello | Quando viene inviato | Personalizzabile |
|---|---|---|
| Invito alla Console | Un amministratore invita un nuovo utente | Sì |
| Reimpostazione password | L'utente richiede il recupero | Testo sì, collegamento no |
| Verifica dell'indirizzo email | Alla prima attivazione | Testo sì |
| Codice di accesso MFA di riserva | Su richiesta di codici di recupero | No |
| Conferma di prenotazione | Prenotazione confermata | Sì |
| Promemoria appuntamento | Secondo l'anticipo configurato | Sì |
| Disdetta della prenotazione | Annullamento | Sì |
| Riepilogo della conversazione | Chiusura sessione, se attivo | Sì |
| Notifica di handover non gestito | Nessun operatore disponibile | Sì |
| Avviso di superamento quota | Soglia di consumo raggiunta | No |
| Notifica di sicurezza | Accesso da nuovo dispositivo, modifica password | No |
Elementi personalizzabili: logo, colori di intestazione e pulsanti, oggetto, corpo del testo, piè di pagina con i dati societari, lingua predefinita.
Variabili disponibili nei modelli:
{{tenant.name}} Ragione sociale del tenant
{{user.firstName}} Nome del destinatario
{{user.lastName}} Cognome del destinatario
{{user.email}} Indirizzo email del destinatario
{{action.url}} Collegamento dell'azione principale
{{action.expiresAt}} Scadenza del collegamento
{{booking.service}} Prestazione prenotata
{{booking.datetime}} Data e ora dell'appuntamento
{{booking.location}} Sede
{{booking.reference}} Codice della prenotazione
{{support.email}} Indirizzo di assistenza configuratoAnteprima e invio di prova
Ogni modello ha un pulsante Anteprima con dati fittizi e un pulsante Invia a me: verifica sempre su un client reale prima di pubblicare, perché la resa varia molto fra Outlook, Gmail e i client mobili.
Buone pratiche di recapito
- Riscalda gradualmente un dominio nuovo: parti da volumi bassi e aumenta nell'arco di 2 o 3 settimane.
- Mantieni un indirizzo di risposta presidiato: i domini che inviano solo da caselle non monitorate hanno una reputazione peggiore.
- Oggetti chiari e non ingannevoli: evita maiuscole eccessive, punti esclamativi multipli e termini tipici dello spam.
- Rapporto testo/immagini equilibrato: le email composte da una sola immagine finiscono spesso nella posta indesiderata.
- Includi sempre la versione testuale oltre a quella HTML: la piattaforma la genera automaticamente, non disattivarla.
- Pulisci le liste: rimuovi periodicamente gli indirizzi che non aprono e quelli sospesi.
- Monitora i rapporti DMARC almeno mensilmente, anche dopo aver raggiunto
p=reject. - Non superare i limiti del tuo relay: riduci
SMTP_POOL_SIZEse vedi errori di limite.
Risoluzione dei problemi
| Errore | Causa | Rimedio |
|---|---|---|
| Connessione rifiutata | Host o porta errati, firewall | Verifica host e porta, autorizza le connessioni in uscita |
| Autenticazione fallita | Credenziali errate o MFA sull'utenza | Usa una password applicativa dedicata, non le credenziali personali |
| Errore di certificato | Certificato scaduto o autofirmato | Rinnova il certificato del relay; i certificati non validi non sono accettati |
| Timeout | Server lento o irraggiungibile | Aumenta SMTP_TIMEOUT_MS, verifica la raggiungibilità del relay |
| STARTTLS non supportato | Server senza cifratura | Non utilizzabile: la cifratura è obbligatoria |
Verifica l'allineamento di SPF, DKIM e DMARC
Nelle intestazioni del messaggio ricevuto devono comparire tutti e tre con esito pass.
Un solo fallimento è sufficiente a peggiorare la classificazione.
Controlla la reputazione del dominio mittente
Verifica che il dominio o l'IP del relay non compaiano in liste di blocco pubbliche.
Rivedi il contenuto
Riduci il numero di collegamenti, evita accorciatori di URL, bilancia testo e immagini.
Verifica il volume
Un picco improvviso da un dominio nuovo è un segnale sospetto per i filtri. Distribuisci gli invii nel tempo.
Controlla nell'ordine: elenco dei recapiti non riusciti in Console; cartella della posta indesiderata del destinatario; eventuali regole di quarantena del server aziendale del destinatario; correttezza dell'indirizzo. Se l'invito risulta inviato ma non recapitato, il problema è a valle: chiedi al destinatario di verificare la quarantena del proprio sistema. Puoi comunque reinviare l'invito o copiare il collegamento e trasmetterlo per altra via. Vedi Problemi di accesso.
- Valore troncato: molti pannelli DNS spezzano i record TXT lunghi. Verifica che il valore pubblicato sia integro, eventualmente suddiviso in stringhe concatenate fra virgolette.
- Nome del record errato: deve essere
bp2026._domainkey.acme.it. Alcuni pannelli aggiungono automaticamente il dominio: in quel caso inserisci solobp2026._domainkey. - Virgolette duplicate: alcuni pannelli le aggiungono da soli. Un valore con doppie virgolette non è valido.
- Propagazione non completata: attendi la scadenza del TTL precedente.
Di norma indica un limite di frequenza imposto dal relay o dal destinatario. Riduci
SMTP_POOL_SIZE, verifica i limiti orari del tuo fornitore SMTP e controlla se il picco
coincide con un invio massivo. Se il problema riguarda un solo dominio destinatario, è probabile
un blocco temporaneo lato loro: attendi e riprova con volumi ridotti.