> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumicoda.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Suivre la délivrabilité des e-mails

> Documentation du système de traçabilité des communications : statuts d'envoi, diagnostic des erreurs SMTP et webhooks de réception.

Le module **E-mails** est votre tour de contrôle pour toutes les communications sortantes. Dans un environnement où les filtres anti-spam sont de plus en plus restrictifs, il est vital de savoir si une convocation critique a réellement atteint son destinataire. Tiiva suit la progression technique de chaque message en temps réel.

## 1. Pourquoi une traçabilité complète ?

Un système d'envoi classique vous informe seulement si le message est "parti". Tiiva va plus loin en interrogeant les serveurs de destination pour résoudre les situations suivantes :

* Un parent prétend n'avoir rien reçu alors que le délai est passé.
* Une campagne massive semble échouer vers un fournisseur spécifique (ex: @bluewin.ch).
* Vous devez auditer légalement la réception d'une consigne de sécurité.

***

## 2. Comprendre les statuts de délivrabilité

Tiiva utilise des badges de couleur pour diagnostiquer l'état d'un envoi :

### Envoyé (`MessageSent`) - Badge Vert

Le message a été accepté avec succès par le serveur du destinataire.

* **Interprétation** : Si le membre ne voit rien, le message est soit dans ses "Indésirables" (Spam), soit trié automatiquement (ex: onglet "Promotions" de Gmail).

### Différé (`MessageDelayed`) - Badge Orange

Le serveur de destination a demandé à Tiiva de réessayer plus tard.

* **Causes** : Technique anti-spam temporaire ou panne momentanée chez le fournisseur. Tiiva effectuera plusieurs tentatives automatiques avant d'abandonner.

### Échec (`MessageDeliveryFailed`) - Badge Rouge

Le message n'a pas pu être délivré et Tiiva a abandonné les tentatives.

* **Causes** : Adresse e-mail inexistante (faute de frappe), boîte e-mail pleine ou refus catégorique pour suspicion de spam. Vous devez corriger la [fiche contact](/admin-contacts).

***

## 3. Diagnostic technique

Pour les cas d'échec répétés, activez la colonne **Détails** dans les réglages de la table. Tiiva affiche la réponse brute du serveur SMTP distant (ex: "550 User unknown"). Ce code d'erreur vous indique précisément pourquoi le message a été rejeté.

***

## 4. Analyse macroscopique

Utilisez la fonction de **Groupement** (cliquez sur l'entête de colonne "Statut") pour identifier des problèmes systémiques :

* Un taux d'échec supérieur à 5% sur vos 1000 derniers envois indique un besoin urgent de nettoyage de votre annuaire.
* Un pic d'erreurs à une heure précise peut signaler un incident chez un gros fournisseur national.

<Tip>
  **Action corrective** : Si l'adresse d'un membre échoue systématiquement, utilisez l'action de [Validation technique DNS](/admin-action-validation-email) sur sa fiche contact avant de tenter un nouvel envoi de Magic Link.
</Tip>