Exécuter du code personnalisé avec les workers (bêta)
Découvrez ce que sont les Workers et à quoi ils servent.
Aller directement aux questions fréquentesLes Workers Notion font partie de notre Plateforme Développeurs. Ils exécutent du code personnalisé sur l'infrastructure de Notion pour alimenter :
La synchronisation de bases de données
Les outils pour les agents personnalisés
Les déclencheurs de webhook
Pour la configuration technique, consultez la documentation pour les développeur·euses.
Pour en savoir plus sur la tarification, consultez cet article.
Les Workers sont disponibles avec les forfaits Business et Enterprise.
Par défaut, les Workers sont activés pour l'espace de travail (Propriétaire(s) uniquement).
Les Propriétaire(s) de l'espace de travail peuvent :
Restreindre la création de Workers aux Propriétaire(s) uniquement.
Autoriser des membres ou des groupes spécifiques à créer des Workers.
Désactiver les Workers pour l'espace de travail.
Si vous souhaitez déployer ou gérer un worker, vous devrez généralement consulter notre documentation développeur et utiliser la CLI de Notion.
Vous pouvez activer le mode développeur pour afficher les Workers dans Notion, lire les journaux et désactiver ou supprimer des Workers. Pour déployer un worker ou modifier son code ou sa configuration, utilisez la CLI de Notion ou l'outil de codage de votre équipe. En savoir plus sur le mode développeur →
Pour en savoir plus sur la tarification des workers, consultez cet article.
La synchronisation de base de données (propulsée par les Workers) importe des informations provenant d'outils externes dans une base de données Notion et les maintient à jour automatiquement. Une fois configurée, la base de données synchronisée reste à jour d'elle-même, afin que votre équipe et vos agents voient toujours les données les plus récentes sans que personne n'ait à faire de copier-coller entre les outils.
Voici quelques exemples courants :
Synchroniser les tickets du service client Zendesk dans une base de données de répartition.
Synchroniser les comptes Salesforce dans un outil de suivi de pipeline.
Synchroniser des données provenant d’un outil ou d’une base de données interne.
Une fois en ligne, la base de données synchronisée se comporte comme n'importe quelle autre base de données dans Notion. L'accès est régi par vos autorisations de partage standard de Notion.
Les outils d’agents (alimentés par des workers) étendent les possibilités de vos agents personnalisés au-delà des actions intégrées de Notion et du MCP en proposant des capacités adaptées au fonctionnement de votre équipe.
Voici quelques exemples courants :
Interroger un entrepôt de données.
Générer des ressources à partir d’un document Notion.
Effectuer une action dans une autre application qui n’est pas prise en charge nativement ou disponible via MCP.
Les déclencheurs de webhook (alimentés par des workers) permettent à un événement survenu dans un autre outil de lancer un flux de travail dans Notion ou dans tout autre système connecté.
Voici quelques exemples courants :
Clôturer une tâche lors de la fusion d’une pull request.
Mettre à jour un enregistrement CRM lorsqu’un abonnement change.
Créer un document d’accueil lorsqu’une offre est signée.
Une fois configuré, le flux de travail s’exécute automatiquement à chaque fois que l’événement se produit, afin que votre équipe n’ait pas à transférer manuellement des informations d’un outil à l’autre.
Avec le mode développeur, vous pouvez ouvrir les Workers depuis la section développeur de votre barre latérale. Utilisez cette vue pour des vérifications rapides et des actions de base. Dans Notion, vous pouvez :
Voir tous les Workers dans une seule liste.
Ouvrir un Worker et consulter l'aperçu, les journaux, les variables d'environnement et les paramètres.
Lire les journaux des Workers.
Désactiver ou supprimer un Worker.
Pour déployer un worker ou modifier son code ou sa configuration, utilisez la CLI de Notion ou l'outil de codage de votre équipe.
Par défaut, seule la personne qui a créé un worker peut le modifier ou l'ajouter en tant que nouvelle connexion. Partagez un worker avec des Membres de votre équipe afin qu'ils puissent le connecter à un agent personnalisé ou aider à le gérer.
Essayez les étapes suivantes dans l’ordre :
Assurez-vous que votre espace de travail est éligible et qu'un propriétaire de l’espace de travail a activé les Workers. Les Workers sont disponibles sur les forfaits Business et Forfait Enterprise et nécessitent une activation par un admin de l’espace de travail.
Confirmez que vous utilisez le parcours de configuration prévu. Pour la plupart des configurations, vous utiliserez la CLI de Notion ainsi que la documentation développeur.
Si le déploiement de votre worker échoue, vérifiez ensuite les autorisations. Il se peut que vous n'ayez pas accès à déployer dans cet espace de travail, même si vous pouvez voir les pages.
Si votre worker s'exécute mais ne modifie rien dans Notion, testez d'abord l'action manuellement. Si vous ne parvenez pas à effectuer la même modification dans Notion, il s'agit généralement d'un problème d'autorisation ou d'un paramètre de l'espace de travail.
Si le coût semble plus élevé que prévu, réduisez la fréquence d'exécution. Les Workers qui s'exécutent plus souvent coûtent plus cher. Commencez avec une fréquence plus lente, puis augmentez-la une fois que vous êtes certain que tout fonctionne.
Toujours bloqué ? Suivez la documentation développeur pour le message d'erreur spécifique. Ils auront la solution la plus précise.
Questions fréquentes
Quelle est la différence entre les Workers et les Agents personnalisés ?
Quelle est la différence entre les Workers et les Agents personnalisés ?
Les Workers et les Agents personnalisés résolvent des problèmes différents, mais ils peuvent travailler ensemble.
Workers : Exécutez du code personnalisé sur l'infrastructure de Notion. Les développeurs utilisent les Workers pour des tâches telles que les automatisations, les synchronisations planifiées et les intégrations personnalisées.
Agents personnalisés : Gérez automatiquement les tâches répétitives pour votre équipe. Vous définissez des déclencheurs, et ils s'exécutent en arrière-plan avec votre espace de travail comme contexte.
Dans certaines configurations, un Worker peut alimenter un outil unique qu’un agent personnalisé peut utiliser. Par exemple, un Worker peut récupérer des données depuis un autre système, et l’agent peut utiliser ces données pour répondre ou effectuer une action.
Les workers sont-ils la même chose que les automatisations ?
Les workers sont-ils la même chose que les automatisations ?
Pas exactement. Les automatisations sont intégrées à Notion et sont conçues pour être configurées par n'importe qui. Les Workers sont destinés aux développeurs qui souhaitent exécuter du code personnalisé. Si vous n'avez pas besoin de code, commencez par les automatisations.
Les workers s’exécutent-ils sur mes serveurs ?
Les workers s’exécutent-ils sur mes serveurs ?
Non. Les workers s’exécutent sur les serveurs de Notion ; vous n’avez donc pas besoin de configurer ou de gérer d’infrastructure.
Ai-je besoin de la CLI pour utiliser les workers ?
Ai-je besoin de la CLI pour utiliser les workers ?
Pas toujours. Vous pouvez afficher les Workers, lire les journaux, désactiver les Workers et supprimer les Workers dans Notion avec le mode développeur. Vous aurez généralement besoin de la CLI de Notion ou de l'outil de développement de votre équipe pour configurer, déployer ou modifier un Worker.
