Intégration Notion

Fonctionnement

Embases utilise l'API officielle de Notion via le protocole OAuth 2.0. Ce protocole vous permet d'autoriser Embases à lire certaines de vos données Notion sans jamais lui communiquer votre mot de passe. Voici ce qui se passe en coulisses :

Lorsque vous cliquez sur « Connecter », Embases génère un jeton d'état aléatoire (protection anti-CSRF, valide 10 minutes) et vous redirige vers notion.com. Vous vous y connectez si nécessaire, puis vous choisissez exactement quelles pages et bases de données partager. Notion émet un code d'autorisation temporaire. Embases l'échange immédiatement contre un token d'accès, le chiffre avec AES-256 et le stocke en base de données.

À chaque fois qu'un de vos embeds Notion se charge — que ce soit dans votre tableau de bord ou sur un site externe via iframe — Embases envoie une requête à l'API Notion avec ce token pour récupérer les données fraîches. Les données ne sont jamais mises en cache entre deux chargements.

Connecter Notion

La connexion prend environ 30 secondes. Voici les étapes :

1. 1Depuis votre tableau de bord, cliquez sur « Intégrations » dans la barre latérale gauche.
2. 2Sur la carte Notion, cliquez sur le bouton « Connecter ».
3. 3Une popup s'ouvre sur notion.com — connectez-vous à votre compte Notion si vous n'êtes pas déjà authentifié.
4. 4Notion affiche la liste de vos espaces de travail et de vos pages. Cochez les pages et bases de données auxquelles vous souhaitez donner accès à Embases.
5. 5Cliquez sur « Autoriser l'accès ». Vous êtes automatiquement redirigé vers Embases.
6. 6La carte Notion affiche désormais un badge vert « Connecté » avec le nom de votre espace Notion.

Ce à quoi Embases peut accéder — et une limite importante

Notion applique un principe de moindre privilège strict : Embases ne peut accéder qu'aux pages et bases que vous avez explicitement cochées lors de l'étape d'autorisation. Toutes les autres pages de votre espace Notion restent totalement inaccessibles, même si le token est valide.

Pour ajouter des pages après coup sans reconnecter : dans Notion, allez dans Paramètres → Intégrations → trouvez « Embases » → cliquez sur « Modifier l'accès » et cochez de nouvelles pages. Aucune action requise côté Embases — le token existant donne automatiquement accès aux nouvelles pages ajoutées.

Limite du protocole OAuth de Notion : le token délivré par Notion est global — il ne distingue pas les contextes dans lesquels vous utilisez Embases. Concrètement, si vous avez autorisé des bases de données lors de la connexion OAuth, ce même token donne accès à ces bases à la fois depuis votre espace personnel (Mon hub) et depuis n'importe quel workspace Embases auquel vous appartenez. Il n'est pas possible de dire à Notion « ces pages sont réservées à tel workspace, pas à mon hub personnel » — ce n'est pas une limitation d'Embases, c'est une contrainte de l'API Notion.

Exemple concret : vous avez autorisé les bases « Pipeline Ventes » et « Budget Perso » lors de votre connexion OAuth. Sans aucun filtre, ces deux bases apparaîtraient dans l'éditeur d'embed, aussi bien dans votre hub personnel que dans votre workspace d'entreprise. Ce n'est pas souhaitable. C'est pourquoi Embases a mis en place un système de sélection de bases, décrit dans la section suivante.

Le système de sélection de bases — pourquoi il existe

Pour contourner la limite du token OAuth global décrite ci-dessus, Embases a introduit une couche de sélection indépendante, par contexte. C'est le mécanisme central qui vous permet de contrôler quelles bases apparaissent dans quel espace.

Le principe : chaque contexte (votre hub personnel et chacun de vos workspaces) maintient sa propre liste de bases sélectionnées. Ces listes sont indépendantes les unes des autres et n'affectent pas les droits d'accès Notion — elles agissent comme des filtres d'affichage dans l'éditeur d'embed.

