Aller au contenu principal
— Tutoriel de configuration

Suivre le statut de livraison des e-mails

Alva Digital Downloads consigne chaque e-mail de livraison qu'il envoie dans la table EmailLog et l'affiche sur la page de détail de la commande dans l'admin. Chaque entrée enregistre l'objet, le destinataire, l'horodatage d'envoi et la réponse du fournisseur — l'identifiant de message Postmark en cas de succès, ou un code d'erreur en cas d'échec.

Où consulter le statut de livraison

Le journal d'e-mails se trouve sur chaque commande, et non sous forme de flux global. Ouvrez la commande pour voir tous les e-mails qu'Alva a tenté d'envoyer.

1. Ouvrez la commande dans l'admin Alva

Dans l'admin Alva, cliquez sur Commandes, puis cliquez sur le numéro de commande que vous voulez inspecter.

2. Faites défiler jusqu'à la section Historique des e-mails

Sous les cartes client et produit, trouvez la carte Historique des e-mails. Le badge à droite affiche le compte total, par exemple 2 e-mails envoyés.

Capture d'écran requise

Page de détail de commande avec la carte Historique des e-mails visible. Affichez le titre de la section, le badge de comptage et le chevron pour développer. Aucune donnée client réelle visible.

La carte Historique des e-mails sur la page de détail de la commande.

3. Développez pour voir chaque entrée

Cliquez sur le chevron de la carte. Chaque ligne affiche l'horodatage d'envoi, le destinataire, le badge de statut (vert pour succès, rouge pour échec, ambre pour en attente ou rebondi), et le type d'e-mail — Lien de téléchargement, Renvoi manuel, ou Livraison de clé de licence.

4. Inspectez la réponse du fournisseur

L'identifiant de message Postmark, le code d'erreur et le message d'erreur sont stockés dans metadata sur la ligne du journal — transmettez ces valeurs au support si un envoi nécessite une investigation.

Capture d'écran requise

Une seule ligne du journal d'e-mails développée, montrant l'horodatage, le destinataire, le badge de statut, le badge de type, et le bloc de métadonnées avec l'identifiant de message du fournisseur. Aucune donnée client réelle visible.

Une ligne de journal développée montrant la réponse Postmark.

Ce que signifient les valeurs de statut

  • SUCCESS — Postmark a accepté l'e-mail et il est en route vers la boîte de réception du destinataire. C'est l'état terminal normal.
  • PENDING — Alva a créé la ligne du journal mais attend encore une réponse du fournisseur, ou une nouvelle tentative de secours est en cours.
  • BOUNCED — Postmark a rejeté le destinataire. Couvre les rebonds définitifs et les correspondances avec la liste de suppression (erreur Postmark 406 InactiveRecipientsError). Alva ne réessaie pas ces envois.
  • FAILED — Une erreur non récupérable s'est produite (panne réseau, 5xx du fournisseur, ou exception interne dans email.ts). Le message d'erreur est capturé dans les métadonnées.
  • COMPLAINT — Le destinataire a marqué le message comme spam après livraison.

Renvoyer les e-mails échoués

Si une ligne affiche FAILED après un problème transitoire du fournisseur, déclenchez un nouvel envoi depuis la même page de commande — le tutoriel Renvoyer un e-mail de téléchargement à un client couvre les étapes. Les lignes BOUNCED nécessitent généralement une adresse e-mail corrigée avant qu'un renvoi ne soit utile.

Pourquoi mon e-mail n'est-il pas dans le journal ?

Si Shop.isEmailEnabled est désactivé, Alva ignore complètement l'envoi et n'écrit aucune entrée de journal. Les envois de domaine personnalisé sont aussi ignorés si la formule payante qui a provisionné le domaine a expiré, car getFromEmail() bloque l'envoi quand la vérification d'abonnement échoue. Réactivez les e-mails sous Paramètres → E-mail, ou restaurez la formule, puis renvoyez.

FAQ

Combien de temps Alva Digital Downloads conserve-t-il les journaux d'e-mails ?

Les journaux d'e-mails sont conservés indéfiniment sur la commande. Les achats passés avant le 20 septembre 2025 précèdent la consignation des e-mails et n'affichent aucune entrée.

Le journal se met-il à jour quand un client ouvre ou clique sur l'e-mail ?

Non. Le journal enregistre uniquement le résultat de l'envoi. Les événements d'ouverture et de clic ne sont pas suivis, donc un statut SUCCESS confirme la livraison au fournisseur de boîte de réception mais pas que le client a lu l'e-mail.

Pourquoi le journal affiche-t-il deux entrées pour une commande ?

Chaque envoi crée sa propre entrée. Un renvoi manuel, un renvoi déclenché par Flow, ou un repli sur le fournisseur de secours ajoutent chacun une nouvelle ligne pour vous permettre d'auditer chaque tentative séparément.

Voir aussi

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-05-06