Passer au contenu principal
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. La liste complète, avec ce que demande chaque ligne, est dans 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 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.
  2. Vos liens. Le suivi des clics fait passer chaque lien par l’adresse de Lekalao. Un 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.
  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.
  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.
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.

​
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.
  • 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.
  • 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.

​
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.
  • 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.
Voir Webhooks sortants et, pour le code, Webhooks.

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

​
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 et Retours des fournisseurs.

​
Toujours bloqué