Les erreurs SMTP perturbent régulièrement la distribution d’e-mails pour de nombreuses entreprises et sites WordPress, avec des retours d’erreur parfois cryptiques. Comprendre les causes courantes permet de gagner du temps lors du dépannage email et d’éviter des interruptions longues.
L’objectif est d’expliquer la configuration SMTP avec Gmail et Google Workspace, puis détailler des solutions éprouvées pour les problèmes d’envoi. Les points essentiels pour corriger les problèmes d’envoi suivent dans la section dédiée.
A retenir :
- Authentification OAuth active, ID client et Secret correctement configurés
- Enregistrements SPF et DKIM ajoutés pour le domaine personnalisé
- URI de redirection validée, éviter mismatch et erreurs 403
- Connexion secondaire configurée pour secours en cas de panne
Configurer WP Mail SMTP avec Gmail et Google Workspace
Création d’une application Google pour l’authentification SMTP
Après ces constats, la première étape consiste à créer une application dans la Google Cloud Console afin d’obtenir un ID client et un Secret client. Selon WP Mail SMTP, cette application permet d’utiliser l’API Gmail pour un envoi sécurisé sans partager de mot de passe.
Code / message
Cause probable
Solution rapide
401 invalid_client
ID client manquant ou mal collé
Vérifier copie, supprimer espaces superflus
403 access_denied
Publication en mode Interne non modifiée
Passer l’application en Externe ou Publier
413 Entity too large
Pièce jointe dépassant la limite Gmail
Réduire attachements sous 22 Mo
invalid_grant / Bad Request
Secret client invalide ou jeton expiré
Générer nouveau secret, réautoriser
Conseils pratiques incluent la configuration précise des URI de redirection et la vérification du statut de publication OAuth avant l’autorisation. Selon Google, une bonne configuration évite la plupart des erreurs 403 et invalid_request lors de l’octroi d’accès.
Conseils de configuration :
- Ajouter https://connect.wpmailsmtp.com/google/ comme redirect URI
- Définir l’application en Externe pour les comptes non-Workspace
- Copier l’ID client et le Secret sans espaces
« J’ai perdu une matinée à cause d’un espace collé au début de l’ID client, la copie propre a résolu l’envoi instantanément »
Alice N.
Activation de l’API Gmail et écran de consentement
Cette activation permet à votre site d’autoriser l’envoi via l’API Gmail et d’obtenir les autorisations nécessaires pour l’authentification SMTP. Une publication en production ou une mise en Externe résout souvent l’erreur 403 et prépare le dépannage des erreurs SMTP.
Vérifiez le champ E-mail d’assistance et ajoutez l’URI de redirection autorisée depuis WP Mail SMTP pour éviter redirect_uri_mismatch. Selon WP Mail SMTP, l’utilisation d’un URI propre au site améliore la confidentialité et évite certains blocages mod_security.
Dépannage des erreurs SMTP courantes avec Gmail
Messages d’erreur fréquents et solutions immédiates
Une fois l’API activée, les problèmes d’envoi se manifestent souvent lors d’un test d’email via WP Mail SMTP, avec des journaux de débogage clairs. Selon Google, les codes 401, 403 et 413 sont parmi les plus rencontrés et renvoient à des problèmes d’identifiants ou de taille d’attachment.
Paramètre
Valeur recommandée
Port
Serveur SMTP
smtp.gmail.com
465 (SSL) / 587 (TLS)
Nom d’utilisateur
adresse Gmail complète
—
Authentification
OAuth 2.0 via API Gmail
—
TLS/SSL
Obligatoire
—
Vérifications système rapides :
- Contrôler ouverture des ports 465 et 587 chez l’hébergeur
- Vérifier présence de cacert.pem en cas d’erreur cURL 60
- S’assurer que l’adresse expéditeur correspond à l’ID configuré
« Après avoir régénéré le Secret client la connexion est revenue, le test d’envoi m’a confirmé la résolution »
Marc N.
Résolution des cas complexes et conflits de plugins
Les conflits surviennent quand un plugin charge une version différente de l’API Google, provoquant une erreur de décodage du jeton JSON. Selon WP Mail SMTP, la désactivation temporaire du plugin conflictuel ou le choix d’un autre expéditeur résout souvent le blocage.
Étapes de dépannage :
- Désactiver les plugins tiers liés à Google comme UpdraftPlus
- Tester l’envoi après chaque désactivation pour isoler le conflit
- Réinstaller la connexion OAuth si le mot de passe Google change
Bonnes pratiques pour la délivrabilité et la messagerie professionnelle
Paramètres DNS et surveillance de la délivrabilité
Après résolution technique, l’enjeu devient durable : optimiser la délivrabilité et la réputation d’envoi pour la messagerie professionnelle. Selon Hostinger, l’ajout correct des enregistrements SPF, DKIM et DMARC réduit significativement les rejets et le classement en spam.
Pour les domaines personnalisés, validez DKIM depuis la console Google et fusionnez les enregistrements SPF existants si nécessaire pour éviter les duplications. Une surveillance régulière des taux d’ouverture et des rebonds guide les ajustements d’envoi.
« Nous avons stabilisé notre délivrabilité en centralisant les enregistrements DNS et en ajoutant une connexion secondaire pour secours »
Claire N.
Monitoring, rotation d’expéditeurs et connexion de secours
Pour limiter l’impact d’une panne, prévoyez une connexion SMTP de secours et un routage intelligent des messages selon la charge. La rotation d’expéditeurs et l’observabilité en temps réel améliorent la résilience d’envoi et la conformité.
Étapes recommandées incluent la mise en place de journaux d’envoi, l’analyse des erreurs SMTP et des tests périodiques des paramètres SMTP en production. Cela prépare aussi l’équipe aux incidents et simplifie le dépannage email.
« Mon avis professionnel est que la prévention vaut mieux que la réparation pour la messagerie d’entreprise »
Paul N.
Source : Google, « Erreurs et codes SMTP Gmail », Google Help ; WP Mail SMTP, « Documentation de configuration », WP Mail SMTP ; Hostinger, « Configurer et utiliser le serveur SMTP Gmail », Hostinger.