Aller au contenu
All articles
Integrations

Connecter Gmail / Outlook (OAuth) et synchroniser les e-mails

Connectez votre compte Google Workspace (Gmail) ou Microsoft 365 (Outlook) via OAuth, en utilisant l'application OAuth de votre propre organisation, et enregistrez automatiquement les e-mails comme activités sur vos contacts.

💡 D'anciens e-mails s'affichaient tronqués ? Après la connexion, cliquez sur « Récupérer l'historique complet » sur la carte : le CRM récupère le texte intégral des anciens messages qui n'avaient conservé que l'aperçu. Vous pouvez le répéter en toute sécurité (il ne raccourcit jamais ce qui est déjà complet). Les pièces jointes des e-mails sont aussi téléchargées et conservées.

Vous pouvez connecter votre boîte Google Workspace (Gmail) ou Microsoft 365 (Outlook) au CRM. Une fois connecté, le CRM lit vos e-mails récents et, pour chaque message dont l'expéditeur ou le destinataire correspond à un Contact ou un Lead (par e-mail), enregistre une activité « e-mail » sur la chronologie de cet enregistrement.

Le modèle est BYO (« bring your own », apportez votre propre app) : vous utilisez l'application OAuth de votre propre organisation. Nous ne voyons jamais vos identifiants et il n'y a aucun coût de notre côté. L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas configuré l'application OAuth et connecté le compte.

Prérequis

  • Un compte Google Workspace (Gmail) OU Microsoft 365 (Outlook). Votre compte professionnel habituel convient.
  • La permission de créer une application OAuth dans votre organisation : accès à la Google Cloud Console (Gmail) ou au portail Azure / Microsoft Entra ID (Outlook). Dans les entreprises, cela nécessite généralement un administrateur informatique.
  • Dans Sellio, un accès administrateur (permission de gérer les paramètres) pour enregistrer les identifiants de l'application dans Paramètres → Intégrations. La connexion de la boîte e-mail elle-même (Étape 3) est effectuée par chaque utilisateur pour son propre compte.

Étape 1 : Créer l'application OAuth de votre organisation

Google Workspace (Gmail) : dans la Google Cloud Console, créez un projet, configurez l'écran de consentement OAuth, activez l'API Gmail et créez un identifiant « ID client OAuth » (Application Web). Copiez l'ID client et le secret client.

Microsoft 365 (Outlook) : dans le portail Azure, allez dans Microsoft Entra ID → Inscriptions d'applications → Nouvelle inscription. Sous « Certificats et secrets », générez un secret client. Sous « Autorisations API », ajoutez Microsoft Graph avec les autorisations déléguées Mail.Read et User.Read. Copiez l'ID client (ID d'application) et le secret client.

💡 Pour les deux fournisseurs, enregistrez EXACTEMENT l'URI de redirection affichée sur la carte d'intégration (elle se termine par /api/oauth/google/callback ou /api/oauth/microsoft/callback). Elle doit être identique, sinon le fournisseur refusera la connexion.

Étape 2 : Coller les identifiants dans le CRM

  1. Ouvrez Paramètres → Intégrations et trouvez la carte « Google Workspace (Gmail) » ou « Microsoft 365 (Outlook) ».
  2. Copiez l'URI de redirection affichée et enregistrez-la dans votre application OAuth (Étape 1).
  3. Collez l'ID client et le secret client puis cliquez sur « Enregistrer les identifiants de l'application ». Le secret client est stocké chiffré et n'est plus jamais réaffiché.

Étape 3 : Connecter votre compte

  1. Toujours sur la carte, cliquez sur « Connecter ». Vous serez redirigé vers l'écran de consentement du fournisseur, déjà connecté à votre compte.
  2. Autorisez l'accès en lecture aux e-mails. Vous revenez au CRM et la carte affiche désormais « Connecté en tant que » avec l'adresse du compte.
  3. Cliquez sur « Synchroniser les e-mails » pour récupérer les e-mails récents immédiatement. Le CRM vous indique combien d'e-mails il a lus et combien d'activités il a créées.

Chaque utilisateur connecte sa propre boîte e-mail : la synchronisation s'exécute dans le contexte de celui qui l'a connectée. Les e-mails deviennent des activités seulement lorsque l'expéditeur ou le destinataire correspond à un Contact ou un Lead existant (via le champ e-mail). Les e-mails qui ne correspondent à aucun enregistrement sont ignorés.

Sécurité et confidentialité

Les jetons d'accès et de rafraîchissement sont stockés chiffrés et ne sont jamais affichés. Le jeton d'accès est renouvelé automatiquement à son expiration, sans nouvelle connexion. La connexion e-mail est totalement distincte de votre connexion au CRM : la connecter ou la déconnecter ici ne modifie pas votre façon de vous connecter au système.

💡 Pour révoquer l'accès, cliquez sur « Déconnecter » sur la carte, et les jetons stockés sont supprimés. Vous pouvez vous reconnecter à tout moment. Si la connexion expire (par exemple après un changement de mot de passe du compte), utilisez « Reconnecter ».
Example: URI de redirection à enregistrer : https://app.yourcompany.com/api/oauth/google/callback (Google) ou https://app.yourcompany.com/api/oauth/microsoft/callback (Microsoft).

Comment tester

  1. Après la connexion (Étape 3), vérifiez que la carte affiche « Connecté en tant que » avec la bonne adresse.
  2. Cliquez sur « Synchroniser les e-mails ». Le CRM vous indique combien d'e-mails il a lus et combien d'activités il a créées.
  3. Ouvrez un Contact ou un Lead dont vous savez qu'il a récemment échangé des e-mails et vérifiez la chronologie : une activité de type « E-mail » devrait apparaître.

Dépannage

  • Erreur « redirect_uri_mismatch » ou le fournisseur refuse la connexion : l'URI de redirection enregistrée dans l'application OAuth diffère de celle affichée sur la carte. Copiez-la à nouveau et collez-la EXACTEMENT à l'identique (même domaine, même barre oblique finale).
  • 401/invalid_client lors de la connexion : ID client ou secret client incorrect. Ressaisissez les identifiants sur la carte (le secret n'est jamais renvoyé par le serveur, donc recollez-le entièrement).
  • La connexion réussit mais ne crée pas d'activités : les e-mails ne deviennent des activités que lorsque l'expéditeur/destinataire correspond à un Contact ou un Lead via le champ e-mail. Les e-mails sans correspondance sont ignorés, donc ajoutez l'e-mail à l'enregistrement.
  • « Accès refusé » / écran de consentement bloqué : sur Google, publiez l'écran de consentement OAuth (ou ajoutez l'utilisateur comme testeur) ; sur Azure, accordez le consentement administrateur aux autorisations.
  • La connexion a cessé de fonctionner (par ex. après un changement de mot de passe du compte) : cliquez sur « Reconnecter » sur la carte pour refaire le consentement et renouveler les jetons.

Open this article inside the system

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

Créer un compte gratuit
Connecter Gmail / Outlook (OAuth) et synchroniser les e-mails · Sellio