Airtable

Sincronizza le tue tabelle 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 Airtable tramite API key
• 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

1. Accedi al tuo account Airtable
2. Vai su Impostazioni Account → Developer hub
3. Clicca su Crea nuovo token
4. Configura il tuo token:
   • Nome: AI SmartTalk Integration
   • Scopes: Seleziona data.records:read e schema.bases:read
   • Accesso: Scegli le basi specifiche che desideri connettere
5. 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

1. Accedi al tuo account AI SmartTalk
2. Naviga su Impostazioni → Integrazioni
3. Trova Airtable e clicca su Connetti
4. Incolla la tua chiave API nel campo Token di Accesso Personale
5. Clicca su Valida

Passo 3: Seleziona le Tabelle da Sincronizzare

Dopo la validazione, vedrai le tue basi e tabelle disponibili:

1. Sfoglia basi: Clicca per espandere ogni base
2. Seleziona tabelle: Seleziona le tabelle che desideri sincronizzare
3. Configura campi: Scegli quali colonne includere
4. Clicca su Inizia Sincronizzazione

Passo 4: Verifica l'Importazione

1. Vai su Conoscenza in AI SmartTalk
2. I tuoi record Airtable appariranno come voci di conoscenza individuali
3. 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 qualità 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
• Escludi campi: Campi interni da saltare (ID, timestamp, ecc.)

Frequenza di Sincronizzazione

Opzione	Descrizione
Manuale	Clicca "Sincronizza Ora" quando necessario
All'importazione	Sincronizza quando attivi un'importazione
Programmato	Configura tramite SmartFlow (vedi sotto)

Programmazione con SmartFlow

Per sincronizzare automaticamente i tuoi dati Airtable:

1. Crea un nuovo SmartFlow
2. Aggiungi un trigger Programmato (giornaliero, settimanale, ecc.)
3. Aggiungi l'azione Sincronizza → Seleziona Airtable
4. Salva e attiva il flusso di lavoro

---

Casi d'Uso

Catalogo Prodotti/Servizi

Sincronizza il tuo database di prodotti affinché 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 tua politica di rimborso?"
• "Dove posso trovare la mia fattura?"

Directory 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 programma?"
• "Quando è il prossimo webinar?"
• "Cosa è successo all'incontro del mese scorso?"

---

Risoluzione dei Problemi

Problemi di Connessione

Problema	Soluzione
"API key non valida"	Rigenera il token nel Developer hub di Airtable
"Base non trovata"	Assicurati che il token abbia accesso a quella base
"Permesso negato"	Aggiungi lo scope 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 Trova Dati

Problema	Soluzione
Nessun risultato per le query	Aspetta che la sincronizzazione sia completata e che l'AI elabori
Risposte parziali	Assicurati che tutti i campi rilevanti siano inclusi nella sincronizzazione

---

Gestione della Connessione

Azione	Come
Aggiorna API key	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

1. Struttura per AI: Usa nomi di campo chiari e descrittivi
2. Deduplica i dati: Rimuovi i record duplicati prima della sincronizzazione
3. Usa i campi principali con saggezza: Scegli identificatori unici e descrittivi
4. Sincronizzazioni regolari: Mantieni i dati aggiornati, specialmente per contenuti in cambiamento
5. Limita lo scope: Sincronizza solo le tabelle di cui la tua 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