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

Les 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 custom agents

• Les déclencheurs de webhook

• 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 custom agents 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 workflow 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 workflow 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 custom agent ou aider à le gérer.

En savoir plus sur la façon de partager un worker →

Essayez les étapes suivantes dans l’ordre :

1. 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.

2. 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.

3. 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.

4. 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.

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 avec une fréquence plus lente, puis augmentez-la une fois que vous êtes certain que tout fonctionne.

6. Toujours bloqué ? Suivez la documentation développeur pour le message d'erreur spécifique. Ils auront la solution la plus précise.