Questa è una guida di #spiegazione che discute come gli amministratori possono risolvere i problemi relativi all’invio di email da un sito Discourse.
Livello utente richiesto: Amministratore
Discourse si affida pesantemente alle email per le notifiche agli utenti e le attività di gestione dell’account. Se gli utenti non riescono a ricevere email dal tuo sito Discourse, ciò può portare a una varietà di problemi, inclusi messaggi persi e difficoltà nella gestione degli account.
Riepilogo
In questa documentazione imparerai:
- Come controllare i log delle email inviate
- Come investigare le email saltate e quelle con errore di consegna (bounced)
- Passaggi comuni di risoluzione dei problemi per le questioni di consegna delle email
- Impostazioni chiave e dove trovarle
Controllo delle Email Inviate
Il primo posto da controllare quando si risolvono problemi relativi alle email è la pagina Admin → Emails → Sent del tuo sito (situata in .../admin/email/sent). La pagina Emails → Sent in Discourse è una risorsa preziosa per gli amministratori per monitorare e risolvere i problemi relativi alla funzionalità di invio email del loro forum. Questa pagina fornisce un registro dettagliato di tutte le email inviate con successo dalla tua istanza di Discourse.
Ecco tutte le informazioni che puoi trovare sulle email inviate in questa pagina:
- Sent At: Quanto tempo fa è stata inviata l’email.
- User: L’utente che ha ricevuto l’email.
- To Address: L’indirizzo email del destinatario.
- Email Type: Il tipo di email inviata. Potrebbe essere un riassunto (digest), una mailing list, un post utente, un messaggio privato utente, ecc.
- Reply Key: Un identificativo univoco per ogni email inviata. Questa chiave garantisce che quando un utente risponde a un’email di notifica, Discourse possa correttamente associare la risposta al post e all’utente appropriati, permettendo agli utenti di partecipare alle discussioni del forum direttamente dalla loro email.
- Post: L’ID del post da cui è stata generata l’email. Cliccando su questo ID verrai reindirizzato al post effettivo nel forum.
- SMTP Details: Questo campo indica la risposta ricevuta dal server SMTP dopo il tentativo di invio dell’email. Una risposta
250 2.0.0significa che l’email è stata accettata per la consegna dal primo server di posta (il relay in uscita).
Se un utente segnala di non aver ricevuto un’email da Discourse e Discourse mostra un messaggio
250 2.0.0 Ok: queued as ...sotto i suoiPost & SMTP Details, potresti voler chiedere all’utente di controllare nuovamente la propria casella di posta in arrivo, insieme alla cartella spam, per vedere se ha perso le email. Questo stato indica che l’email è stata accettata dal primo server di posta, ma non garantisce la consegna alla casella di posta finale. L’email potrebbe ancora essere filtrata, ritardata o scartata dai server successivi.Potresti anche raccomandare all’utente di contattare il team di supporto o il dipartimento IT che gestisce il suo server di posta per vedere se sono a conoscenza di eventuali problemi che potrebbero verificarsi con l’email dopo che è stata segnalata come accodata. Se hai accesso ai log del tuo server di posta in uscita (o se sei su un’infrastruttura ospitata da Discourse), puoi utilizzare l’ID di coda mostrato nei dettagli SMTP per tracciare il percorso dell’email attraverso la catena di consegna.
Se un’email non appare nella pagina Emails → Sent in Discourse, significa che l’email non è stata inviata con successo dalla tua istanza di Discourse.
Diamo un’occhiata ad alcune delle altre pagine che possiamo utilizzare per la risoluzione dei problemi relativi alle email.
Investigazione delle Email Saltate
Situata nella pagina .../admin/email/skipped del tuo sito, la pagina Skipped Emails elenca tutte le email che Discourse ha deciso di non inviare per vari motivi. Ogni email saltata avrà un Skip Reason elencato accanto ad essa, fornendo indicazioni sul motivo per cui l’email non è stata inviata.
Le seguenti informazioni sono disponibili in questa pagina riguardo alle email saltate:
- Time: La data e l’ora in cui l’email avrebbe dovuto essere inviata ma è stata invece saltata.
- User: L’utente che avrebbe dovuto ricevere l’email.
- To Address: L’indirizzo email del destinatario.
- Email Type: Il tipo di email saltata, come
digest,mailing list,user posted,user private message, ecc. - Skip Reason: Il motivo per cui l’email è stata saltata. I motivi comuni includono il fatto che l’utente è attivo sul sito, l’utente ha già letto un post o l’utente ha superato la soglia del punteggio di rimbalzo (bounce score).
Exceeded bounce_score_threshold?
In Discourse, ogni volta che un’email inviata all’indirizzo email di un utente rimbalza, il «punteggio di rimbalzo» (bounce score) dell’utente aumenta. Il «punteggio di rimbalzo» è una misura del numero di tentativi di consegna falliti per le email inviate a un indirizzo specifico.
Il messaggio Exceeded bounce_score_threshold in Discourse si riferisce alla situazione in cui il «punteggio di rimbalzo» di un utente supera un certo limite ed è uno dei motivi più comuni per cui è necessario risolvere i problemi relativi all’invio di email da Discourse.
Un’email con errore di consegna (bounced) è un’email che non è stata consegnata al destinatario ed è stata restituita al mittente. Ciò può accadere per una varietà di motivi e, quando ciò avviene, il sistema di posta del mittente riceve una notifica sul problema di consegna.
Esistono due tipi di errori di consegna delle email:
- Hard Bounce: Si tratta di un fallimento permanente della consegna. Di solito accade quando l’indirizzo email del destinatario non è valido o non è più in uso. Altri motivi potrebbero essere che il nome di dominio non esiste o che il server di posta del destinatario ha bloccato completamente la consegna.
- Soft Bounce: Si tratta di un problema temporaneo di consegna. Potrebbe essere dovuto alla casella di posta del destinatario piena, al server di posta temporaneamente down o sovraccarico, o al messaggio email troppo grande.
bounce_score_threshold?
Sì! Vedi: Impostazioni del sito per il punteggio di rimbalzo.
Tuttavia, è importante assicurarsi che eventuali problemi sottostanti relativi alla consegna delle email siano completamente risolti prima di modificare le impostazioni del punteggio di rimbalzo.
Tenendo presente ciò, discutiamo di alcune delle altre informazioni che possiamo vedere riguardo alle email con errore di consegna in Discourse.
Risoluzione dei problemi delle email con errore di consegna (Bounced)
La pagina delle email con errore di consegna si trova in .../admin/email/bounced e fornisce una panoramica dettagliata di tutte le email con errore di consegna. Ecco cosa puoi vedere in questa pagina riguardo alle email con errore di consegna:
- Time: La data e l’ora in cui l’email ha generato un errore di consegna.
- User: L’utente che avrebbe dovuto ricevere l’email.
- To Address: L’indirizzo email del destinatario.
- Email Type: Il tipo di email che è stata saltata. Potrebbe essere un riassunto (digest), una mailing list, un post utente, un messaggio privato utente, ecc.
Nella pagina Bounced, puoi fare clic sull’icona (i) per visualizzare ulteriori dettagli su un’email con errore di consegna:
La finestra Incoming Email Details conterrà informazioni dettagliate sull’email con errore di consegna e, tipicamente, la sezione Body fornirà una spiegazione del motivo per cui l’email ha generato un errore di consegna.
Ecco alcuni motivi per cui un’email da Discourse potrebbe generare un errore di consegna:
- Indirizzo email non valido: Se l’indirizzo email del destinatario non è valido, non esiste o è stato eliminato, l’email rimbalzerà indietro.
- Casella di posta piena: Se la casella di posta del destinatario è piena e non può accettare nuovi messaggi, l’email rimbalzerà indietro.
- Problemi del server: Se il server di posta del destinatario è down o temporaneamente non disponibile, l’email rimbalzerà indietro. Di solito si tratta di un problema temporaneo.
- Mittente bloccato: Il server di posta del destinatario potrebbe aver bloccato il tuo indirizzo email di Discourse o potrebbe accettare solo email in arrivo da domini specifici, tipicamente a causa di politiche di sicurezza delle email.
- Filtri antispam aggressivi: Se il contenuto dell’email viene segnalato come spam dal server di posta del destinatario, l’email può rimbalzare indietro.
- Risposta automatica: Alcuni sistemi di risposta automatica (come le risposte fuori sede) possono causare un soft bounce.
In questa situazione, la migliore opzione è che l’utente le cui email stanno generando errori di consegna contatti il proprio provider di servizi di posta elettronica. Il provider di servizi di posta elettronica potrebbe essere in grado di fornire informazioni specifiche sul motivo per cui le email vengono bloccate, rifiutate, ecc. e potrebbe essere in grado di modificare le impostazioni di sicurezza o inserire in whitelist il servizio email di Discourse. Potrebbero anche essere a conoscenza di una manutenzione in corso del server di posta o di altri problemi che causano il rimbalzo delle email.
Se l’utente ha il controllo sui propri servizi di posta elettronica e sta utilizzando Microsoft Hosted Exchange o Google Workspace, abbiamo anche procedure per Bypassare lo spam per le email dal tuo sito ospitato da CDCK in Microsoft Hosted Exchange e Bypassare lo spam per le email dal tuo sito ospitato da Discourse in Google Workspace.
Dovrai oppure Ripristinare il punteggio di rimbalzo dell’utente, o se il problema stava interessando più utenti puoi Ripristinare in blocco i punteggi di rimbalzo per tutti gli utenti. Una volta ripristinati i punteggi di rimbalzo, Discourse riprenderà a tentare la consegna delle email agli utenti che stavano superando la loro bounce_score_threshold.
Passaggi aggiuntivi
La configurazione e la risoluzione dei problemi relativi alle email possono essere complesse a causa delle molte variabili coinvolte. Oltre a esaminare la sezione Admin → Email del tuo sito per risolvere i problemi relativi alle email, potresti anche voler consultare la nostra Checklist per la configurazione della consegna delle email se hai ancora difficoltà a determinare perché le email non vengono consegnate correttamente dal tuo sito Discourse.
Se il tuo sito Discourse è stato configurato di recente, abbiamo anche una guida su Risoluzione dei problemi relativi alle email su una nuova installazione di Discourse (solo per installazioni self-hosted).
Infine, puoi controllare la pagina dei log di Discourse navigando in Admin > Logs (.../logs/) e cercando eventuali errori relativi alla consegna delle email che potresti vedere.
