Google Workspace

Avec Google Workspace, Gensy écrit la signature Gmail de chaque employé par l’API. L’employé n’a rien à installer. À partir du forfait Démarrage.

Ce qu’il vous faut

• Être propriétaire de l’espace Gensy: lui seul connecte ou déconnecte l’intégration. Déconnecter n’efface pas les signatures déjà posées dans Gmail et bloque ensuite les déploiements Gmail: faites Tout dépublier avant de déconnecter.
• Un compte super-administrateur du domaine Google.
• Rien à activer dans votre propre console Google Cloud: Gensy utilise son propre compte de service.
• La délégation au niveau du domaine (console d’administration Google → Sécurité → Contrôle des accès et des données → Commandes des API) accordée au compte de service de Gensy, avec les portées gmail.settings.basic, gmail.settings.sharing et admin.directory.user.readonly. L’identifiant client de ce compte de service n’est pas affiché dans l’application: demandez-le au support.

Le guide d’installation Google, dans l’interface, détaille chaque étape.

Connecter

1. Ouvrez Paramètres → Intégrations.
2. Cliquez Connecter Google Workspace et connectez-vous avec le compte super-administrateur.
3. Google ne demande que votre identité: cet écran n’accorde aucun accès à Gmail et aucun jeton n’est conservé. Gensy vérifie que le compte est super-administrateur et affiche le domaine connecté; sinon, l’onglet dit pourquoi. Connecter Google ne change pas le mode de déploiement.
4. Dans Déploiement, passez en mode Déploiement automatisé et cliquez Tout déployer.

La preuve d’administration

Gensy vérifie à la connexion que le compte est bien super-administrateur. Cette preuve vaut 30 jours et se renouvelle d’elle-même, au plus une fois par jour, à chaque déploiement vers Gmail (déploiement, planification, retrait, synchronisation quotidienne des campagnes); sans déploiement Gmail pendant 30 jours, elle expire. Quatre situations bloquent les déploiements Gmail:

• la preuve est manquante;
• la preuve est expirée (30 jours sans déploiement vers Gmail);
• le compte n’est plus super-administrateur, ou n’est plus celui qui a consenti;
• la portée admin.directory.user.readonly manque à la délégation.

Les trois premières se règlent en reconnectant Google Workspace avec un compte super-administrateur. La quatrième s’ajoute dans la console d’administration Google; la vérification reprend d’elle-même, sans reconnexion. Chaque cas est expliqué par un bandeau dans l’onglet Intégrations, et le refus s’affiche dans la fenêtre d’erreur du déploiement; une planification ou la synchronisation des campagnes lève en plus une alerte.

Ce que voit l’employé

La signature apparaît dans les paramètres Gmail de l’employé, sans action de sa part. Gmail garde la version poussée jusqu’au prochain déploiement ou à la synchronisation quotidienne. Les employés Google Workspace sont confirmés directement par l’API Gmail.

Plusieurs domaines

C’est possible si les domaines sont gérés dans le même espace d’administration Google Workspace.

En cas d’erreur

• Autorisation refusée (invalid_grant) — Google refuse l’autorisation du compte de service de Gensy: vérifiez la délégation au niveau du domaine et ses portées dans la console d’administration Google.
• Délégation manquante ou incomplète — ajoutez le compte de service de Gensy et ses portées dans la console d’administration Google (Délégation au niveau du domaine).