Skip to main content
Si tu n’utilises pas de helpdesk dédié et que tes clients t’écrivent simplement à contact@ta-boutique.com hébergé chez Google Workspace ou Gmail perso, Actero se connecte directement à Gmail en OAuth officiel et traite ta boîte de réception comme un mini-helpdesk.

​
Prérequis

  • Un compte Gmail ou Google Workspace actif
  • L’adresse email doit être celle utilisée pour le SAV (typiquement contact@, support@, sav@)
  • L’authentification 2FA active recommandée côté Google
  • Un compte Actero sur le plan Pro ou supérieur (l’Email Agent est inclus à partir de Pro)

​
Connexion (OAuth Google)

1

Ouvre Intégrations dans Actero

Intégrations → E-mail → Gmail → Connecter.
2

Choisis ton compte Google

Tu es redirigé vers accounts.google.com. Sélectionne le compte Gmail / Workspace qui reçoit les emails SAV.
3

Approuve les scopes Gmail

Google affiche les permissions demandées (voir ci-dessous). Coche toutes les cases, puis clique Continue puis Allow. Si tu vois un écran “Cette app n’est pas vérifiée”, clique Advanced → Continue — Actero est en cours de vérification Google et l’écran disparaîtra à la prochaine review.
4

Retour dans Actero

Tu reviens dans le dashboard avec le badge Connecté et l’adresse email rattachée. L’agent commence à relever la boîte environ toutes les 5 minutes (plus espacé quand beaucoup de boîtes sont actives).

​
Scopes demandés

L’accès gmail.modify est obligatoire. Si tu décoches cette case sur l’écran de Google, Actero refuse la connexion et affiche : « Gmail n’a pas été connecté : il manque un des accès demandés sur l’écran de Google. » Relance la connexion depuis Intégrations et coche toutes les cases.
Actero ne télécharge pas ta boîte historique. Seuls les emails arrivés après la connexion (3 jours au plus) sont lus, et seuls ceux qui passent les règles ci-dessous déclenchent une réponse.

​
Filtrage : quels emails l’agent traite

L’agent traite uniquement les emails qui :
  • sont non lus et dans la boîte de réception principale (pas Promotions / Updates / Forums, pas les spams) ;
  • sont arrivés après la connexion de ta boîte, depuis 3 jours au plus ;
  • ne sont pas un message automatique (réponse automatique, liste de diffusion) ;
  • ne viennent pas d’un expéditeur exclu.
Les expéditeurs exclus se règlent dans Mon agent → Agent Email, au même endroit que ta signature. Un email que l’agent laisse de côté (message automatique, expéditeur exclu, agent en pause) reste non lu dans ta boîte : ton équipe le voit comme avant.

​
Réponse automatique ou « À traiter »

Dans Mon agent → Agent Email, l’interrupteur Répondre automatiquement aux emails décide de ce que fait l’agent :
  • Activé : l’agent répond seul, depuis ton adresse, dans le fil de la conversation et avec ta signature, quand sa confiance atteint le Seuil de confiance IA réglé dans Agent Email (80 % par défaut) et hors de tes Heures silencieuses. Sinon, la conversation va dans À traiter (motif « Reçu pendant tes heures calmes », ou une confiance sous le seuil).
  • Désactivé : l’agent ne répond pas. La conversation arrive dans À traiter, avec le motif « Réponse automatique désactivée » : tu lis, puis tu réponds depuis Actero.
Dans les deux cas, l’agent ne dépose aucun brouillon dans ton dossier Gmail. Quand il traite un email, il le marque comme lu ; il ne crée aucun label et n’archive rien.
Pour démarrer prudemment, laisse la réponse automatique désactivée quelques jours : tu vois dans À traiter ce que l’agent aurait répondu, et tu envoies toi-même les réponses qui te conviennent.

​
Quotas Gmail

Google limite le nombre d’envois par jour, moins pour un Gmail personnel que pour un compte Google Workspace. Si tu dépasses ces volumes, utilise Resend (envois transactionnels illimités) ou SMTP/IMAP avec ton propre serveur.

​
Déconnexion

Intégrations → E-mail → Gmail → Déconnecter révoque le token Google. Tu peux aussi le faire depuis myaccount.google.com/permissions en supprimant l’app Actero.

​
Problèmes fréquents

Actero est en processus de Google App Verification (plusieurs semaines de review Google). En attendant, tu peux cliquer Advanced → Continue to actero.fr (unsafe) sans risque réel : les scopes restent les mêmes, seul le badge “verified” manque. La review Google ne change rien aux permissions.
Le polling Gmail tourne environ toutes les 5 minutes, plus espacé quand beaucoup de boîtes sont actives. Si après 15 minutes ton email reste sans réponse, vérifie : (1) l’email est bien dans Inbox primaire (pas Promotions), (2) la réponse automatique est activée dans Agent Email (sinon la conversation attend dans À traiter), (3) le Seuil de confiance IA est atteint et l’email n’est pas arrivé pendant tes Heures silencieuses (sinon la conversation attend aussi dans À traiter), (4) l’expéditeur n’est pas dans la liste des expéditeurs exclus.
Va dans Mon agent → Agent Email et copie/colle ta signature Gmail dans les réglages. Actero ne lit pas automatiquement la signature configurée dans Gmail.
Tu as décoché l’accès gmail.modify sur l’écran de consentement Google. Sans lui, l’agent ne peut ni lire tes e-mails ni y répondre. Relance la connexion depuis Intégrations → E-mail → Gmail et coche toutes les cases avant de cliquer Continue.
Cela arrive si tu as révoqué l’app dans myaccount.google.com ou changé ton mot de passe. Reconnecte simplement depuis Intégrations → E-mail → Gmail.

​
FAQ

Sur le plan Entreprise, oui. Sur les autres plans, une seule connexion Gmail par compte Actero. Tu peux toujours mettre des forwards dans Gmail pour rediriger plusieurs adresses vers la principale.
Oui. L’OAuth Google reste standard, ton SSO te demande juste de te ré-authentifier au moment de l’autorisation.
Gmail OAuth est plus sûr (pas de mot de passe stocké) et plus rapide à configurer. SMTP/IMAP est utile si tu n’es pas sur Google (OVH Mail, ProtonMail Bridge, serveur custom).