Airtable
Synchronisez vos tables Airtable dans la base de connaissances d'AI SmartTalk. Transformez vos données structurées en connaissances interrogeables par l'IA—parfait pour les catalogues de produits, les FAQ, les annuaires d'équipe, et plus encore.
Vue d'ensemble
L'intégration Airtable vous permet de :
- Connecter votre base Airtable via une clé API
- Synchroniser les données des tables en tant qu'entrées de la base de connaissances
- Interroger vos données de manière conversationnelle via l'IA
- Maintenir les données à jour avec des synchronisations manuelles ou programmées
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un compte AI SmartTalk actif
- Un compte Airtable avec au moins une base
- Une clé API Airtable (Jeton d'accès personnel)
Configuration étape par étape
Étape 1 : Générer votre clé API Airtable
- Connectez-vous à votre compte Airtable
- Allez dans Paramètres du compte → Centre des développeurs
- Cliquez sur Créer un nouveau jeton
- Configurez votre jeton :
- Nom :
Intégration AI SmartTalk - Scopes : Sélectionnez
data.records:readetschema.bases:read - Accès : Choisissez les bases spécifiques que vous souhaitez connecter
- Nom :
- Cliquez sur Créer le jeton et copiez-le immédiatement
Important : Conservez votre jeton en sécurité—Airtable ne l'affiche qu'une seule fois !
Étape 2 : Connectez-vous à AI SmartTalk
- Connectez-vous à votre compte AI SmartTalk
- Accédez à Paramètres → Intégrations
- Trouvez Airtable et cliquez sur Connecter
- Collez votre clé API dans le champ Jeton d'accès personnel
- Cliquez sur Valider
Étape 3 : Sélectionnez les tables à synchroniser
Après validation, vous verrez vos bases et tables disponibles :
- Parcourir les bases : Cliquez pour développer chaque base
- Sélectionner les tables : Cochez les tables que vous souhaitez synchroniser
- Configurer les champs : Choisissez quelles colonnes inclure
- Cliquez sur Démarrer la synchronisation
Étape 4 : Vérifiez l'importation
- Allez dans Connaissance dans AI SmartTalk
- Vos enregistrements Airtable apparaissent comme des entrées de connaissance individuelles
- Testez votre IA en posant des questions sur vos données
Ce qui est synchronisé
| Type de données | Comment c'est traité |
|---|---|
| Champs de texte | Synchronisés en tant que contenu consultable |
| Champs numériques | Inclus dans le contexte des enregistrements |
| Sélection/Multi-sélection | Considérés comme des catégories/étiquettes |
| Enregistrements liés | Références incluses |
| Pièces jointes | URLs référencées (fichiers non téléchargés) |
| Formules | Valeurs calculées synchronisées |
Exemple : Catalogue de produits
Si vous avez une table "Produits" :
| Nom | Description | Prix | Catégorie |
|---|---|---|---|
| Widget Pro | Widget de qualité professionnelle... | 99 $ | Outils |
| Widget Lite | Widget d'entrée de gamme... | 49 $ | Outils |
Votre IA peut répondre :
- "Quels produits avez-vous ?"
- "Parlez-moi de Widget Pro"
- "Quel est votre outil le moins cher ?"
Configuration de la Synchronisation
Sélection des Champs
Pour chaque table, vous pouvez configurer :
- Champ principal : Identifiant principal pour chaque enregistrement
- Champs de contenu : Champs à inclure dans la base de connaissances
- Champs à exclure : Champs internes à ignorer (IDs, horodatages, etc.)
Fréquence de Synchronisation
| Option | Description |
|---|---|
| Manuel | Cliquez sur "Synchroniser maintenant" lorsque nécessaire |
| À l'importation | Synchronise lorsque vous déclenchez une importation |
| Planifié | Configuré via SmartFlow (voir ci-dessous) |
Planification avec SmartFlow
Pour synchroniser automatiquement vos données Airtable :
- Créez un nouveau SmartFlow
- Ajoutez un déclencheur Planifié (quotidien, hebdomadaire, etc.)
- Ajoutez l'action Synchroniser → Sélectionnez Airtable
- Enregistrez et activez le flux de travail
Cas d'Utilisation
Catalogue de Produits/Services
Synchronisez votre base de données de produits afin que les clients puissent demander :
- "Quels produits avez-vous à moins de 100 $ ?"
- "Comparez Widget Pro et Widget Lite"
- "Avez-vous quelque chose dans la catégorie Outils ?"
FAQ / Base de Connaissances
Stockez les FAQ dans Airtable avec des colonnes Question/Réponse :
- "Comment réinitialiser mon mot de passe ?"
- "Quelle est votre politique de remboursement ?"
- "Où puis-je trouver ma facture ?"
Annuaire d'Équipe
Synchronisez les données des membres de l'équipe pour des requêtes internes :
- "Qui s'occupe du support client ?"
- "Quel est le rôle de Sarah ?"
- "Listez tous les membres de l'équipe d'ingénierie"
Données d'Événements/Calendrier
Synchronisez les tables d'événements pour des requêtes de planification :
- "Quels événements sont à venir ?"
- "Quand est le prochain webinaire ?"
- "Que s'est-il passé lors de la rencontre du mois dernier ?"
Dépannage
Problèmes de Connexion
| Problème | Solution |
|---|---|
| "Clé API invalide" | Régénérez le token dans le hub développeur Airtable |
| "Base non trouvée" | Assurez-vous que le token a accès à cette base |
| "Permission refusée" | Ajoutez la portée data.records:read à votre token |
Problèmes de Synchronisation
| Problème | Solution |
|---|---|
| Enregistrements manquants | Vérifiez que les enregistrements ne sont pas filtrés/cachés dans la vue |
| Données obsolètes | Cliquez sur Synchroniser maintenant pour rafraîchir |
| Mauvais champs synchronisés | Revoyez la sélection des champs dans les paramètres d'intégration |
L'IA Ne Peut Pas Trouver de Données
| Problème | Solution |
|---|---|
| Pas de résultats pour les requêtes | Attendez que la synchronisation soit terminée et que l'IA traite |
| Réponses partielles | Assurez-vous que tous les champs pertinents sont inclus dans la synchronisation |
Gestion de la Connexion
| Action | Comment |
|---|---|
| Mettre à jour la clé API | Paramètres → Intégrations → Airtable → Mettre à jour le Token |
| Ajouter des tables | Modifier la connexion → Sélectionner des tables supplémentaires |
| Supprimer des tables | Décochez les tables que vous ne souhaitez plus synchroniser |
| Déconnecter | Paramètres → Intégrations → Airtable → Déconnecter |
Meilleures Pratiques
- Structure pour l'IA : Utilisez des noms de champs clairs et descriptifs
- Dédupliquez les données : Supprimez les enregistrements en double avant de synchroniser
- Utilisez judicieusement les champs principaux : Choisissez des identifiants uniques et descriptifs
- Synchronisations régulières : Gardez les données à jour, surtout pour le contenu changeant
- Limitez la portée : Synchronisez uniquement les tables dont votre IA a besoin pour répondre aux questions
Documentation Connexe
- Aperçu des Intégrations
- Gestion de la Base de Connaissances
- Importation d'URL CSV — Alternative pour les données statiques
- Déclencheurs Planifiés SmartFlow — Automatiser les synchronisations