API Notion : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API Notion permet de lire et d'écrire des pages, des blocs et des bases de données, de chercher du contenu et de commenter. Elle sert aux équipes qui tiennent wiki, projets et process dans Notion et veulent les automatiser. L'accès est ouvert, par une intégration interne avec jeton ou une intégration publique avec OAuth, et il n'atteint que les pages partagées avec elle.
Ce que propose l’API Notion
Pages
Création et mise à jour des pages et de leurs propriétés.
Blocs
Lecture et écriture du contenu : paragraphes, listes, tableaux, titres et autres blocs.
Bases de données
Requêtes avec filtres et tri, création d'éléments et modification des propriétés.
Recherche
Recherche des pages et des bases accessibles à l'intégration.
Commentaires
Lecture et création de commentaires sur les pages et dans les discussions.
Utilisateurs
Liste des membres de l'espace de travail, utilisée pour attribuer des responsables.
Comment accéder à l’API Notion
- API publiqueIntégration interne avec un jeton secret généré dans Notion, ou intégration publique avec OAuth 2.0. Dans les deux cas, les pages doivent être partagées avec l'intégration.
- L'API limite les requêtes par seconde ; les gros imports doivent être espacés.
- L'intégration ne voit que ce qui est partagé avec elle : vérifiez le partage des zones sensibles.
- Certains types de blocs sont peu pris en charge par l'API ; testez le format avant d'automatiser.
Documentation officielle: developers.notion.com
Ce qu’un agent iTeam fait avec l’API Notion
Compte rendu de réunion dans la base projets
Après la réunion, l'agent crée la page du compte rendu dans le bon projet, liste les décisions et crée les tâches dans la base de données, avec responsable et échéance.
Wiki qui répond dans Slack
L'agent cherche la page pertinente dans le wiki Notion et répond à la question en citant le lien, au lieu que quelqu'un cherche à la main.
Page périmée
L'agent trouve les pages de process sans modification depuis des mois et demande à leur propriétaire si elles sont encore valables, en consignant la revue.
Pipeline dans une base de données
Les leads ou demandes d'achat tenus dans une base Notion sont mis à jour par l'agent au fil des réponses reçues par e-mail.
De l’identifiant à l’agent au travail, avec validation
Créer l'intégration dans Notion
Un administrateur crée l'intégration avec les capacités minimales (lire, insérer, mettre à jour du contenu) et ne partage que les pages nécessaires.
Enregistrer le jeton dans le coffre d'iTeam
Le jeton est conservé dans le coffre ; chaque agent reçoit l'accès aux zones dont il a besoin, comme le wiki pour l'agent de support interne.
Tester avec validation
La création de pages peut s'exécuter directement ; les modifications de pages officielles et les suppressions démarrent avec une validation humaine.
Équipes IA prêtes à l’emploi qui utilisent Notion
Questions RH des salariés
Congés, mutuelle, fiche de paie, télétravail : l'agent répond à partir de vos documents RH et passe la main dès que la question devient personnelle.
Entretiens et évaluations
Managers et salariés arrivent à l'entretien avec les faits de l'année, et les objectifs décidés sont suivis au lieu d'être oubliés.
Questions sur l’API Notion
L'API Notion est-elle gratuite ?
En général, oui : l'API est disponible dans les offres Notion sans facturation par appel, dans les limites d'usage.
Faut-il programmer pour utiliser l'API Notion avec iTeam ?
Pas nécessairement. Notion dispose d'un connecteur dans le catalogue d'apps, et l'équipe de déploiement configure les flux avec vous.
L'agent voit-il tout mon Notion ?
Non. Il n'accède qu'aux pages et aux bases de données partagées explicitement avec l'intégration.
