Connectez votre compte Gmail à Goodweek pour lire, envoyer et gérer des e-mails directement depuis votre espace de travail IA.
ℹ️ Note sur la gouvernance
Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur dans Gmail, garantissant ainsi la conformité avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations spécifiques et l'accès authentifié de chaque utilisateur.
📋 Prérequis
Avant qu'un utilisateur puisse voir et connecter l'intégration Gmail, l'administrateur de votre organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, sous l'onglet Intégrations.
Configuration administrateur
Comptes Google personnels (@gmail.com)
Aucune configuration administrateur requise. Connectez-vous directement en suivant les étapes de Connexion de l'utilisateur ci-dessous.
Comptes Google Workspace (professionnel ou scolaire)
Selon la politique d'accès aux API de votre organisation, l'un des scénarios suivants peut s'appliquer.
Scénario 1 — Par défaut (accès tiers non restreint)
Tout utilisateur peut se connecter directement sans intervention de l'administrateur.
Scénario 2 — L'accès tiers est restreint (erreur admin_policy_enforced)
Un Super Administrateur Google Workspace doit marquer Composio comme application de confiance :
Connectez-vous à admin.google.com en tant que Super Administrateur.
Accédez à Sécurité → Contrôle des accès et des données → Contrôles des API → Gérer l'accès des applications tierces.
Cliquez sur Configurer une nouvelle application, recherchez Composio, sélectionnez-le, définissez l'accès sur Approuvée et cliquez sur Enregistrer.
Scénario 3 — Tout accès tiers aux API est bloqué
Accédez à admin.google.com → Sécurité → Contrôles des API et vérifiez le paramètre « Accès des applications tierces aux API Google ». S'il est bloqué, l'administrateur doit créer une exception pour Composio avant de suivre le Scénario 2.
Connexion de l'utilisateur
Dans Goodweek, accédez à Intégrations.
Recherchez Gmail et cliquez sur Connecter.
Vous serez redirigé vers Google, où il vous sera demandé de vous connecter.
Vérifiez les autorisations demandées et cliquez sur Autoriser pour revenir à Goodweek.
Remarques importantes
Chaque utilisateur doit connecter son propre compte individuellement.
Goodweek ne peut accéder qu'aux e-mails et données auxquels votre compte utilisateur individuel a accès.
Si vous avez plusieurs comptes Google, veillez à sélectionner le bon lors de l'étape de connexion. Google peut présélectionner automatiquement le dernier compte utilisé.
Les jetons OAuth Gmail peuvent être invalidés si l'administrateur de votre Google Workspace modifie la durée de session ou les politiques d'accès aux API. Si l'intégration cesse de fonctionner de manière inattendue, essayez de la déconnecter puis de la reconnecter.
Vous pouvez révoquer l'accès de Goodweek à tout moment depuis myaccount.google.com → Sécurité → Applications tierces ayant accès au compte.
Outils disponibles
Outil | Description | Type |
Send Email | Envoie immédiatement un e-mail via l'API Gmail en utilisant le nom d'affichage de l'utilisateur authentifié. | Écriture |
Reply to Email Thread | Envoie une réponse dans un fil Gmail spécifique, en conservant l'objet d'origine et le contexte du fil. | Écriture |
Forward Email Message | Transfère un message Gmail existant à des destinataires spécifiés, en conservant le corps et les pièces jointes d'origine. | Écriture |
Create Email Draft | Crée un brouillon d'e-mail Gmail sans l'envoyer, pour une relecture avant l'envoi. | Écriture |
Update Draft | Remplace le contenu d'un brouillon Gmail existant directement à partir de son ID. | Écriture |
Send Draft | Envoie un brouillon existant tel quel à ses destinataires définis. | Écriture |
Get Draft | Récupère un brouillon Gmail unique à partir de son ID. | Lecture |
List Drafts | Récupère une liste paginée des brouillons d'e-mails du compte Gmail de l'utilisateur. | Lecture |
Fetch Emails | Récupère une liste de messages e-mail d'un compte Gmail avec filtrage, pagination et récupération facultative du contenu complet. | Lecture |
Fetch Message by Message ID | Récupère un message e-mail spécifique à partir de son ID. | Lecture |
Fetch Message by Thread ID | Récupère tous les messages d'un fil Gmail à partir de son ID de fil. | Lecture |
List Threads | Récupère une liste de fils e-mail d'un compte Gmail avec filtrage et pagination. | Lecture |
Get Gmail Attachment | Récupère une pièce jointe spécifique d'un message Gmail à partir de son ID de pièce jointe. | Lecture |
Get Profile | Récupère les informations de profil Gmail, y compris l'adresse e-mail et les statistiques de la boîte de réception. | Lecture |
Get Contacts | Récupère les contacts du compte Google authentifié, avec sélection facultative des champs et pagination. | Lecture |
Search People | Recherche des contacts en comparant une requête aux noms, e-mails, numéros de téléphone et organisations. | Lecture |
Modify Email Labels | Ajoute ou supprime des libellés Gmail sur un message spécifique. | Écriture |
Batch Modify Gmail Messages | Modifie les libellés sur jusqu'à 1 000 messages Gmail en un seul appel API. | Écriture |
Create Label | Crée un nouveau libellé Gmail portant un nom unique dans le compte de l'utilisateur. | Écriture |
List Gmail Labels | Récupère tous les libellés système et créés par l'utilisateur pour un compte Gmail. | Lecture |
Create Gmail Filter | Crée un nouveau filtre Gmail avec des critères et des actions spécifiques pour organiser le courrier entrant. | Écriture |
List Gmail Filters | Répertorie tous les filtres Gmail (règles) de la boîte de réception. | Lecture |
Get Vacation Settings | Récupère les paramètres du répondeur d'absence pour vérifier si les réponses automatiques d'absence sont actives. | Lecture |
Update Vacation Settings | Configure les paramètres de réponse automatique d'absence pour un utilisateur Gmail. | Écriture |
Move to Trash | Déplace un message e-mail vers la corbeille (récupérable). | ⚠️ Destructif |
Trash Thread | Déplace un fil e-mail entier et tous ses messages vers la corbeille. | ⚠️ Destructif |
Batch Delete Gmail Messages | Supprime définitivement plusieurs messages Gmail en bloc, en contournant la corbeille, sans possibilité de récupération. | ⚠️ Destructif |
Delete Thread | Supprime de manière définitive et immédiate un fil et tous ses messages. Cette action est irréversible. | ⚠️ Destructif |
Cas d'usage
Envoyez et répondez à des e-mails depuis Goodweek. Rédigez, envoyez et répondez à des messages Gmail directement au sein d'une conversation Goodweek, en gardant la communication par e-mail dans le contexte du travail que vous effectuez déjà.
Lisez et faites apparaître les e-mails pertinents à la demande. Recherchez dans votre boîte de réception par expéditeur, objet ou mots-clés pour récupérer des e-mails spécifiques et les intégrer à une conversation Goodweek pour consultation ou référence.
Rédigez des brouillons d'e-mails à relire avant l'envoi. Créez des brouillons d'e-mails dans Gmail via Goodweek, puis relisez-les et envoyez-les au bon moment — utile lorsque vous devez préparer des communications à l'avance.
Gérez l'organisation de votre boîte de réception. Appliquez des libellés aux e-mails, créez des filtres Gmail pour le courrier entrant ou déplacez des messages vers la corbeille depuis Goodweek afin de garder votre boîte de réception organisée sans passer par l'interface Gmail.
Dépannage
« Error 400 : admin_policy_enforced » lors de la connexion
Il s'agit du problème le plus courant pour les utilisateurs de Google Workspace. Seul un Super Administrateur Google Workspace peut le résoudre en suivant le Scénario 2 ci-dessus.
L'administrateur a marqué Composio comme approuvée, mais l'erreur persiste
Il peut y avoir un délai de propagation. Patientez quelques minutes et réessayez. Si l'erreur persiste, vérifiez que l'application Composio correcte a été sélectionnée et que le niveau d'accès a bien été enregistré sur Approuvée et non sur Limitée.
Connexion établie avec le mauvais compte Google
Déconnectez l'intégration de Goodweek, puis reconnectez-la. Cliquez sur « Utiliser un autre compte » lors de l'étape d'authentification Google, ou ouvrez une fenêtre de navigation privée pour éviter la sélection automatique du compte.
L'intégration a cessé de fonctionner après une connexion réussie
Il se peut que l'administrateur de votre Google Workspace ait modifié les politiques d'accès aux API. Essayez de déconnecter puis de reconnecter l'intégration. Si le problème persiste, demandez à votre administrateur de vérifier que Composio est toujours marquée comme Approuvée.
Intégration non visible dans Goodweek
Assurez-vous que l'administrateur de votre organisation a activé l'intégration Gmail depuis le Panneau d'administration Goodweek, sous l'onglet Intégrations.