Concrètement, avec l'exemple précédent : • Dans Mon hub → vous ajoutez uniquement « Budget Perso » à la sélection. • Dans le workspace d'entreprise → vous ajoutez uniquement « Pipeline Ventes ».

Résultat : dans l'éditeur d'embed de votre hub, seule « Budget Perso » est proposée comme source. Dans l'éditeur du workspace, seule « Pipeline Ventes » apparaît. Chaque contexte reste cloisonné, même si le token OAuth sous-jacent donne techniquement accès aux deux bases partout.

Comment gérer la sélection : sur la page Intégrations (hub personnel ou workspace), cliquez sur l'icône d'engrenage (⚙) de la carte Notion. Un panneau liste toutes les bases accessibles via votre token. Cliquez « Ajouter » pour inclure une base dans ce contexte, ou le bouton de suppression pour la retirer. La suppression ne révoque aucun accès Notion — elle retire simplement la base du menu de l'éditeur dans ce contexte.

Types de propriétés supportées

Lors de la création d'un graphique, vous choisissez deux propriétés de votre base Notion : l'axe X (les catégories) et l'axe Y (les valeurs numériques). Toutes les propriétés ne sont pas utilisables sur chaque axe.

Axe X — catégories (texte, date, sélection) : • Title — la propriété titre de chaque entrée • Rich text — champs texte enrichi • Select — champs à valeur unique (ex: Statut, Catégorie) • Multi-select — champs à valeurs multiples (chaque valeur devient une catégorie) • Date — dates (formatées automatiquement)

Axe Y — valeurs numériques : • Number — champs nombre (entiers ou décimaux)

Les propriétés de type fichier, relation, rollup avec formules complexes, personnes, URL et case à cocher ne sont pas disponibles comme valeur d'axe Y. Les checkbox peuvent toutefois servir d'axe X (true/false comme catégories).

Utilisation dans un espace d'équipe

Dans un workspace Embases, chaque membre peut connecter son propre compte Notion de manière indépendante. Il n'y a pas de connexion Notion unique partagée : chaque personne s'authentifie avec ses propres identifiants et donne accès aux bases Notion qui lui appartiennent.

Cela permet à une équipe de combiner des données de plusieurs espaces Notion différents. Le responsable commercial connecte son Notion et sélectionne « Pipeline Ventes » dans la liste du workspace. Le responsable marketing connecte le sien et sélectionne « Campagnes ». Chacun a son propre token, ses propres bases épinglées dans le workspace.

Le cas particulier : un membre déjà connecté dans son hub personnel. Quand un utilisateur se connecte à Notion depuis la page Intégration d'un workspace, Embases effectue un second flux OAuth distinct. Ce flux peut utiliser le même compte Notion ou un compte différent. Si c'est le même compte Notion, la personne obtient deux tokens indépendants : un pour son hub, un pour le workspace. Les sélections de bases sont séparées — ce que la personne a épinglé dans son hub n'apparaît pas dans le workspace, et vice versa. C'est exactement le rôle du système de sélection décrit plus haut : isoler les contextes même quand le token Notion sous-jacent est identique.

Droits et permissions dans le workspace : • Chaque membre peut connecter et déconnecter sa propre connexion Notion. • Chaque membre ne peut ajouter des bases qu'à partir de son propre token. • Le propriétaire du workspace voit toutes les connexions actives et peut déconnecter celle de n'importe quel membre. • Un membre ne peut pas modifier les sélections d'un autre membre.

Pour accéder aux connexions Notion d'un workspace : ouvrez le workspace dans la barre latérale → cliquez sur « Intégration ».

Déconnecter Notion

Pour supprimer la connexion Notion de votre compte Embases :

1. 1Allez sur la page Intégrations (barre latérale → Intégrations).
2. 2Sur la carte Notion, cliquez sur « Déconnecter ».
3. 3Une confirmation vous est demandée pour éviter toute erreur.
4. 4Après confirmation, le token d'accès est immédiatement supprimé d'Embases. Toutes vos sélections de bases enregistrées dans Embases sont également effacées.