> ## 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.

# Dépannage

> Une campagne qui ne part pas, des e-mails en spam, un import en échec, un webhook qui ne vient pas, un e-mail transactionnel bloqué en pending, une adresse qui ne reçoit plus rien.

Chaque problème commence par sa cause la plus fréquente. Le lien au bout de chaque réponse mène à la page qui le règle.

## Une campagne ne part pas

L'onglet **Envoi** liste ce qui la bloque, chaque ligne avec le lien qui la règle.

| Vous voyez | Le plus souvent |
| - | - |
| « Configurez un fournisseur d’envoi dans les réglages. » / « Envoyez d’abord un e-mail de test depuis les réglages du fournisseur d’envoi. » | Aucun fournisseur d'envoi, ou un qui n'a jamais passé son test : **Paramètres → Fournisseurs d'envoi**, puis **Envoyer un e-mail de test**. Voir [Fournisseurs d'envoi](https://docs.lekalao.com/fr/deliverability/mailers.md#tester). |
| « Ajoutez un lien de désabonnement visible au contenu… » / « Ajoutez votre adresse postale au contenu… » | Le pied de page a été effacé du contenu : **Ajouter le pied de page** le réécrit. |
| « Renseignez l'adresse postale de votre organisation dans les réglages généraux. » | **Paramètres → Général**, sous Organisation. Voir [Réglages généraux](https://docs.lekalao.com/fr/account/maintenance.md#organisation). |
| « Cette campagne n'a aucun destinataire. » | La liste ou le segment est vide, ou tout le monde s'y est désabonné. |
| « … ne fait pas partie de vos domaines d'envoi. » / « … n'est pas encore vérifié. » | Le domaine de l'expéditeur manque, ou ses enregistrements ne sont pas encore trouvés. Voir [Domaines d'envoi](https://docs.lekalao.com/fr/deliverability/domains.md). |
| « L'envoi est en pause : cette équipe n'a pas d'abonnement valide. » / « Cette campagne demande … e-mails et il n'en reste que … ce mois-ci. » | La formule. Voir [Facturation](https://docs.lekalao.com/fr/account/billing.md). |
| « Cette équipe demande un second regard… » | Un autre membre doit l'approuver. Voir [Un second regard](https://docs.lekalao.com/fr/campaigns/sending.md#un-second-regard). |
| **Envoyer maintenant** grisé | Votre rôle est **Rédacteur** : un **Propriétaire** ou un **Éditeur** envoie. Voir [Qui peut envoyer](https://docs.lekalao.com/fr/campaigns/sending.md#qui-peut-envoyer). |

La liste complète, avec ce que demande chaque ligne, est dans [Prête ou non](https://docs.lekalao.com/fr/campaigns/sending.md#prête-ou-non). Par l'API, les mêmes lignes reviennent dans `problems`, avec un `422`.

Une campagne arrêtée en plein envoi, avec une raison en rouge, **s'est mise en pause d'elle-même** : trop de rebonds ou de plaintes. Lisez [Pause automatique](https://docs.lekalao.com/fr/campaigns/sending.md#pause-automatique) avant de la relancer.

## Les e-mails arrivent en spam

Les filtres jugent qui vous êtes, ce que vous envoyez, et à qui. Dans cet ordre :

1. **Qui vous êtes.** SPF, DKIM et DMARC publiés et trouvés pour le domaine de l'expéditeur. **Délivrabilité** montre l'état de chaque enregistrement. Un expéditeur sur un domaine qui ne les a pas est la première cause, de loin. Voir [Domaines d'envoi](https://docs.lekalao.com/fr/deliverability/domains.md).
2. **Vos liens.** Le suivi des clics fait passer chaque lien par l'adresse de Lekalao. Un [domaine de suivi](https://docs.lekalao.com/fr/deliverability/domains.md#le-domaine-de-suivi) sur votre propre domaine les garde à votre nom.
3. **Ce que vous envoyez.** Le contrôle avant envoi nomme ce que les filtres punissent : un objet en capitales, des liens raccourcis, un lien qui affiche une adresse et mène à une autre. Voir [Ce qu'un filtre anti-spam lui reprocherait](https://docs.lekalao.com/fr/content/checks.md#ce-qu’un-filtre-anti-spam-lui-reprocherait).
4. **À qui.** Les rebonds et les plaintes pèsent plus que tout le reste. Les taux des trente derniers jours sont sur **Délivrabilité** : les messageries réagissent au-delà de 2 % de rebonds et de 0,1 % de plaintes. Les vieilles adresses et les personnes qui ne lisent plus se traitent dans [Hygiène des listes](https://docs.lekalao.com/fr/deliverability/list-hygiene.md).
5. **Un nouvel expéditeur.** Un domaine que personne ne connaît et qui envoie toute sa liste le premier jour ressemble à un spammeur. Voir [Chauffer un nouvel expéditeur](https://docs.lekalao.com/fr/deliverability/mailers.md#chauffer-un-nouvel-expéditeur).

Donnez aux e-mails transactionnels un fournisseur à eux : une campagne qui tourne mal n'emporte alors jamais vos factures en spam. Voir [Fournisseur par type d'envoi](https://docs.lekalao.com/fr/deliverability/mailers.md#fournisseur-par-type-d’envoi).

## Un import a échoué

L'onglet **Imports** de la liste montre chaque import, **Échoué** ou **Terminé** avec ses lignes en erreur.

* **Refusé tout de suite** : le fichier n'a pas de ligne d'en-tête (« Ce fichier n'a pas de ligne d'en-tête. »), aucune colonne ne porte l'adresse (« Une colonne doit contenir l'adresse e-mail. »), ou ce n'est pas un fichier CSV, TXT ou XLSX de 20 Mo au plus.
* **Échoué** en cours de route : le plus souvent, le quota d'abonnés de la formule est épuisé. Les lignes déjà traitées restent importées. Faites de la place ou changez de formule, puis importez la suite. Voir [Facturation](https://docs.lekalao.com/fr/account/billing.md).
* **Terminé**, avec des lignes en erreur : chaque ligne dit pourquoi. Une adresse invalide ; une adresse de la liste de suppression ; une personne désabonnée auparavant (« Ignoré : … s'est désabonnée auparavant. »), qui ne revient que si **Réinscrire les personnes désabonnées** est coché et qu'elle l'a demandé ; une boîte jetable, ou un domaine sans serveur de messagerie. Voir [Hygiène des listes](https://docs.lekalao.com/fr/deliverability/list-hygiene.md#les-adresses-examinées-à-l’entrée).
* **Importées, et rien ne leur a été envoyé** : c'est le comportement par défaut. Ni e-mail de bienvenue ni automatisation pour les personnes importées, sauf si **Les accueillir comme de nouveaux abonnés** était coché.

Tout ce que fait un import est dans [Import et export](https://docs.lekalao.com/fr/contacts/import-export.md).

## Un webhook n'arrive pas

Commencez par **Paramètres → Webhooks sortants**, et les **Appels que nous avons faits** de l'adresse : chaque appel y est, avec la réponse de votre serveur.

* **Aucun appel.** L'adresse n'écoute pas cet événement ; ou elle est limitée à une liste, et l'événement n'appartient à aucune liste (les e-mails transactionnels, leurs rebonds et leurs plaintes) ; ou elle est **Désactivée**, à la main ou après 3 jours d'échecs, et ses propriétaires ont alors reçu un e-mail. Réactivez **Appeler cette adresse**.
* **Des appels en échec.** Votre serveur doit répondre un `2xx` en moins de 15 secondes, sans redirection : les redirections ne sont pas suivies. Lekalao retente chaque appel pendant environ 21 heures (**Nouvelle tentative prévue**) ; dès que votre serveur répond, la tentative suivante passe. Un appel **Échoué** après sa septième tentative ne repart qu'avec **Renvoyer**.
* **Une adresse que Lekalao refuse.** Elle doit être publique : `localhost` et les réseaux privés sont refusés. Pour tester sur votre machine, passez par un tunnel.
* **Des appels qui arrivent et que votre code rejette.** La signature se calcule sur l'heure de l'appel, un point et le corps brut, avec le secret propre à cette adresse ; un serveur dont l'horloge a plus de cinq minutes d'écart refuse tous les appels. Voir [Vérifier la signature](https://docs.lekalao.com/fr/developers/webhooks.md#vérifier-la-signature).
* **Le même événement deux fois.** Un nouvel essai ou un **Renvoyer** porte le même `Lekalao-Event-Id` : ignorez un identifiant déjà traité.
* **Pas de `mail.bounced` ni de `mail.complaint`.** Ils viennent d'abord de votre fournisseur. S'il ne prévient pas Lekalao, il n'y a rien à transmettre : **Paramètres → Retours des fournisseurs** liste ce qu'il a reçu. Voir [Retours des fournisseurs](https://docs.lekalao.com/fr/deliverability/feedback.md).

Voir [Webhooks sortants](https://docs.lekalao.com/fr/account/integrations.md#webhooks-sortants) et, pour le code, [Webhooks](https://docs.lekalao.com/fr/developers/webhooks.md).

## Un e-mail transactionnel reste en pending

Quelques secondes en `pending`, c'est normal : l'e-mail part d'une file d'attente, après la réponse.

Pendant des minutes :

* **Le fournisseur échoue, et Lekalao réessaie**, après 5 secondes, 30 secondes, 2 minutes, 10 minutes et 30 minutes. Après le sixième échec, et six heures après l'appel au plus tard, l'e-mail passe à `failed`, avec la dernière erreur du fournisseur dans `failure_reason`.
* **La limite de débit du fournisseur** retient les e-mails quand beaucoup partent à la fois. Elle se règle sur le fournisseur.
* **Sur votre propre installation, les workers sont peut-être arrêtés.** **Paramètres → Maintenance** montre les files et les tâches en échec. Sur le service Lekalao, prévenez le support.
* **La file l'a perdu.** Après une restauration, ou un Redis redémarré sans ses données, un e-mail peut ne plus avoir de tâche pour l'envoyer. Sept heures après l'appel, il passe `failed` avec `failure_code: lost`. Renvoyez-le.

Une fois en `failed` : lisez `failure_code` et `failure_reason`, testez le fournisseur avec **Envoyer un e-mail de test**, puis renvoyez l'e-mail, avec **Renvoyer** dans le journal ou `POST /v1/transactional-mails/{id}/resend`. Voir [Ensuite, dans la file](https://docs.lekalao.com/fr/developers/transactional.md#ensuite-dans-la-file).

## Une adresse ne reçoit plus rien

Le plus souvent, elle est dans la **liste de suppression** : elle a rebondi pour de bon (**Rebond dur**), sa propriétaire a signalé un e-mail comme spam (**Plainte pour spam**), ou quelqu'un l'a bloquée (**Ajoutée manuellement**). Cherchez-la dans **Contacts → Liste de suppression**.

* Plus rien ne lui est envoyé : ni campagne, ni automatisation, ni confirmation, ni e-mail transactionnel. Un e-mail transactionnel la retire de ses destinataires ; s'il ne reste personne dans `to`, l'appel répond `422` `recipients_suppressed` et `failure_reason` la nomme.
* Par l'API, l'inscrire de nouveau répond `422` `address_suppressed` (« Cette adresse est bloquée. »), et un lot marque sa ligne `failed`.
* Un rebond dur ou une plainte a aussi désabonné la personne de toutes les listes.

Ne la retirez que si la personne vous le demande, avec la corbeille de sa ligne : une adresse qui a rebondi rebondira encore, et qui s'est plaint se plaindra encore. Voir [Liste de suppression](https://docs.lekalao.com/fr/contacts/suppression-list.md) et [Retours des fournisseurs](https://docs.lekalao.com/fr/deliverability/feedback.md).

## Toujours bloqué

* Chaque code d'erreur de l'API, et quand réessayer : [Erreurs](https://docs.lekalao.com/fr/errors.md).
* Ce qui a changé dernièrement : [Journal des modifications](https://docs.lekalao.com/fr/help/changelog.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.