Airtable
Sincronizza le tue tabelle di Airtable nella base di conoscenza di AI SmartTalk. Trasforma i tuoi dati strutturati in conoscenza interrogabile tramite AI—perfetto per cataloghi di prodotti, FAQ, directory di team e altro ancora.
Panoramica
L'integrazione di Airtable ti consente di:
- Connettere la tua base di Airtable tramite chiave API
- Sincronizzare i dati delle tabelle come voci della base di conoscenza
- Interrogare i tuoi dati in modo conversazionale tramite l'AI
- Mantenere i dati aggiornati con sincronizzazioni manuali o programmate
Requisiti
Prima di iniziare, assicurati di avere:
- Un account attivo di AI SmartTalk
- Un account Airtable con almeno una base
- Una chiave API di Airtable (Token di Accesso Personale)
Procedura Passo-Passo
Passo 1: Genera la tua chiave API di Airtable
- Accedi al tuo account Airtable
- Vai su Impostazioni dell'Account → Developer hub
- Clicca su Crea nuovo token
- Configura il tuo token:
- Nome:
AI SmartTalk Integration - Scopes: Seleziona
data.records:readeschema.bases:read - Accesso: Scegli le basi specifiche che desideri connettere
- Nome:
- Clicca su Crea token e copialo immediatamente
Importante: Salva il tuo token in modo sicuro—Airtable lo mostra solo una volta!
Passo 2: Connetti a AI SmartTalk
- Accedi al tuo account AI SmartTalk
- Naviga su Impostazioni → Integrazioni
- Trova Airtable e clicca su Connetti
- Incolla la tua chiave API nel campo Token di Accesso Personale
- Clicca su Valida
Passo 3: Seleziona le Tabelle da Sincronizzare
Dopo la convalida, vedrai le tue basi e tabelle disponibili:
- Sfoglia basi: Clicca per espandere ciascuna base
- Seleziona tabelle: Seleziona le tabelle che desideri sincronizzare
- Configura campi: Scegli quali colonne includere
- Clicca su Inizia Sincronizzazione
Passo 4: Verifica l'Importazione
- Vai su Conoscenza in AI SmartTalk
- I tuoi record di Airtable appariranno come singole voci di conoscenza
- Metti alla prova la tua AI ponendo domande sui tuoi dati
Cosa Viene Sincronizzato
| Tipo di Dato | Come Viene Elaborato |
|---|---|
| Campi di testo | Sincronizzati come contenuto ricercabile |
| Campi numerici | Inclusi nel contesto del record |
| Selezione/Multi-selezione | Trattati come categorie/tag |
| Record collegati | Riferimenti inclusi |
| Allegati | URL referenziati (file non scaricati) |
| Formule | Valori calcolati sincronizzati |
Esempio: Catalogo Prodotti
Se hai una tabella "Prodotti":
| Nome | Descrizione | Prezzo | Categoria |
|---|---|---|---|
| Widget Pro | Widget di livello professionale... | $99 | Strumenti |
| Widget Lite | Widget di livello base... | $49 | Strumenti |
La tua AI può rispondere:
- "Quali prodotti hai?"
- "Parlami di Widget Pro"
- "Qual è il tuo strumento più economico?"
Configurazione della Sincronizzazione
Selezione dei Campi
Per ogni tabella, puoi configurare:
- Campo principale: Identificatore principale per ogni record
- Campi di contenuto: Campi da includere nella base di conoscenza
- Campi da escludere: Campi interni da saltare (ID, timestamp, ecc.)
Frequenza di Sincronizzazione
| Opzione | Descrizione |
|---|---|
| Manuale | Clicca su "Sincronizza ora" quando necessario |
| All'importazione | Sincronizza quando attivi un'importazione |
| Programmato | Configurato tramite SmartFlow (vedi sotto) |
Programmazione con SmartFlow
Per sincronizzare automaticamente i tuoi dati di Airtable:
- Crea un nuovo SmartFlow
- Aggiungi un trigger Programmato (giornaliero, settimanale, ecc.)
- Aggiungi l'azione Sincronizza → Seleziona Airtable
- Salva e attiva il flusso di lavoro
Casi d'Uso
Catalogo Prodotti/Servizi
Sincronizza il tuo database prodotti in modo che i clienti possano chiedere:
- "Quali prodotti hai sotto i $100?"
- "Confronta Widget Pro e Widget Lite"
- "Hai qualcosa nella categoria Strumenti?"
FAQ / Base di Conoscenza
Memorizza le FAQ in Airtable con colonne Domanda/Risposta:
- "Come posso reimpostare la mia password?"
- "Qual è la vostra politica di rimborso?"
- "Dove posso trovare la mia fattura?"
Rubrica del Team
Sincronizza i dati dei membri del team per query interne:
- "Chi si occupa del supporto clienti?"
- "Qual è il ruolo di Sarah?"
- "Elenca tutti nel team di Ingegneria"
Dati di Eventi/Programmazione
Sincronizza le tabelle degli eventi per query di programmazione:
- "Quali eventi ci sono in arrivo?"
- "Quando è il prossimo webinar?"
- "Cosa è successo all'incontro del mese scorso?"
Risoluzione dei Problemi
Problemi di Connessione
| Problema | Soluzione |
|---|---|
| "Chiave API non valida" | Rigenera il token nel hub per sviluppatori di Airtable |
| "Base non trovata" | Assicurati che il token abbia accesso a quella base |
| "Permesso negato" | Aggiungi il campo data.records:read al tuo token |
Problemi di Sincronizzazione
| Problema | Soluzione |
|---|---|
| Record mancanti | Controlla che i record non siano filtrati/nascosti nella vista |
| Dati obsoleti | Clicca su Sincronizza ora per aggiornare |
| Sincronizzazione di campi errati | Rivedi la selezione dei campi nelle impostazioni di integrazione |
L'AI Non Riesce a Trovare Dati
| Problema | Soluzione |
|---|---|
| Nessun risultato per le query | Attendi il completamento della sincronizzazione e l'elaborazione da parte dell'AI |
| Risposte parziali | Assicurati che tutti i campi rilevanti siano inclusi nella sincronizzazione |
Gestione della Connessione
| Azione | Come |
|---|---|
| Aggiorna chiave API | Impostazioni → Integrazioni → Airtable → Aggiorna Token |
| Aggiungi tabelle | Modifica connessione → Seleziona tabelle aggiuntive |
| Rimuovi tabelle | Deseleziona le tabelle che non desideri più sincronizzare |
| Disconnetti | Impostazioni → Integrazioni → Airtable → Disconnetti |
Migliori Pratiche
- Struttura per l'AI: Usa nomi di campo chiari e descrittivi
- Deduplica i dati: Rimuovi i record duplicati prima della sincronizzazione
- Usa i campi principali con saggezza: Scegli identificatori unici e descrittivi
- Sincronizzazioni regolari: Mantieni i dati aggiornati, specialmente per contenuti in cambiamento
- Limita l'ambito: Sincronizza solo le tabelle di cui l'AI ha bisogno per rispondere alle domande
Documentazione Correlata
- Panoramica delle Integrazioni
- Gestione della Base di Conoscenza
- Importazione URL CSV — Alternativa per dati statici
- Trigger Programmati di SmartFlow — Automatizza le sincronizzazioni