Configuration Gmail (SMTP / IMAP) — Odoo 17+

Prérequis côté Google

Pour autoriser Odoo à envoyer et recevoir des e-mails via Gmail, il faut générer un mot de passe d'application. C'est un mot de passe à 16 caractères, distinct du mot de passe habituel du compte, qui permet à une application tierce de s'authentifier sans passer par le navigateur.

Activer la validation en deux étapes

La génération de mots de passe d'application n'est possible que si la validation en deux étapes (2FA) est activée sur le compte Gmail.

1. Se connecter au compte Gmail concerné.
2. Se rendre sur https://myaccount.google.com/security.
3. Dans la section « Comment vous connecter à Google », activer la Validation en deux étapes si ce n'est pas déjà fait.

Générer un mot de passe d'application

Note : Google a masqué le lien vers cette fonctionnalité dans l'interface de sécurité du compte. Il existe toujours mais n'est plus visible dans les menus. Il faut y accéder par URL directe.

1. Se rendre sur https://myaccount.google.com/apppasswords (en étant connecté avec le bon compte).
2. Saisir un nom descriptif (ex. : « Odoo Production »).
3. Cliquer sur Créer.
4. Google affiche un mot de passe au format xxxx xxxx xxxx xxxx. Le copier immédiatement — il ne sera plus jamais affiché.

Ce même mot de passe sera utilisé pour le serveur sortant (SMTP) et le serveur entrant (IMAP).

Activer l'accès IMAP dans Gmail

1. Ouvrir Gmail dans le navigateur.
2. Aller dans Paramètres (roue dentée) → Voir tous les paramètres → onglet Transfert et POP/IMAP.
3. Dans la section IMAP, cocher Activer IMAP.
4. Enregistrer les modifications.

Configuration dans Odoo 17

Serveur sortant (SMTP)

Menu : Configuration → Technique → Serveurs de messagerie sortants

Cliquer sur Tester la connexion pour valider.

Serveur entrant (IMAP)

Menu : Configuration → Technique → Serveurs de messagerie entrants

Cliquer sur Tester et confirmer. Le serveur doit passer en statut « Confirmé ».

Vérifications post-configuration

• Cron fetchmail : vérifier que l'action planifiée « Fetchmail » est bien active (Configuration → Technique → Automatisation → Actions planifiées). C'est ce cron qui interroge le serveur IMAP à intervalle régulier (5 min par défaut).
• Alias de messagerie : les e-mails entrants sont routés vers les modèles Odoo via les alias configurés sur chaque application (CRM, Helpdesk, etc.).
• Limites Google : Gmail autorise environ 500 envois/jour sur un compte gratuit et 2 000/jour sur un compte Google Workspace.