> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Dépannage e-mail
> Comment diagnostiquer et résoudre les problèmes e-mail courants de OneSignal.
Utilisez ce guide pour identifier et résoudre les problèmes e-mail OneSignal les plus courants, y compris les problèmes de configuration, les défis de délivrabilité et les erreurs de conception.
Avant de dépanner, consultez nos guides [Configuration e-mail](./email-setup) et [Délivrabilité des e-mails](./email-deliverability). Ceux-ci couvrent les causes les plus courantes des problèmes d'e-mail.
## Problèmes de configuration
La plupart des problèmes de configuration proviennent d'enregistrements DNS incorrects ou de limitations de votre fournisseur de service d'e-mail (ESP).
### Vérifier les enregistrements DNS
1. Ouvrez votre fournisseur DNS.
2. Confirmez que les enregistrements SPF, DKIM et MX correspondent à notre guide [Configuration DNS des e-mails](./email-dns-configuration).
3. Accordez jusqu'à 24 heures pour que les modifications DNS se propagent.
Si les enregistrements DNS sont mal configurés, les e-mails peuvent ne pas être envoyés, rebondir ou être marqués comme spam.
### Limites d'envoi mensuelles (ESP non OneSignal)
Si vous utilisez SendGrid, Mailchimp ou Mailgun directement (et non via OneSignal E-mail), votre volume d'envoi est limité par votre plan ESP.
Vérifiez les journaux de votre fournisseur :
* [Flux d'activité SendGrid](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Activité et rapports Mailchimp](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Journaux Mailgun](https://www.mailgun.com/products/send/email-analytics/logs/)
### Trop de recherches DNS
Lors du test des enregistrements SPF avec des outils comme [Test URI](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com), vous pouvez voir :
Ceci est attendu si vous utilisez l'enregistrement SPF :
```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```
OneSignal utilise Mailgun "en arrière-plan" comme notre fournisseur de service d'e-mail. Cela signifie que les recherches SPF pointent vers les mêmes plages d'IP et n'ajoutent en réalité aucune recherche supplémentaire. Pour supprimer l'avertissement, vous pouvez simplifier à :
```
v=spf1 include:mailgun.org ~all
```
Cela empêchera l'erreur et n'affectera pas l'envoi d'e-mails OneSignal.
### Plusieurs enregistrements TXT pour le domaine d'envoi
Vous ne pouvez avoir qu'**un seul** enregistrement SPF pour votre domaine d'envoi.
Vérifiez avec [Recherche TXT WhatsMyDNS](https://www.whatsmydns.net/#TXT) pour confirmer que vous n'avez pas plusieurs entrées.
***
## Problèmes de délivrabilité
Les problèmes de délivrabilité incluent les envois lents, le placement dans le dossier spam et les rebonds d'e-mails.
### E-mails retardés
Si votre domaine d'envoi est nouveau ou a une faible réputation, les FAI (Gmail, Outlook, Yahoo) peuvent retarder la livraison. C'est ce qu'on appelle la **limitation de débit** ou le **greylisting**. Lorsque vous consultez vos [Rapports de messages e-mail](./email-message-reports), vous pouvez vérifier les détails du temps qu'il nous a fallu pour envoyer le message.
Dans cet exemple, nous voyons que l'e-mail a été envoyé depuis OneSignal en moins de 3 secondes. Nous l'envoyons au fournisseur de service d'e-mail, qui l'envoie ensuite au FAI du destinataire. Ces serveurs de messagerie peuvent retarder l'e-mail jusqu'à plusieurs heures avant qu'il ne soit livré au destinataire.
Suivez nos [Meilleures pratiques de réputation e-mail](./email-reputation-best-practices) pour accélérer la livraison.
### E-mails atterrissant dans le spam
La cause la plus courante est une mauvaise réputation de l'expéditeur. Suivez notre guide [Délivrabilité des e-mails](./email-deliverability).
Si vous utilisez un ESP tiers, consultez :
* [SendGrid : Listes de refus](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun : Informations sur la liste noire](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp : Réputation et rejets](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)
### Envoi et réception depuis le même domaine
Un seul domaine ne peut pas utiliser les mêmes enregistrements MX pour envoyer et recevoir du courrier simultanément. Si vous souhaitez **envoyer** depuis `@votredomaine.com` et aussi **recevoir** sur le même domaine :
* Conservez votre DNS d'envoi avec OneSignal.
* Pointez vos enregistrements MX vers votre fournisseur d'e-mail entrant (par ex., [enregistrements MX Google Workspace](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)).
### Listes de suppression
Si une adresse s'est désabonnée ou vous a marqué comme spam, votre ESP supprimera les envois vers celle-ci.
Pour se réabonner :
1. Allez dans **Audience > Abonnements** dans OneSignal.
2. Recherchez l'adresse e-mail.
3. Cliquez sur **Se désabonner de l'e-mail** (si abonné) puis **Se réabonner à l'e-mail**.
4. Envoyez un e-mail de test pour confirmer.
### Apple Private Relay
Si vous envoyez vers des adresses `@privaterelay.appleid.com`, vous devez vérifier votre domaine d'envoi dans votre [compte développeur Apple](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/).
Les domaines non vérifiés entraîneront l'abandon des e-mails.
### Clé API trop restrictive
Si vous utilisez SendGrid ou Mailchimp, assurez-vous que votre clé API dispose des [autorisations minimales requises](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow).
***
## Conception d'e-mail
Ce sont des problèmes à l'intérieur du contenu de l'e-mail lui-même.
### Liens ne fonctionnant pas
Généralement causé par une configuration CNAME manquante ou incorrecte.
Si vous utilisez un ESP tiers, suivez leur configuration de domaine de suivi.
### Boutons non cliquables
* Assurez-vous que l'URL est correcte et commence par `https://`.
* Évitez de tester depuis votre dossier spam—certains clients de messagerie bloquent les liens là-bas.
### Ajout d'images au prévisualisation
Gmail prend en charge les images promotionnelles dans les prévisualisations (annotations d'offres, carrousels de produits).
Consultez le [Portail développeur Gmail](https://developers.google.com/gmail/promotab/overview) pour la configuration.
***
## Fournisseurs de service d'e-mail (ESP)
Questions ou problèmes courants liés à l'utilisation de nos intégrations avec SendGrid, Mailchimp ou Mailgun.
### Dois-je payer un autre fournisseur pour l'e-mail ?
Si vous utilisez la [Configuration e-mail OneSignal](./email-setup), nous gérerons vos comptes e-mail et vous n'avez pas besoin d'utiliser un autre fournisseur d'e-mail. Si vous prévoyez d'utiliser Sendgrid, Mailchimp ou Mailgun, vous devrez continuer à payer votre fournisseur de service d'e-mail directement.
## Quel est le débit e-mail de OneSignal ?
OneSignal envoie généralement des messages à un taux de 1 000 à 5 000 par seconde au fournisseur de service d'e-mail. Il appartient à votre ESP de livrer les e-mails à vos utilisateurs.
OneSignal utilise Mailgun pour OneSignal E-mail et Mailgun annonce qu'il peut prendre en charge jusqu'à [15 millions d'e-mails par heure](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/).
***