Cette fonctionnalité nécessite MailerPress Pro.
Le fournisseur Gmail envoie vos e-mails MailerPress via l’API Gmail d’un compte Gmail ou Google Workspace. MailerPress se connecte avec OAuth, le système d’autorisation sécurisé de Google : vous ne saisissez jamais votre mot de passe Google, vous autorisez seulement MailerPress à envoyer des e-mails au nom de votre compte. Gmail convient aux petits volumes : Google limite l’envoi à environ 500 e-mails par jour pour un compte Gmail gratuit et 2 000 pour Google Workspace. Pour des newsletters régulières, utilisez un service d’envoi dédié.
Ce dont MailerPress a besoin
MailerPress a besoin d’un client OAuth créé dans Google Cloud (une fiche d’application qui lui permet de demander l’accès à votre compte) :
| Élément | Détails |
|---|---|
| Gmail API Client ID | L’ID client de votre client OAuth Google Cloud (type « Application Web »). |
| Gmail API Client Secret | Le code secret de ce même client. |
| URI de redirection autorisée | L’adresse vers laquelle Google vous renvoie après l’autorisation. Affichée dans MailerPress, sous la forme https://example.com/wp-admin/admin-post.php?action=mailerpress_gmail_oauth_callback. Ajoutez-la au client OAuth dans Google Cloud. |
| Autorisations (scopes) | https://www.googleapis.com/auth/gmail.send (envoyer des e-mails) et https://www.googleapis.com/auth/userinfo.email (voir l’adresse e-mail du compte). MailerPress ne peut pas lire votre boîte de réception. |
Créer un client OAuth dans Google Cloud
Connectez-vous à la console Google Cloud avec le compte Google depuis lequel vous voulez envoyer, ou avec un compte administrateur de votre Google Workspace.
- Créez un projet (ou sélectionnez un projet existant).
- Dans la bibliothèque d’API, activez l’API Gmail pour ce projet.
- Configurez l’écran de consentement OAuth (l’écran que Google affiche quand vous autorisez l’application) : nom de l’application, e-mail d’assistance et coordonnées du développeur. Avec Google Workspace, vous pouvez choisir le type d’utilisateur Interne pour réserver l’application à votre organisation.
- Créez des identifiants de type ID client OAuth avec le type d’application Application Web.
- Dans URI de redirection autorisés, collez l’URI de redirection autorisée affichée dans MailerPress (voir la section suivante). Elle doit correspondre exactement.
- Copiez l’ID client et le code secret du client.
- Si l’application utilise le type d’utilisateur Externe, publiez-la (statut « En production »). Tant qu’une application est en mode « Test », Google révoque son accès au bout de 7 jours et MailerPress cesse d’envoyer.
Connecter Gmail dans MailerPress
- Allez dans MailerPress > Intégrations, onglet Services d’envoi d’e-mails.
- Sur la carte Gmail, cliquez sur Configurer.
- Copiez l’URI de redirection autorisée dans votre client OAuth Google, si ce n’est pas déjà fait.
- Collez le Gmail API Client ID et le Gmail API Client Secret.
- Cliquez sur Connecter Gmail. Le bouton reste désactivé tant que les deux champs ne sont pas remplis. MailerPress enregistre les réglages et ouvre l’écran d’autorisation de Google.
- Choisissez le compte Google d’envoi et acceptez les autorisations demandées. Si Google signale que l’application n’est pas validée, continuez : vous en êtes le propriétaire.
- Google vous renvoie vers l’administration WordPress. Revenez si besoin dans MailerPress > Intégrations : la carte Gmail figure désormais dans Fournisseurs configurés. Activez son interrupteur Activer, puis cliquez sur Définir comme fournisseur principal.
Choisir l’adresse d’expédition
Les réglages Gmail ne comportent pas de champ d’expéditeur. MailerPress utilise l’expéditeur choisi dans chaque campagne, ou votre expéditeur par défaut défini dans MailerPress > Réglages > Général (voir Personnaliser le nom et l’e-mail de l’expéditeur par défaut). Utilisez l’adresse du compte Google connecté, ou un alias ajouté à ce compte dans Gmail. Sinon, Gmail peut remplacer l’adresse d’expédition par celle de votre compte.
Envoyer un e-mail de test
- Sur la carte Gmail, ouvrez le menu Actions (trois points) et cliquez sur Envoyer un e-mail de test.
- Saisissez un destinataire dans Envoyer à et cliquez sur Envoyer.
Vous devez recevoir un e-mail intitulé « Il s’agit d’un test de méthode d’envoi ». En cas d’échec, MailerPress affiche l’erreur Gmail, par exemple un jeton d’accès expiré ou invalide (401), des autorisations manquantes (403) ou trop de requêtes (429).
Respecter les limites d’envoi de Gmail
Allez dans MailerPress > Réglages > Fréquence d’envoi. Lorsque Gmail est le fournisseur principal, MailerPress affiche un avertissement sur les limites quotidiennes de Gmail et propose deux profils :
| Profil | Réglages | E-mails par heure |
|---|---|---|
| Gmail gratuit (limite de 500/jour) (recommandé) | 20 e-mails toutes les 10 minutes, 2 e-mails/seconde | 120 |
| Google Workspace (limite de 2 000/jour) | 50 e-mails toutes les 10 minutes, 5 e-mails/seconde | 300 |
Ces profils règlent le rythme d’envoi, pas le total quotidien. Le chiffre « par jour » affiché par MailerPress est un maximum théorique : la limite quotidienne de Google s’applique toujours et les e-mails au-delà sont refusés. Gardez chaque campagne, ajoutée à vos autres e-mails de la journée, sous cette limite. Consultez Comment modifier votre fréquence d’envoi dans MailerPress.
Suivi des rebonds
Le suivi des rebonds (détection automatique des e-mails renvoyés comme non distribuables) n’est pas disponible avec Gmail : les messages de rebond arrivent dans la boîte du compte connecté. Pour une gestion automatique des rebonds, utilisez un service qui la prend en charge (voir Choisir et configurer votre service d’envoi d’e-mails).
Dépannage
- Un message d’erreur s’affiche en haut des réglages Gmail : MailerPress n’a pas pu renouveler l’accès à votre compte (autorisation expirée ou révoquée). Corrigez la cause, puis cliquez à nouveau sur Connecter Gmail.
- La connexion s’arrête au bout de quelques jours : votre application OAuth est encore en mode « Test ». Publiez-la dans Google Cloud, puis reconnectez Gmail.
- Google affiche une erreur de redirection (redirect_uri_mismatch) : l’URI de votre client OAuth ne correspond pas à l’URI de redirection autorisée affichée dans MailerPress (vérifiez http/https et www).
- Les e-mails échouent après un certain nombre d’envois dans la journée : vous avez atteint la limite quotidienne de Gmail. Attendez sa réinitialisation ou passez à un autre service d’envoi.