Intégration Airtable

Fonctionnement

Embases utilise l'API Airtable via OAuth 2.0 avec une extension de sécurité appelée PKCE (Proof Key for Code Exchange). Cette méthode est plus sécurisée que l'OAuth standard car elle protège contre les attaques par interception de code d'autorisation.

Comment fonctionne PKCE : avant de vous rediriger vers Airtable, Embases génère un code_verifier aléatoire et calcule son empreinte (code_challenge). Airtable stocke ce challenge. Au retour, Embases présente le code_verifier original — Airtable vérifie qu'il correspond au challenge enregistré. Un attaquant qui intercepterait le code d'autorisation ne pourrait pas l'utiliser sans connaître le code_verifier.

Airtable émet deux types de tokens : • Access token — jeton d'accès à courte durée de vie, utilisé pour chaque appel API. • Refresh token — jeton de longue durée permettant de renouveler l'access token sans vous demander de vous reconnecter.

Renouvellement automatique : Embases surveille la date d'expiration de l'access token. Lorsqu'il expire dans moins de 5 minutes, il est renouvelé automatiquement en arrière-plan. Vous n'avez jamais besoin d'intervenir — la connexion reste active indéfiniment tant que vous ne la révoquez pas.

Connecter Airtable

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 Airtable, cliquez sur le bouton « Connecter ».
3. 3La page OAuth d'Airtable s'ouvre — connectez-vous à votre compte Airtable si nécessaire.
4. 4Airtable affiche la liste de vos bases. Cochez celles auxquelles vous souhaitez donner accès à Embases. Vous pouvez sélectionner une seule base pour limiter l'accès.
5. 5Cliquez sur « Grant access ». Vous êtes redirigé vers Embases.
6. 6La carte Airtable affiche un badge vert « Connecté » avec votre nom de compte Airtable.

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

Comme Notion, Airtable émet un token OAuth global : il ne distingue pas les contextes dans lesquels vous utilisez Embases. Les bases auxquelles vous avez donné accès lors de la connexion sont techniquement accessibles à la fois depuis votre hub personnel (Mon hub) et depuis n'importe quel workspace Embases auquel vous appartenez — même si vous ne le souhaitez pas.

Exemple : vous avez autorisé les bases « CRM Clients » et « Budget Perso » lors du flux OAuth. Sans filtre, ces deux bases apparaîtraient dans l'éditeur d'embed aussi bien dans votre hub personnel que dans votre workspace d'équipe.

Pour contourner cette limite, Embases maintient une liste de sélection par contexte. Chaque contexte (hub personnel et chaque workspace) a sa propre liste indépendante de bases épinglées. Ces listes n'affectent pas les droits d'accès Airtable — elles contrôlent uniquement ce qui apparaît dans l'éditeur d'embed selon le contexte actif.

Concrètement : • Dans Mon hub → épinglez uniquement « Budget Perso ». • Dans le workspace d'équipe → épinglez uniquement « CRM Clients ».

Résultat : chaque contexte ne propose que les bases pertinentes dans l'éditeur, même si le token sous-jacent donne accès aux deux partout.

Pour gérer la sélection : sur la page Intégrations (hub ou workspace), cliquez sur l'icône d'engrenage (⚙) de la carte Airtable. Le panneau liste toutes les bases accessibles via votre token. « Ajouter » pour épingler, bouton de suppression pour retirer — sans jamais toucher aux permissions Airtable.

Créer un embed depuis Airtable

Une fois une base épinglée dans Embases, vous pouvez l'utiliser comme source de données pour un graphique. Voici comment procéder depuis l'éditeur d'embed :

1. 1Depuis le tableau de bord, cliquez sur « Nouvel embed » (ou ouvrez un embed existant).
2. 2Dans le panneau de configuration, choisissez « Airtable » comme source de données.
3. 3Sélectionnez la base Airtable dans le premier menu déroulant.
4. 4Sélectionnez la table (onglet) dans le second menu déroulant. Les tables disponibles sont chargées automatiquement depuis l'API Airtable.
5. 5Choisissez le champ pour l'axe X (catégories) et le champ pour l'axe Y (valeurs). Seuls les champs compatibles sont proposés pour chaque axe.
6. 6Le graphique se met à jour en temps réel dans la prévisualisation.

