Exécuter du code personnalisé avec les workers (bêta)

Les Workers de 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

• Les Workers sont disponibles avec les forfaits Business et Enterprise.

• Un·e propriétaire d’espace de travail doit activer les workers pour cet espace.

• Si vous souhaitez déployer ou gérer un worker, vous devrez généralement consulter notre documentation pour les développeur·euses et utiliser la CLI de Notion.

Pour en savoir plus sur la tarification des workers, consultez cet article.

La synchronisation de bases de données (alimentée par des workers) importe des informations provenant d’outils externes dans une base de données Notion et les maintient automatiquement à jour. Une fois configurée, la base de données synchronisée reste à jour de manière autonome, afin que votre équipe et vos agents disposent toujours des données les plus récentes, sans que personne n’ait à copier ou coller des informations d’un outil à l’autre.

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 standard de partage 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.

Essayez les étapes suivantes dans l’ordre :

1. Assurez-vous que votre espace de travail est admissible et qu’un·e propriétaire de l’espace de travail a activé les workers. Les workers sont disponibles avec les forfaits Business et Enterprise et doivent être activés par un·e administrateur·rice de l’espace de travail.

2. Vérifiez que vous utilisez le chemin de configuration prévu. Pour la plupart des configurations, vous utiliserez la CLI de Notion et la documentation pour les développeur·euses.

3. Si le déploiement de votre worker échoue, vérifiez les autorisations. Vous n’avez peut-être pas l’accès nécessaire pour effectuer un déploiement dans cet espace de travail, même si vous pouvez en consulter les pages.

4. Si votre worker s’exécute, mais ne modifie rien dans Notion, testez d’abord l’action manuellement. Si vous ne pouvez pas effectuer la même modification dans Notion, il s’agit généralement d’un problème d’autorisation ou de configuration de l’espace de travail.

5. 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 par un rythme d’exécution plus lent, puis augmentez-le une fois que tout fonctionne correctement.

6. Vous êtes toujours bloqué·e ? Consultez la documentation pour les développeur·euses concernant le message d’erreur en question. Vous y trouverez la solution la plus précise.

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écutent du code personnalisé sur l’infrastructure de Notion. Les développeur·euses utilisent les Workers, par exemple, pour les automatisations, les synchronisations planifiées et les intégrations personnalisées.

• Agents personnalisés : gèrent automatiquement les tâches répétitives pour votre équipe. Vous définissez des déclencheurs, 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 d’un autre système, et l’agent peut utiliser ces données pour répondre ou agir.

Les workers sont-ils la même chose que les automatisations ?

Pas exactement. Les automatisations sont intégrées à Notion et conçues pour que tout le monde puisse les configurer. Les workers sont destinés aux développeur·euses qui souhaitent exécuter du code personnalisé. Si vous n’avez pas besoin de code, commencez par les automatisations.