Notion Workers : connecter vos outils à Notion, expliqué simplement

Les Notion Workers sont de petits programmes hébergés et exécutés par Notion qui exposent des « outils » : des actions précises que les agents Notion peuvent appeler, comme programmer un post ou lire des ventes. Ils servent de pont entre votre espace Notion et l'API d'un autre service, sans plateforme d'automatisation intermédiaire.

Les agents Notion savent lire vos pages et rédiger. Mais dès qu'il faut parler à un autre logiciel (planificateur, outil de paiement), ils s'arrêtent à la frontière de votre espace.

La réponse habituelle était d'ajouter Make ou Zapier entre les deux. Un Worker propose une autre voie : l'action vit dans Notion, et un agent Notion décide quand la lancer.

Cet article explique les Workers sans jargon, à partir d'un système de contenu qui tourne en production. Pour le détail technique à jour, la documentation développeurs de Notion fait foi.

Qu'est-ce qu'un Worker Notion, en termes simples ?

Un Worker Notion est un petit programme que Notion héberge et exécute pour vous. Il contient une ou plusieurs actions précises, appelées outils. Un agent Notion peut appeler ces outils comme il utiliserait une capacité intégrée. Vous n'avez aucun serveur à louer ni à surveiller : Notion s'en occupe.

Une image aide : l'agent Notion est un assistant qui suit vos consignes, le Worker une boîte à outils qui garde les clés d'accès à d'autres services. L'assistant ne voit jamais les clés : il demande « programme ce post » et la boîte à outils s'en charge.

Côté technique, un Worker s'écrit en TypeScript et se déploie avec l'outil en ligne de commande de Notion. Pour ce qu'il peut faire exactement, ses conditions d'accès et ses limites, référez-vous à la documentation officielle : la fonctionnalité évolue.

À quoi sert un Worker Notion ?

Un Worker sert à faire parler Notion avec un service extérieur qui propose une API : envoyer une donnée (programmer un post) ou en récupérer (des statistiques, des ventes). Tout ce qui reste à l'intérieur de Notion n'en a pas besoin, car les automatisations, les boutons et les agents suffisent déjà.

Vérifiez donc d'abord que votre besoin sort bien de Notion :

Les premières lignes sont détaillées dans le guide des automatisations de base de données Notion.

Comment un agent Notion appelle-t-il les outils d'un Worker ?

Une fois le Worker déployé, ses outils deviennent disponibles pour vos agents Notion. Dans les réglages de chaque agent, vous activez uniquement l'outil dont il a besoin. Ses consignes lui disent ensuite quand l'appeler et quoi faire du résultat : écrire un identifiant, remplir une propriété, signaler une erreur.

Exemple : l'agent « Publieur » se déclenche quand le Statut d'une page passe à Prêt, puis :

1. Il lit la page : texte à publier, réseau, date et heure prévues, visuel.
2. Il appelle l'outil de programmation du Worker avec ces informations.
3. Le Worker vérifie les données et les envoie à l'API du planificateur.
4. Si tout va bien, l'identifiant du post est écrit dans la page. Sinon, l'erreur s'écrit dans une propriété « Erreur GHL » et une automatisation vous notifie.

L'agent ne manipule jamais la clé d'accès : il demande une action, le Worker l'exécute.

Où ranger les secrets (jetons et clés d'API) ?

Dans le Worker, et nulle part ailleurs. Les jetons d'accès (celui de GoHighLevel, la clé Stripe) sont enregistrés comme variables d'environnement du Worker. Ils n'apparaissent dans aucune page Notion, aucune consigne d'agent et aucune conversation avec une IA. Un jeton affiché ailleurs par erreur doit être révoqué puis recréé.

Trois règles complètent ce principe :

• Des droits minimum. Le jeton d'intégration privée de GoHighLevel est créé dans la sous-location, avec les seuls droits du planificateur de réseaux sociaux. La clé Stripe est restreinte en lecture seule.
• Des outils de lecture marqués comme tels. Un outil qui lit des statistiques ou des ventes est déclaré en lecture seule.
• Pas de secret dans les chats, même pour « tester vite ».

Un Worker, plusieurs outils

Un seul Worker peut contenir plusieurs outils. Dans le système décrit ici, le même Worker sait programmer un post, lire les statistiques d'un post et lire les ventes Stripe. Chaque agent Notion n'active que l'outil dont il a besoin : le publieur publie, l'agent de statistiques lit, rien de plus.

Résultat : un seul déploiement à maintenir, un seul endroit pour les secrets, et un agent qui ne doit que lire dans un service externe n'a aucun moyen d'y écrire.

Trois exemples réels d'outils

Voici trois outils qui tournent dans un même Worker : la programmation d'un post dans le planificateur de GoHighLevel, la lecture des statistiques des posts publiés et la lecture des ventes Stripe. Chacun est appelé par un agent Notion différent, à un moment différent, avec des droits différents.

Programmer un post GoHighLevel

Avant d'envoyer quoi que ce soit, l'outil vérifie quatre points : le texte n'est pas vide, il respecte la limite du réseau, un visuel accessible par une URL publique est présent pour Instagram, et la date est au moins 5 minutes dans le futur. Le pas à pas est dans publier sur les réseaux sociaux avec GoHighLevel depuis Notion.

Lire les statistiques des posts

Chaque dimanche, l'agent « Stats » récupère le statut, le lien public, les likes, commentaires et partages de chaque post publié. Ce rythme hebdomadaire limite les crédits consommés.

Lire les ventes Stripe

Matin et soir, l'agent « Stats ventes » écrit les ventes des 30 derniers jours sur les fiches de la base Offres. Le détail est dans l'article sur les statistiques et les ventes Stripe dans Notion.

Notion Workers ou Make et Zapier : que choisir ?

Si vos données et vos déclencheurs vivent dans Notion et que vous voulez qu'un agent décide quand agir, un Worker évite une plateforme intermédiaire. Make et Zapier restent plus simples à installer sans compétence technique et proposent de nombreux connecteurs prêts à l'emploi. Le choix dépend de votre aisance technique et des outils à relier.

Faut-il savoir coder pour utiliser un Worker Notion ?

Au quotidien, non : vous changez un statut dans Notion, l'agent fait le reste. Pour le créer et le déployer, oui, en partie : le Worker s'écrit en TypeScript et s'installe avec l'outil en ligne de commande de Notion, depuis un terminal. Cette étape a lieu au départ, puis lors des évolutions.

Les limites à connaître :

• L'installation initiale est technique : écriture, déploiement, secrets.
• Les accès se préparent côté services : jeton GoHighLevel, clé Stripe, réseaux connectés.
• Les conditions d'accès peuvent évoluer. Vérifiez dans la documentation de Notion ce qui est disponible pour votre espace.

Par où commencer ?

Listez les actions qui sortent vraiment de Notion. Pour chacune, vérifiez que le service propose une API et préparez un accès aux droits minimum, puis écrivez les consignes des agents qui appelleront chaque outil. Le guide pour automatiser sa création de contenu avec Notion et l'IA montre où le Worker s'insère dans l'ensemble.

Si vous voulez profiter d'un Worker sans ouvrir de terminal, je construis ce type de système dans votre Notion, déploiement compris.

Découvrir l'offre d'espace Notion sur mesure

Questions fréquentes