Vai al contenuto principale
— Guida alla configurazione

Monitora lo stato di consegna delle email

Alva Digital Downloads registra ogni email di consegna inviata nella tabella EmailLog e la mostra sulla pagina di dettaglio ordine nell'admin. Ogni voce registra oggetto, destinatario, timestamp di invio e la risposta del provider — ID messaggio Postmark in caso di successo, o un codice di errore quando un invio fallisce.

Dove visualizzare lo stato di consegna

Il log email risiede su ogni ordine, non come feed globale. Apri l'ordine per vedere ogni email che Alva ha tentato.

1. Apri l'ordine nell'admin Alva

Nell'admin Alva, clicca Ordini, poi clicca il numero dell'ordine da ispezionare.

2. Scorri fino alla sezione Cronologia email

Sotto le card cliente e prodotto, trova la card Cronologia email. Il badge a destra mostra il conteggio totale, es. 2 email inviate.

Screenshot necessario

Pagina di dettaglio ordine con la card Cronologia email visibile. Mostra l'intestazione della sezione, il badge di conteggio e il chevron per espandere. Nessun dato cliente reale visibile.

La card Cronologia email sulla pagina di dettaglio ordine.

3. Espandi per vedere ogni voce

Clicca il chevron sulla card. Ogni riga mostra il timestamp di invio, il destinatario, il badge di stato (verde per successo, rosso per fallito, ambra per in attesa o bounced) e il tipo di email — Link di download, Reinvio manuale o Consegna chiave di licenza.

4. Ispeziona la risposta del provider

L'ID messaggio Postmark, il codice e il messaggio di errore sono memorizzati in metadata sulla riga del log — inoltra quei valori al supporto se un invio richiede approfondimento.

Screenshot necessario

Una singola riga del log email espansa, che mostra timestamp, destinatario, badge di stato, badge di tipo e il blocco metadata con l'ID messaggio del provider. Nessun dato cliente reale visibile.

Una riga del log espansa che mostra la risposta di Postmark.

Cosa significano i valori di stato

  • SUCCESS — Postmark ha accettato l'email ed è in viaggio verso la casella del destinatario. È lo stato finale normale.
  • PENDING — Alva ha creato la riga di log ma è ancora in attesa di una risposta dal provider, o un retry di fallback è in corso.
  • BOUNCED — Postmark ha rifiutato il destinatario. Copre hard bounce e hit della lista di soppressione (errore Postmark 406 InactiveRecipientsError). Alva non riprova questi.
  • FAILED — Si è verificato un errore non recuperabile (fallimento di rete, 5xx del provider o eccezione interna in email.ts). Il messaggio d'errore è catturato nei metadata.
  • COMPLAINT — Il destinatario ha contrassegnato il messaggio come spam dopo la consegna.

Reinvio di email fallite

Se una riga mostra FAILED dopo un problema temporaneo del provider, attiva un nuovo invio dalla stessa pagina ordine — la guida Reinvia un'email di download a un cliente copre i passaggi. Le righe BOUNCED di solito richiedono un indirizzo email corretto prima che il reinvio sia utile.

Perché la mia email non è nel log?

Se Shop.isEmailEnabled è disattivato, Alva salta completamente l'invio e non scrive alcuna voce di log. Anche gli invii da dominio personalizzato vengono saltati se il piano a pagamento che ha provisionato il dominio è scaduto, poiché getFromEmail() blocca l'invio quando il controllo abbonamento fallisce. Riattiva le email in Impostazioni → Email, o ripristina il piano, poi reinvia.

FAQ

Per quanto tempo Alva Digital Downloads conserva i log email?

I log email vengono conservati indefinitamente sull'ordine. Gli acquisti effettuati prima del 20 settembre 2025 sono precedenti alla registrazione delle email e non mostrano voci.

Il log si aggiorna quando un cliente apre o clicca l'email?

No. Il log registra solo l'esito dell'invio. Gli eventi di apertura e clic non vengono tracciati, quindi uno stato SUCCESS conferma la consegna al provider della casella ma non che il cliente abbia letto l'email.

Perché il log mostra due voci per un ordine?

Ogni invio crea la propria voce. Un reinvio manuale, un reinvio attivato da Flow o un fallback al provider di backup aggiungono ciascuno una nuova riga così puoi auditare ogni tentativo separatamente.

Vedi anche

È stato utile?

Ancora bloccato? Scrivici.

Ultimo aggiornamento 2026-05-06