Intégration Gmail
Envoyez depuis votre adresse Gmail ou Google Workspace, consultez votre boîte de réception directement dans Forge CRM, et suivez ouvertures et clics de chaque email. OAuth 2.0 avec refresh automatique, tokens chiffrés AES-256-GCM, mapping transparent des labels Gmail sur la navigation Outlook-style de Forge.
Ce que vous obtenez
Envoi depuis votre Gmail
Vos emails partent via l'API Gmail v1 depuis votre adresse, avec votre signature HTML Tiptap. Ils apparaissent dans votre dossier Envoyés Gmail comme un message natif.
Inbox Gmail dans Forge
Boîte de réception, Envoyés, Brouillons, Indésirables et Archive navigables dans /messaging. Les labels Gmail sont mappés sur les dossiers Outlook-style pour une UX cohérente.
Tracking ouvertures & clics
Pixel transparent + redirections de liens. Attention : Gmail charge les images via ses proxys serveur — Forge déduplique par IP (fenêtre 5 min) pour éviter le faux positif au moment de la réception.
Exclusion mutuelle avec Outlook
Pour éviter la double-envoi et l'ambiguïté, un seul provider email actif par utilisateur. Connecter Gmail déconnecte Outlook (et inversement), avec badge provider affiché dans le compose.
Signature partagée
Votre signature HTML (Tiptap), police et couleurs préférées sont stockées au niveau utilisateur, donc identiques que vous passiez de Gmail à Outlook.
Refresh token robuste
Mutex en mémoire sur le refresh : si plusieurs requêtes tombent en même temps sur un token expiré, un seul appel OAuth est fait. Les autres attendent le même résultat.
Comment se connecter en 2 minutes
- 1
Ouvrir les paramètres Forge
Depuis le dashboard, rendez-vous sur /settings onglet Intégrations. La section Gmail affiche un bouton « Connecter » à côté d'Outlook.
- 2
Consentement Google
Le bouton redirige vers accounts.google.com. Vous choisissez votre compte Google (personnel ou Workspace) et acceptez les scopes openid, email, profile et https://mail.google.com/.
- 3
Échange du code OAuth
Google redirige vers /api/auth/gmail/callback. Forge échange le code contre un access token et un refresh token, récupère votre email via /userinfo, et stocke le tout chiffré en base dans la table GmailToken.
- 4
Premier envoi
Depuis une fiche contact, cliquez sur « Email ». Le dialog affiche un badge vert « Gmail » pour confirmer le provider actif. Envoyez un message — il part via l'API Gmail v1, avec pixel et liens trackés, et apparaît dans votre dossier Envoyés Gmail comme un envoi natif.
Gmail vs Outlook — comment choisir ?
Les deux intégrations exposent les mêmes fonctions côté Forge : envoi depuis votre adresse, inbox dans /messaging, tracking, threading des réponses, génération IA avec rebond intelligent. Le choix se fait donc sur votre environnement existant.
- Choisissez Gmail si votre équipe est sur Google Workspace, si vos commerciaux travaillent déjà dans l'interface Gmail web ou mobile, ou si vous avez un compte @gmail.com perso pour démarrer.
- Choisissez Outlook si vous êtes sur Microsoft 365, si votre tenant Azure AD a des règles de sécurité spécifiques, ou si vous utilisez déjà des intégrations Graph ailleurs (Teams, SharePoint).
- Pas les deux en même temps — l'exclusion mutuelle est volontaire pour garantir un provider email unique et éviter les ambiguïtés lors de l'envoi.
Questions fréquentes
Mon compte @gmail.com personnel fonctionne-t-il ?
Oui. L'intégration supporte les comptes Gmail grand public (@gmail.com) et les comptes Google Workspace d'entreprise. Les deux utilisent la même API Gmail v1 avec les mêmes scopes OAuth — seule la politique de consentement change (admin Workspace pour les comptes pro avec restrictions).
Quels scopes Google sont demandés ?
Quatre scopes : openid, email, profile (identité de base pour afficher votre nom et votre adresse) et https://mail.google.com/ (envoyer, lire, déplacer et supprimer dans votre boîte). Ce dernier est le scope complet Gmail — le même que celui utilisé par des apps comme Superhuman ou Mixmax. Aucun accès à Drive, Contacts, Calendar, ou autre service Google.
Gmail et Outlook peuvent-ils être connectés en même temps ?
Non, exclusion mutuelle. Pour éviter les doubles envois et l'ambiguïté sur le provider actif, Forge impose un seul compte email connecté par utilisateur à la fois. Si vous connectez Gmail alors qu'Outlook est déjà lié, Forge déconnecte Outlook automatiquement (les tokens sont supprimés). Un badge indique clairement quel provider est actif dans le dialog de composition.
Le tracking fonctionne-t-il différemment avec Gmail ?
Le mécanisme est identique à Outlook : pixel transparent injecté dans le HTML avant envoi, liens réécrits vers /api/track/[id]/click. La grosse différence : Gmail charge automatiquement les images proxifiées via les serveurs Google. Le pixel déclenche donc un hit immédiat au serveur Google, puis un second hit quand le destinataire ouvre vraiment le mail — Forge déduplique par IP + fenêtre de 5 minutes pour éviter le faux positif.
Mes tokens Gmail sont-ils sécurisés ?
Oui, au même niveau qu'Outlook. Access token et refresh token sont chiffrés AES-256-GCM avec un sel dérivé de votre userId avant persistance. Le refresh est automatique avec une fenêtre de 5 minutes avant expiration. Un mutex en mémoire déduplique les refresh concurrents — si trois requêtes arrivent en même temps et que le token est expiré, un seul appel OAuth est fait, les trois attendent le même résultat.
Comment Gmail gère-t-il mes brouillons et mes dossiers ?
Forge mappe les dossiers Outlook-style sur les labels Gmail : Boîte de réception → INBOX, Envoyés → SENT, Brouillons → DRAFT, Indésirables → SPAM, Archive → recherche avec -label:INBOX. Vous naviguez dans Forge comme dans Outlook sans apprendre le jargon Gmail. Les brouillons créés dans Forge apparaissent aussi dans Gmail web, et inversement.
Puis-je révoquer l'accès Forge à Gmail à tout moment ?
Oui. Depuis Forge, /settings onglet Intégrations → Déconnecter. Les tokens chiffrés sont supprimés immédiatement. Côté Google, vous pouvez aussi révoquer depuis myaccount.google.com/permissions — l'app apparaît sous son nom « Forge CRM ». Les emails déjà envoyés et leur tracking restent en base, seul l'envoi futur et la lecture inbox sont désactivés.
Pour aller plus loin
L'intégration Gmail se combine très bien avec la génération IA (OpenAI & Anthropic) — chaque brouillon créé par l'assistant peut être envoyé en un clic via votre compte Gmail. Voir toutes les intégrations.
Prêt à envoyer depuis votre Gmail ?
Plan Free à vie. Sans carte bancaire. Setup en 2 minutes.
Créer mon compte gratuitement