Connecter vos services : OAuth, clé d'accès ou application personnelle

Pour qu'un bloc Voltask lise vos e-mails, écrive dans un tableur ou interroge une base de données, Voltask doit être autorisé à agir sur ce service à votre place. Cette autorisation s'appelle une connexion. Il existe trois façons de la créer. Ce guide vous aide à choisir et explique les contraintes de chacune.

À ne pas confondre. Se connecter à Voltask (votre e-mail et votre mot de passe Voltask) n'a rien à voir avec connecter un service (Gmail, Notion, OpenAI…) à un bloc. Ce guide parle uniquement de la seconde.

Les trois façons de connecter un service

1. Connexion en un clic

C'est la voie recommandée quand elle est proposée : un bouton coloré « Se connecter avec Google » (ou Microsoft, Airtable) apparaît en haut du formulaire de configuration du bloc.

1. Sélectionnez le bloc, puis ouvrez sa configuration (le bouton sous le titre du bloc).
2. Cliquez sur « Se connecter avec… ». Un onglet s'ouvre chez le fournisseur.
3. Choisissez votre compte et acceptez les autorisations demandées.
4. L'onglet affiche « You can close this tab » : fermez-le et revenez dans Voltask. La configuration est remplie et l'interrupteur activé passe à « oui ».

Voltask enregistre ensuite les identifiants dans la configuration, exactement comme si vous les aviez saisis vous-même. Vous pouvez réutiliser cette configuration dans plusieurs blocs.

Contraintes à connaître

• L'application commune doit exister. Les identifiants de cette application sont réglés une fois pour toute l'installation par l'administrateur (voir « Pour les administrateurs » plus bas). Si ce n'est pas fait, l'onglet affiche « Sign in with Google is not set up on this Voltask server » : utilisez alors la voie 2 ou 3, ou demandez à votre administrateur.
• Google limite l'accès tant que l'application n'est pas validée. Une application Google « en test » n'accepte que les comptes ajoutés à la main (100 au maximum), et l'autorisation expire au bout de 7 jours : il faut alors recliquer sur le bouton. Pour ouvrir à tout le monde, l'administrateur doit publier l'application et la faire valider par Google. Les accès aux e-mails (Gmail) exigent en plus un audit de sécurité externe ; Google Sheets et Google Agenda sont plus simples à faire valider.
• Vous gardez la main. Vous pouvez retirer l'accès à tout moment depuis votre compte chez le fournisseur (par exemple « Compte Google → Sécurité → Applications tierces »). Le bloc cessera alors de fonctionner jusqu'à une nouvelle connexion.
• Les accès demandés sont limités au nécessaire : Gmail lit et modifie les e-mails (pas de suppression définitive du compte), Google Sheets lit et écrit les feuilles, Google Agenda lit et crée les événements.

2. Votre propre application OAuth (avancé)

Vous créez vous-même l'application chez le fournisseur, puis vous recopiez ses identifiants dans les champs du formulaire, sous le bouton : clientId, clientSecret et jeton d'actualisation (refresh token).

À choisir si :

• l'administrateur n'a pas configuré la connexion en un clic, ou si Google ne l'a pas encore validée ;
• votre organisation exige que les accès passent par sa propre application (conformité, audit, quotas séparés) ;
• vous voulez ne dépendre d'aucune limite d'une application partagée.

Étapes pour Google :

1. Dans la console Google Cloud, créez un projet, puis un écran de consentement OAuth.
2. Activez l'API voulue (Gmail, Sheets ou Agenda).
3. Créez un ID client OAuth de type « Application Web ». Déclarez l'adresse de redirection indiquée par votre administrateur.
4. Recopiez l'identifiant et le secret dans Voltask, puis obtenez un jeton d'actualisation pour le périmètre voulu.

Contraintes : c'est plus long, et c'est à vous de renouveler les jetons qui expirent. Les champs secrets sont en écriture seule : une fois enregistrés, ils ne sont plus affichés. Laissez-les vides pour garder la valeur déjà stockée.

3. Clé d'accès (clé API ou jeton)

Beaucoup de services n'utilisent pas OAuth. Vous générez une clé dans votre compte chez le service, vous la collez dans le champ du formulaire, et c'est tout.

Contraintes : une clé donne souvent plus de droits que nécessaire, créez-en une dédiée à Voltask quand le service le permet. Si vous régénérez la clé chez le service, il faut la remplacer dans Voltask. Pour tout service qui expose une API avec clé mais n'a pas son connecteur, utilisez le bloc HTTP.

Quelle voie choisir ?

• Le bouton existe et fonctionne → voie 1.
• Le bouton affiche « not set up », ou l'autorisation expire tous les 7 jours → voie 2, ou demandez à l'administrateur de finaliser la validation chez Google.
• Le service propose une clé API → voie 3, c'est la plus simple.
• Vous êtes une organisation avec des règles strictes → voie 2, avec votre propre application.

Pour les administrateurs (Voltask hébergé par vos soins)

Les boutons en un clic utilisent une application créée une seule fois pour toute l'installation. Vos utilisateurs n'ont rien à créer. Les identifiants se règlent par variables d'environnement du service Voltask :

Les secrets acceptent aussi une variante <NOM>_FILE qui pointe vers un fichier (utile avec les secrets Docker).

Adresses de redirection à déclarer chez le fournisseur (remplacez par l'adresse publique de votre Voltask, y compris son éventuel préfixe, par exemple /voltask) :

• Google : https://votre-domaine/voltask/oauth/google/redirect
• SharePoint : https://votre-domaine/voltask/oauth/sharepoint/redirect
• Microsoft : https://votre-domaine/voltask/oauth/microsoft/redirect
• Airtable : https://votre-domaine/voltask/oauth/airtable/redirect

Étapes côté Google

1. Console Google Cloud → nouveau projet → Écran de consentement OAuth → type Externe.
2. Activez les API Gmail, Google Sheets et Google Calendar dont vous avez besoin.
3. Identifiants → Créer des identifiants → ID client OAuth → « Application Web », avec l'adresse de redirection ci-dessus.
4. Posez l'identifiant et le secret dans les variables, puis redémarrez Voltask.
5. Tant que l'application est « En test », ajoutez les comptes autorisés (100 maximum, autorisation de 7 jours). Pour ouvrir au public, publiez l'application, fournissez une page de confidentialité et un domaine vérifié, puis soumettez la validation à Google.

Questions fréquentes

L'onglet affiche « not set up on this Voltask server ». L'administrateur n'a pas encore renseigné l'application commune. Utilisez la voie 2 ou 3.

Le bloc fonctionnait, et s'arrête au bout d'une semaine. Vous êtes sur une application Google « en test » : l'autorisation expire après 7 jours. Cliquez de nouveau sur le bouton, ou demandez à l'administrateur de publier l'application.

Où retrouver la clé que j'ai saisie ? Nulle part : les champs secrets sont en écriture seule. Si vous l'avez perdue, générez-en une nouvelle chez le service et remplacez-la.

Puis-je avoir plusieurs comptes (par exemple deux boîtes Gmail) ? Oui : créez une configuration par compte (Nouvelle configuration) et choisissez-la dans chaque bloc.

Mis à jour le : 06/10/2026