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

# Retours des fournisseurs

> Livraisons, rebonds et plaintes : ce que le fournisseur renvoie, et ce que Lekalao en fait.

Un e-mail remis au fournisseur n'est pas encore arrivé. Le fournisseur sait ensuite s'il a été **délivré**, s'il a **rebondi** (adresse inexistante, boîte pleine) ou si la personne l'a **signalé comme spam**. Il le dit à Lekalao par un **webhook** : une adresse que le fournisseur appelle à chaque événement.

Sans ce branchement, Lekalao continue d'écrire à des adresses mortes et à des personnes qui se plaignent, et votre réputation d'expéditeur se dégrade sans que vous le voyiez.

## Brancher le webhook

Sur la page du fournisseur (**Paramètres → Fournisseurs d'envoi → un fournisseur**), section **Retours** :

### Automatiquement

Pour **Postmark, Mailgun, SendGrid, Brevo et Resend**, le bouton **Le faire pour moi** crée le webhook chez le fournisseur avec la clé API enregistrée, pour les bons événements, et garde ce que le fournisseur renvoie (clé publique SendGrid, secret de signature Resend). La date de création s'affiche ensuite ; **Le refaire** recrée ou réaligne le webhook.

<Note>
  La clé API doit avoir le droit de gérer les webhooks. Pour **Mailgun**, la
  clé de signature des webhooks est propre au compte et jamais renvoyée par
  l'API : copiez-la depuis Mailgun dans le champ prévu.
</Note>

### À la main

Copiez l'**URL de webhook** et suivez les instructions affichées :

| Fournisseur    | Où                                                                                                                                    | Événements                                                                | Signature                    |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------- |
| **Amazon SES** | Un *configuration set* avec une destination SNS, puis un abonnement HTTPS de l'URL au sujet SNS (l'abonnement se confirme tout seul). | Delivery, Bounce, Complaint                                               | Signature SNS vérifiée       |
| **Postmark**   | Le *message stream*, puis Webhooks.                                                                                                   | Delivery, Bounce, Spam complaint                                          | Secret dans l'URL            |
| **Mailgun**    | Sending → Webhooks.                                                                                                                   | delivered, permanent failure, temporary failure, complained, unsubscribed | Clé de signature HTTP        |
| **SendGrid**   | Settings → Mail Settings → Event Webhook, signature activée.                                                                          | delivered, bounce, blocked, deferred, dropped, spamreport, unsubscribe    | Clé publique à copier        |
| **Brevo**      | Transactional → Settings → Webhooks.                                                                                                  | delivered, bounce, spam, unsubscribe                                      | Secret dans l'URL            |
| **Resend**     | Webhooks.                                                                                                                             | delivered, bounced, complained                                            | Secret de signature à copier |

Un fournisseur **SMTP** ne renvoie rien : les rebonds reviennent sous forme d'e-mails dans la boîte d'expédition, que Lekalao ne lit pas.

## Ce que fait chaque événement

| Événement                                      | Effet                                                                                                |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Délivré**                                    | L'envoi est marqué délivré ; il compte dans « Délivré » des statistiques.                            |
| **Rebond temporaire**                          | L'envoi est marqué ; l'adresse n'est pas bloquée (boîte pleine, serveur momentanément indisponible). |
| **Rebond définitif**                           | L'adresse part en **liste de suppression** et la personne est **désabonnée de toutes les listes**.   |
| **Plainte pour spam**                          | Idem : suppression et désabonnement partout.                                                         |
| **Désabonnement** (signalé par le fournisseur) | Désabonnement de toutes les listes.                                                                  |

Chaque rebond est classé (adresse inexistante, boîte pleine, bloqué par le serveur destinataire, contenu refusé, domaine inexistant, autre) et visible dans la boîte d'envoi de la campagne. Les rebonds et les plaintes sont aussi transmis aux [webhooks sortants](/fr/developers/webhooks) (`mail.bounced`, `mail.complaint`).

<Info>
  Les ouvertures et les clics signalés par certains fournisseurs sont
  **ignorés** : Lekalao les mesure lui-même, avec son pixel et ses liens,
  pour ne rien compter deux fois.
</Info>

## Le journal

**Paramètres → Retours des fournisseurs** : chaque appel reçu, gardé 30 jours (réglable), avec la date, le fournisseur, l'événement, le statut et l'adresse. Cliquez sur une ligne pour voir le contenu brut.

| Statut     | Signification                                                 |
| ---------- | ------------------------------------------------------------- |
| **Traité** | L'événement a été appliqué.                                   |
| **Ignoré** | Événement sans effet (ouverture, clic, type inconnu).         |
| **Rejeté** | Signature invalide, ou appel qui ne vient pas du fournisseur. |

Filtrez par statut et, si vous en avez plusieurs, par fournisseur. Beaucoup d'appels **rejetés** signalent en général un secret de signature mal copié.