Types de champs compatibles

Lors du mappage des axes, seuls les types de champs compatibles avec chaque axe sont affichés.

Axe X — catégories : • Single line text — texte court • Single select — valeur unique parmi une liste • Multi-select — chaque valeur sélectionnée devient une catégorie distincte • Date — dates (formatées automatiquement selon votre format) • Checkbox — valeurs true/false comme catégories • Rating — note sur 5 ou 10 comme catégorie

Axe Y — valeurs numériques : • Number — chiffres entiers ou décimaux • Currency — montants monétaires (formatés avec le symbole) • Percent — pourcentages • Rating — note numérique • Count — comptage automatique de liens • Rollup — valeur agrégée (si la formule retourne un nombre) • Formula — résultat de formule (si le résultat est numérique)

Les champs de type Attachment (pièce jointe), Lookup retournant des tableaux complexes, et les champs de type Created by / Last modified by ne sont pas disponibles comme valeur d'axe.

Gestion automatique des tokens

Contrairement à Notion qui émet des tokens permanents, les access tokens Airtable ont une durée de vie limitée. Sans gestion, votre connexion expirerait régulièrement et vos embeds cesseraient de fonctionner.

Embases gère ce cycle de vie automatiquement :

1. Avant chaque appel à l'API Airtable, Embases vérifie la date d'expiration du token stocké. 2. Si le token expire dans moins de 5 minutes (ou est déjà expiré), Embases utilise le refresh token pour en obtenir un nouveau auprès d'Airtable, sans aucune interaction de votre part. 3. Le nouveau token est chiffré et sauvegardé. L'appel API original est ensuite effectué avec le nouveau token.

Le seul cas où ce renouvellement peut échouer est si vous avez révoqué les permissions d'Embases directement depuis votre compte Airtable (Airtable → votre avatar → Autorisations). Dans ce cas, vos embeds Airtable afficheront une erreur de connexion et vous devrez reconnecter Airtable depuis la page Intégrations.

Utilisation dans un espace d'équipe

Dans un workspace Embases, chaque membre peut connecter son propre compte Airtable de manière indépendante — le même modèle que pour Notion. Il n'y a pas de token Airtable partagé à l'échelle du workspace.

Chaque membre connecté apparaît dans la liste des connexions Airtable du workspace (page workspace → Intégration) avec son nom de compte et son email Airtable.

Le cas particulier : un membre déjà connecté dans son hub personnel. Lorsqu'il se connecte depuis la page Intégration d'un workspace, Embases effectue un second flux OAuth distinct — même si c'est le même compte Airtable. Il obtient deux tokens indépendants : un pour son hub, un pour le workspace. La liste de bases épinglées est séparée dans chaque contexte. Ce cloisonnement est garanti par le système de sélection : une base ajoutée dans le hub n'apparaît pas dans le workspace, et inversement — même si le token Airtable sous-jacent y donne techniquement accès.

Droits et permissions dans le workspace : • Chaque membre peut connecter, déconnecter et gérer ses propres bases épinglées. • 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.

Quand un embed utilise une base Airtable d'un membre, c'est le token de ce membre qui est utilisé — y compris son refresh token si l'access token a expiré. Si ce membre se déconnecte, les embeds basés sur ses bases afficheront une erreur jusqu'à reconnexion.

Différence avec Google Sheets : Airtable permet des connexions multiples dans un workspace (une par membre), tandis que Google Sheets utilise une seule clé API partagée pour tout le workspace.

Déconnecter Airtable

Pour supprimer la connexion Airtable de votre compte Embases :

1. 1Allez sur la page Intégrations (barre latérale → Intégrations).
2. 2Sur la carte Airtable, cliquez sur « Déconnecter ».
3. 3Confirmez la déconnexion dans la boîte de dialogue.
4. 4L'access token et le refresh token sont immédiatement supprimés d'Embases. Toutes vos bases épinglées sont également effacées.