API Gmail : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API Gmail donne un accès programmatique aux boîtes e-mail de Gmail et de Google Workspace : messages, conversations, libellés et brouillons. Les entreprises qui veulent automatiser le tri, les réponses et l'enregistrement des e-mails dans d'autres systèmes l'utilisent. L'accès se fait par OAuth 2.0 avec un projet Google Cloud.
Ce que propose l’API Gmail
Messages et conversations
Lecture, recherche avec la même syntaxe que Gmail, envoi et déplacement des e-mails et des fils de discussion.
Brouillons
Création et modification de brouillons qui peuvent être relus avant l'envoi.
Libellés
Création et application de libellés pour organiser la boîte.
Pièces jointes
Téléchargement et envoi des fichiers joints.
Notifications push
Alertes de changement dans la boîte via Google Cloud Pub/Sub.
Paramètres
Filtres, réponses automatiques, transfert et signatures.
Comment accéder à l’API Gmail
- Avec les identifiants de votre entrepriseOAuth 2.0 avec un projet Google Cloud et des scopes Gmail ; sur les comptes Workspace, l'administrateur peut autoriser un compte de service avec délégation à l'échelle du domaine.
- Les scopes Gmail étendus sont classés comme restreints par Google et peuvent exiger une vérification de l'application.
- Des quotas d'utilisation s'appliquent par utilisateur et par projet.
- Les e-mails contiennent des données personnelles et confidentielles : limitez les boîtes auxquelles l'agent accède.
Documentation officielle: developers.google.com/gmail/api
Ce qu’un agent iTeam fait avec l’API Gmail
Tri de la boîte commerciale
L'agent lit les e-mails de contact@, les classe par sujet, crée le lead dans le CRM et prépare un brouillon de réponse que le commercial relit.
Factures et échéances de fournisseurs
Les pièces jointes de facture sont identifiées, enregistrées dans le bon dossier et saisies comme dette à payer pour contrôle.
Relance qu'on n'oublie pas
L'agent suit les propositions envoyées et, sans réponse au bout du délai convenu, suggère une relance dans le ton de l'entreprise.
Synthèse de boîte pour la direction
Les dirigeants reçoivent chaque jour un résumé des e-mails qui demandent une décision, séparés du reste.
De l’identifiant à l’agent au travail, avec validation
Créer le projet dans Google Cloud
Activez l'API Gmail, configurez l'écran de consentement et choisissez les scopes minimaux, comme la lecture et les brouillons.
Autoriser les boîtes dans iTeam
Chaque boîte est autorisée par OAuth ou par délégation de l'administrateur ; le jeton est conservé dans le coffre et vous définissez ce que chaque agent peut faire.
Commencer par les brouillons
Au début, l'agent ne crée que des brouillons et des libellés ; l'envoi direct n'est autorisé que plus tard, pour les messages à faible risque.
Équipes IA prêtes à l’emploi qui utilisent Gmail
Prospection commerciale
L'équipe construit la liste de comptes, trouve le bon interlocuteur et prépare un premier message qui parle de son entreprise, pas de la vôtre.
Factures fournisseurs
Les factures sont repérées dans Gmail, lues, contrôlées contre la commande et préparées pour un paiement que vous validez.
Relances et recouvrement
Les factures échues sont relancées par e-mail ou WhatsApp selon votre calendrier, et les clients en difficulté arrivent chez une personne.
Tenue comptable
Les pièces sont collectées, les écritures préparées et les anomalies repérées, pour que le collaborateur passe son temps à réviser et à conseiller.
Recrutement et tri des CV
Les candidatures sont lues selon vos critères, les meilleurs profils remontent avec une explication, et les entretiens se calent sans échange d'e-mail…
Achats et devis fournisseurs
Les demandes de prix partent aux fournisseurs, les devis sont comparés ligne par ligne et l'acheteur décide avec l'historique sous les yeux.
Questions sur l’API Gmail
L'API Gmail est-elle gratuite ?
Oui, en règle générale l'usage de l'API n'est pas facturé dans la limite des quotas de Google ; le coût est celui du compte Gmail ou Workspace.
Faut-il savoir programmer pour utiliser l'API Gmail avec iTeam ?
Non. iTeam se connecte déjà à Gmail et l'équipe de déploiement vous aide pour le projet Google Cloud et les autorisations.
L'agent envoie-t-il des e-mails en mon nom sans que je les voie ?
Seulement si vous l'autorisez. Par défaut, l'agent prépare des brouillons et les envoie après votre approbation.