Productivité
Notion dans votre produit et vos agents IA, via une API
Le toolkit Notion travaille sur les pages et data sources que le client a partagés avec la connexion : recherche, lecture des propriétés et du contenu en Markdown, création et mise à jour de pages, ajout de blocs, requête de lignes de base de données et commentaires. Votre produit ou agent IA l'appelle via Connect, qui stocke les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/notion_search/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Fonctionnement
Du client connecté au premier appel à Notion.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Notion. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Notion.
Des enregistrements dans Notion
Un SaaS crée une page dans un data source du client pour chaque nouveau lead, ticket ou rapport, en remplissant les propriétés que définit le data source.
Des docs toujours à jour
Un outil d'agence modifie le Markdown d'une page par recherche et remplacement, ou la réécrit entièrement quand les chiffres changent.
Agent avec mémoire du workspace
Un agent IA cherche des pages par titre, lit leur Markdown, liste les lignes d'un data source et répond dans les commentaires.
Tools
13 tools Notion
- RechercherPOSTRecherche par titre les pages et data sources partagés avec la connexion. Renvoie has_more et next_cursor pour la page suivante.
- Obtenir une pageGETRenvoie les propriétés d'une page. Le contenu n'est pas inclus : lisez-le avec Obtenir le markdown d'une page.
- Créer une pagePOSTCrée une page sous une page ou un data source partagé avec la connexion. Envoyez le contenu en Markdown dans markdown, ou en blocs dans children, jamais les deux.
- Mettre à jour une pagePATCHMet à jour les propriétés, l'icône ou la couverture d'une page, ou la met à la corbeille et l'en sort avec in_trash. Les propriétés omises gardent leur valeur.
- Obtenir le markdown d'une pageGETRenvoie le contenu d'une page en Markdown dans le champ markdown. Sur une très grande page, truncated vaut true et unknown_block_ids liste les parties omises.
- Mettre à jour le markdown d'une pagePATCHModifie le contenu d'une page en Markdown : le type update_content applique des modifications par recherche et remplacement, et replace_content réécrit toute la page.
- Créer des blocsPATCHAjoute des blocs de contenu à une page, ou à un bloc qui accepte des enfants, à la fin sauf si position dit autre chose. Jusqu'à 100 blocs par appel.
- Obtenir une base de donnéesGETRenvoie une base de données avec titre, parent et data_sources, l'id et le name de chaque data source qu'elle contient.
- Obtenir un data sourceGETRenvoie le schéma d'un data source : nom, id, type et options de chaque propriété. Lisez-le avant de créer, mettre à jour ou filtrer des pages dedans.
- Lister les pages d'un data sourcePOSTListe les pages d'un data source, les lignes d'une base de données, avec filtre et tris optionnels. Renvoie has_more et next_cursor pour la page suivante.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/notion, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Notion
Dois-je intégrer l'API Notion moi-même ?
Non. Connect fournit 13 tools Notion décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Notion ?
Avec le mode accepté par le toolkit : Clé d'API, OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
