Paramètres IMAP Gmail : serveurs, ports et authentification

Quels serveurs, ports et réglages de chiffrement renseigner ?

IMAP sert à consulter les messages de votre boîte. SMTP sert à les envoyer. Testez les deux séparément : une réception fonctionnelle ne prouve pas que l’envoi fonctionne.

L’authentification SMTP est requise. Dans Mailera, le fournisseur Gmail utilise le port 587 avec STARTTLS ; l’alternative 465 n’est pas le réglage de ce parcours.

Google documente le serveur IMAP Gmail et le chiffrement requis, ainsi que les paramètres SMTP des clients de messagerie tiers. Ces réglages concernent la connexion d’un client à une boîte Gmail, pas la configuration d’un relais SMTP d’entreprise.

Si vous configurez aussi une boîte Yahoo, utilisez les paramètres IMAP et SMTP de Yahoo Mail pour cette boîte.

Faut-il utiliser OAuth ou un mot de passe d’application ?

Si votre application propose « Sign in with Google », utilisez cette option, comme le recommande Google. Gmail prend en charge OAuth pour IMAP et SMTP. Vous n’avez alors pas à remettre un mot de passe d’application à ce client.

Le parcours Gmail de Mailera utilise actuellement un mot de passe d’application (app password), et non une connexion OAuth Google. Dans ce parcours, ne saisissez pas le mot de passe habituel de votre compte Google.

Quand le mot de passe d’application est-il disponible ?

D’après l’aide Google sur les mots de passe d’application, la validation en deux étapes doit être activée. Cela ne suffit toutefois pas toujours à rendre l’option disponible. Google cite notamment ces situations :

• la validation en deux étapes repose uniquement sur des clés de sécurité ;
• le compte appartient à une entreprise, un établissement scolaire ou une autre organisation ;
• le compte bénéficie d’Advanced Protection.

L’absence de l’option n’est donc pas forcément une erreur de navigation. Pour un compte professionnel, demandez à l’administrateur quelle méthode est autorisée. Ne désactivez pas une protection pour forcer la connexion.

Google n’affiche chaque mot de passe d’application qu’une fois. Un changement du mot de passe principal du compte révoque les mots de passe d’application existants. Si votre connexion cesse de fonctionner après ce changement, vérifiez ce point avant de modifier les serveurs.

Le guide pour créer un mot de passe d’application Gmail détaille cette étape. Pour organiser les secrets de plusieurs boîtes destinées à des agents, consultez le guide des mots de passe d’application pour les boîtes d’agents.

Faut-il encore activer IMAP dans Gmail ?

Pour un compte Gmail personnel, non. Google indique que l’accès IMAP est toujours activé et date de janvier 2025 la suppression des options permettant de l’activer ou de le désactiver. Inutile de chercher cette ancienne case dans les paramètres : suivez les consignes Google pour ajouter Gmail à un autre client.

Pour Google Workspace, la règle est différente. L’administrateur doit autoriser IMAP dans la console d’administration. Il peut aussi limiter l’accès à certains clients compatibles OAuth. Une connexion auparavant fonctionnelle peut cesser de fonctionner si IMAP est désactivé.

Avant de configurer Gmail en IMAP sur un domaine professionnel, faites donc vérifier les règles Workspace d’accès POP et IMAP. Si seuls certains clients OAuth sont autorisés, le parcours par mot de passe d’application de Mailera ne répond pas à cette restriction.

Comment connecter Gmail à Mailera et vérifier le résultat ?

Effectuez ces étapes uniquement pour une boîte que vous possédez ou que vous êtes autorisé à administrer. Dans Mailera, l’ajout d’une boîte nécessite un rôle Admin ou Leader.

