Erreur : invalid_grant : jeton expiré ou révoqué

Que signifie cette erreur ?

Le jeton de rafraîchissement OAuth utilisé par WP Mail SMTP pour envoyer des e-mails via Gmail a expiré ou a été révoqué par Google. Le plugin ne peut plus obtenir de nouveaux jetons d'accès, et l'envoi d'e-mails échoue.

Causes courantes

• Le jeton de rafraîchissement a expiré au bout de 7 jours (conformément à la politique de Google pour les applications en mode « Test » qui demandent des autorisations sensibles, comme Gmail)
• Jeton d'actualisation inutilisé depuis 6 mois (Google révoque les jetons inactifs, quel que soit leur statut de publication)
• Vous avez modifié le mot de passe de votre compte Google
• Vous avez révoqué manuellement l'accès sur myaccount.google.com » Sécurité » Applications tierces
• Google a détecté une activité inhabituelle et a révoqué les jetons par mesure de sécurité
• Le compte a dépassé la limite de 50 jetons d'actualisation par client OAuth (Google révoque automatiquement le jeton le plus ancien)

Comment résoudre le problème

Voici le guide complet, étape par étape, pour résoudre cette erreur.

Étape 1 : Publier l'application OAuth en production (mode test uniquement)

Si le jeton expire tous les 7 jours, cela signifie que le projet Google Cloud est toujours en mode test. Publiez d'abord l'application OAuth en production, puis reconnectez-vous. Si votre projet est déjà en production, passez à l'étape 2.

Commencez par ouvrir la console Google Cloud. Ensuite, accédez à « API et services » > « Écran de consentement OAuth », puis cliquez sur l'onglet « Audience ».

Cliquez ensuite sur « PUBLIER L'APPLICATION », puis sur « CONFIRMER ».

Enfin, vérifiez que le statut passe à « En production ».

Étape 2 : reconnectez-vous à votre compte Google

Le moyen le plus rapide de résoudre un problème lié à un jeton expiré ou révoqué consiste à réautoriser WP Mail SMTP auprès de Google.

Commencez par vous rendre dans WP Mail SMTP » Paramètres, puis faites défiler la page jusqu'à la section « Google / Gmail ». Cliquez ensuite sur « Supprimer la connexion ».

Ensuite, cliquez sur « Autoriser le plugin à envoyer des e-mails via votre compte Google ».

Ensuite, sélectionnez votre compte Google et accordez les autorisations demandées pour Gmail. Enfin, une fois l'autorisation terminée, cliquez sur « Enregistrer les paramètres ».

Étape 3 : Envoyer un e-mail de test

Vérifiez que le problème est résolu en envoyant un e-mail de test.

Pour tester la correction, rendez-vous dans WP Mail SMTP » Outils et cliquez sur l'onglet « Test d'e-mail ». Saisissez l'adresse e-mail d'un destinataire dans le champ « Envoyer à », laissez l'option HTML activée, puis cliquez sur « Envoyer l'e-mail ».

Une fois cette opération terminée, vérifiez si un message de confirmation s'affiche et assurez-vous que l'e-mail est bien arrivé dans votre boîte de réception.

Notes

• La modification du mot de passe de votre compte Google entraîne l'invalidation immédiate de tous les jetons OAuth existants.
• Dans Google Workspace, cliquez sur « RENDRE EXTERNE » au lieu de « PUBLIER L'APPLICATION » dans l'onglet « Audience », puis sélectionnez « En production ».

Et voilà ! Vous savez désormais comment résoudre l'erreur « invalid_grant : Token Expired or Revoked » dans Gmail et rétablir l'envoi de vos e-mails via WP Mail SMTP.