Notion’s Developer Platform

Qu'est-ce que la plateforme de développement de Notion ?

La plateforme de développement de Notion est un ensemble de fonctionnalités pour les développeurs permettant de construire avec Notion en tant qu'espace de travail partagé — synchroniser des données externes dans Notion, créer des outils personnalisés utilisables par les Notion Agents, et orchestrer des workflows d'agents multi-étapes.

Son objectif principal est de vous permettre de connecter des systèmes externes à Notion (par exemple, maintenir une base de données Notion à jour depuis une autre source) et d'étendre les Notion Agents avec des actions et interfaces d'outils dédiées.

Fonctionnalités principales

• Insertion/mise à jour continue de données externes dans une base de données Notion à l'aide de Workers avec un schéma déclaratif et un curseur persistant, pour reprendre les mises à jour entre les exécutions.
• Synchronisation programmée d'un jeu de données externe dans Notion (par ex., définir un planning de synchronisation comme 5m dans l'exemple).
• Outils d'agents personnalisés pour Notion Agents qui génèrent des sorties (telles que des assets) et interagissent avec des API externes ou des données en direct.
• Interfaces d'outils structurées qui définissent le schéma d'entrée d'un outil (par exemple, une chaîne pageId pour créer une présentation, ou une chaîne query SQL pour exécuter une requête sur un entrepôt).
• Orchestration de workflows pilotée par webhooks qui écoute les webhooks entrants d'autres applications et déclenche des workflows Notion avec des Notion Agents, pages, bases de données et appels d'API externes.

Comment utiliser la plateforme de développement de Notion

1. Créez ou ciblez une base de données Notion et définissez un mappage de schéma entre cette base et vos champs de données externes.
2. Créez un Worker pour synchroniser les données : configurez une connexion de base de données gérée, fournissez le schéma/clé primaire initial, et écrivez une fonction de synchronisation qui retourne les changements d'enregistrements (par ex., mapper les champs source vers les propriétés Notion).
3. Définissez un planning de synchronisation et un identifiant stable (clé primaire) pour insérer/mettre à jour les enregistrements au lieu de les dupliquer.
4. Ajoutez optionnellement des outils personnalisés pour vos Notion Agents en enregistrant des outils avec un nom, une description, un schéma d'entrée, et un gestionnaire d'exécution qui effectue des actions (par ex., générer un asset .pptx à partir d'une page Notion et le téléverser sur la page).
5. Pour une automatisation pilotée par événements, configurez des écouteurs de webhooks qui déclenchent des workflows Notion exécutés avec des agents et des appels d'API externes.

Cas d'usage

• Ingestion de tickets de support dans Notion : Synchronisez en continu les tickets d'un helpdesk externe dans une base de données Notion via un Worker, en insérant/mettre à jour par ID de ticket et en mappant des champs comme sujet, CSAT et tags.
• Génération automatique d'assets à partir de contenu Notion : Créez un outil personnalisé (par ex., createPresentation) qui lit une page Notion en markdown, convertit les titres en diapositives, téléverse un .pptx généré, et l'ajoute à la page.
• Interrogation d'un entrepôt de données via un outil d'agent : Définissez un outil (par ex., queryRevenue) qui accepte une chaîne de requête SQL, l'exécute sur une table d'entrepôt, et retourne les résultats au workflow d'agent.
• Workflows d'actions déclenchés par des événements externes : Créez un workflow piloté par webhooks qui écoute les événements d'une application et exécute des workflows Notion avec des Notion Agents, pages/bases de données et appels d'API externes.
• Actions d'applications basées sur navigateur contrôlées par un outil d'agent : Implémentez un outil d'agent utilisant un fournisseur d'automatisation navigateur pour exécuter des tâches multi-étapes dans une app externe (exemple : lister les repas sauvegardés, confirmer une commande, et vérifier le statut de livraison).

FAQ

La plateforme prend-elle en charge la synchronisation continue des bases de données Notion ?

Oui. Les exemples décrivent des Workers qui insèrent/ mettent à jour en continu des enregistrements externes dans une base de données Notion, en utilisant un curseur persistant pour reprendre les mises à jour.

Quels types de sorties les outils personnalisés peuvent-ils générer ?

Les exemples fournis incluent la génération d'une présentation PowerPoint (.pptx) à partir du contenu d'une page Notion et son téléversement sur la page.

Les outils d'agents peuvent-ils interroger des systèmes externes en direct ?

Oui. Un exemple d'outil exécute une requête SQL sur une table d'entrepôt de deals, et un autre décrit l'utilisation d'actions d'apps externes via automatisation navigateur.

Comment fonctionnent les automatisations pilotées par événements ?

La page décrit l'écoute de webhooks entrants d'applications et l'exécution de workflows Notion utilisant des Notion Agents, pages, bases de données et appels d'API externes.

Qu'est-ce qui est nécessaire pour insérer/mettre à jour des enregistrements dans Notion ?

Dans les exemples, vous définissez une connexion de base de données gérée avec un schéma et une propriété de clé primaire, puis fournissez une fonction de synchronisation qui mappe les enregistrements externes vers les propriétés Notion en tant qu'insertions/mises à jour.

Alternatives

• Outils ETL/ELT polyvalents (pour la synchronisation de données uniquement) : Si votre objectif principal est de déplacer et transformer des données dans une base, les outils ETL gèrent l’ingestion périodique, tandis que la Notion Developer Platform couvre aussi les outils d’agents et l’orchestration de workflows.
• Plateformes d’automatisation de workflows (pour les déclencheurs et l’orchestration) : Les outils de cette catégorie coordonnent webhooks et actions entre applications, mais n’offrent pas le même couplage étroit avec les Notion Agents opérant sur les pages et bases Notion.
• Frameworks d’outils d’agents avec intégrations externes (pour les appels d’outils personnalisés) : Si vous construisez déjà des systèmes d’agents, un framework d’outils permet d’appeler des API et de générer des assets ; la plateforme Notion cible spécifiquement les interactions d’agents et la synchronisation de données autour des espaces de travail Notion.