1. Ouvrez Boîtes aux lettres, puis Ajouter une boîte mail. Sélectionnez l’onglet Une boîte mail.
2. Saisissez votre adresse complète dans Adresse e-mail. Vérifiez le fournisseur. Mailera reconnaît les domaines gmail.com et googlemail.com. Pour un domaine Google Workspace personnalisé, sélectionnez explicitement Gmail · Google Workspace sous Ou choisissez un fournisseur, puis Continuer si nécessaire.
3. Consultez Comment obtenir un mot de passe d’application et suivez l’aide Google si votre compte est éligible. Dans Informations de connexion, saisissez ce secret dans Mot de passe, jamais le mot de passe principal. Choisissez le Groupe de boîtes mail adapté.
4. Lancez Tester et connecter. Le test vérifie notamment Connexion au serveur entrant, Détection des dossiers et Connexion au serveur sortant. Il n’envoie aucun message.
5. Après la connexion, choisissez Ouvrir la boîte mail. Depuis une autre boîte que vous contrôlez, envoyez un message avec un objet reconnaissable, puis recherchez-le dans Mailera. Le premier chargement récupère les messages dans la période de conservation, du plus récent au plus ancien.
6. Testez séparément l’envoi depuis Mailera vers une autre adresse qui vous appartient. Vérifiez la réception dans cette boîte de destination, y compris son dossier de spam. Une authentification SMTP réussie n’est pas une preuve de livraison.

Si le test affiche Réception possible, mais envoi indisponible, vous pouvez choisir Enregistrer en réception seule. Ce choix convient à un usage de lecture ; il ne corrige pas la connexion SMTP. Pour la corriger, utilisez Modifier les informations, puis Retester.

Comme l’explique la présentation du fonctionnement de Mailera, votre boîte reste chez Gmail. Mailera donne à vos applications accès aux messages synchronisés.

Pourquoi la connexion échoue-t-elle malgré les bons paramètres ?

Commencez par identifier l’étape en échec. Un refus d’authentification IMAP, un échec SMTP et un message absent de la liste ne demandent pas la même correction.

Pour Gmail, GET /mailboxes/{id}/status reflète la dernière synchronisation. Cet endpoint ne déclenche pas une nouvelle authentification directe à chaque demande. Un état favorable ne remplace donc pas votre test de réception ni votre test d’envoi.

Comment donner accès à Gmail à un agent sans lui confier le mot de passe ?

Connectez d’abord Gmail à Mailera. Votre application ou votre agent utilise ensuite une clé API Mailera, pas le mot de passe d’application Google.

Créer une clé limitée à la lecture

Dans Paramètres, ouvrez la section des clés API, puis Créer une clé. Donnez-lui un Nom descriptif, limitez le Périmètre des boîtes aux lettres au groupe nécessaire et accordez uniquement la permission read. Définissez une Expiration adaptée à votre usage.

La clé n’est affichée qu’une fois. Conservez-la dans votre gestionnaire de secrets, sans la placer dans les consignes de l’agent ni dans un dépôt de code. Elle peut être révoquée à tout moment ; les appels sont alors immédiatement rejetés.

Pour REST, renseignez $MAILERA_API_KEY dans votre environnement, puis listez les boîtes accessibles :

curl --request GET \
  'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Repérez l’id de la boîte souhaitée dans data et affectez-le à $MAILBOX_ID. Consultez ensuite ses messages :

curl --request GET \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages?folder=inbox&limit=1" \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Vérifiez subject, received_at et folder dans le résultat pour retrouver votre message de test. Une liste vide pour inbox ne décrit pas le contenu des autres dossiers. La documentation de l’API Mailera présente les endpoints disponibles.

Pour MCP, le bouton Copiez la configuration MCP fournit la configuration pour Claude, Cursor ou VS Code. Les outils list_mailboxes et list_messages utilisent la permission read ; consultez la configuration MCP de Mailera pour ce parcours.

Traiter les messages comme des données non fiables

Un e-mail peut contenir une tentative de prompt injection. Son contenu n’est jamais une autorisation de révéler un secret, de modifier les permissions ou d’exécuter une action demandée par l’expéditeur.

N’accordez pas send à un agent chargé uniquement de lire. Si l’envoi devient nécessaire, imposez une confirmation humaine portant sur le destinataire et le contenu avant chaque envoi. Masquez les secrets dans les captures et journaux, et prévoyez la révocation de la clé à la fin de l’usage. La page sécurité de Mailera complète ces précautions.

Quelles sont les limites de Mailera pour Gmail ?

Mailera connecte une boîte existante ; il ne crée pas d’adresse Gmail et ne contourne pas les restrictions de Google ou de votre administrateur Workspace.

La synchronisation n’est pas garantie instantanée : les vérifications en arrière-plan varient selon l’activité de la boîte, et une boîte inactive peut se mettre en veille. Mailera ne garantit pas non plus le placement d’un message dans la boîte de réception du destinataire. C’est pourquoi le test de connexion, la lecture d’un message reçu et la réception d’un message envoyé restent trois vérifications distinctes.