Airtable

Sincronizează tabelele tale Airtable în baza de cunoștințe a AI SmartTalk. Transformă datele tale structurate în cunoștințe accesibile prin AI—perfect pentru cataloage de produse, întrebări frecvente, directoare de echipă și multe altele.

---

Prezentare generală

Integrarea Airtable îți permite să:

• Conectezi baza ta Airtable prin API key
• Sincronizezi datele din tabele ca intrări în baza de cunoștințe
• Interoghezi datele tale conversațional prin AI
• Menții datele actualizate cu sincronizări manuale sau programate

---

Cerințe preliminare

Înainte de a începe, asigură-te că ai:

• Un cont activ AI SmartTalk
• Un cont Airtable cu cel puțin o bază
• Un API key Airtable (Personal Access Token)

---

Configurare Pas cu Pas

Pasul 1: Generează API Key-ul tău Airtable

1. Autentifică-te în contul tău Airtable
2. Mergi la Setările contului → Developer hub
3. Fă clic pe Creează un token nou
4. Configurează-ți token-ul:
   • Nume: AI SmartTalk Integration
   • Scopes: Selectează data.records:read și schema.bases:read
   • Acces: Alege bazele specifice pe care vrei să le conectezi
5. Fă clic pe Creează token și copiază-l imediat

Important: Salvează-ți token-ul în siguranță—Airtable îl arată doar o dată!

Pasul 2: Conectează-te la AI SmartTalk

1. Autentifică-te în contul tău AI SmartTalk
2. Navighează la Setări → Integrări
3. Găsește Airtable și fă clic pe Conectează
4. Lipește API key-ul tău în câmpul Personal Access Token
5. Fă clic pe Validează

Pasul 3: Selectează Tabelele de Sincronizat

După validare, vei vedea bazele și tabelele disponibile:

1. Răsfoiește bazele: Fă clic pentru a extinde fiecare bază
2. Selectează tabele: Bifează tabelele pe care vrei să le sincronizezi
3. Configurează câmpurile: Alege coloanele pe care vrei să le incluzi
4. Fă clic pe Începe Sincronizarea

Pasul 4: Verifică Importul

1. Mergi la Cunoștințe în AI SmartTalk
2. Înregistrările tale Airtable apar ca intrări individuale în baza de cunoștințe
3. Testează AI-ul tău punând întrebări despre datele tale

---

Ce Se Sincronizează

Tip de date	Cum este procesat
Câmpuri text	Sincronizate ca conținut căutabil
Câmpuri numerice	Incluse în contextul înregistrării
Select/Multi-select	Tratați ca categorii/etichete
Înregistrări legate	Referințele sunt incluse
Atașamente	URL-uri referite (fișierele nu sunt descărcate)
Formule	Valorile calculate sunt sincronizate

Exemplu: Catalog de Produse

Dacă ai o tabelă "Produse":

Nume	Descriere	Preț	Categorie
Widget Pro	Widget de calitate profesională...	$99	Unelte
Widget Lite	Widget de nivel de intrare...	$49	Unelte

AI-ul tău poate răspunde:

• "Ce produse aveți?"
• "Spune-mi despre Widget Pro"
• "Care este cea mai ieftină unealtă?"

---

Configurarea Sincronizării

Selectarea Câmpurilor

Pentru fiecare tabel, puteți configura:

• Câmp principal: Identificatorul principal pentru fiecare înregistrare
• Câmpuri de conținut: Câmpuri de inclus în baza de cunoștințe
• Câmpuri excluse: Câmpuri interne de omis (ID-uri, timpi, etc.)

Frecvența Sincronizării

Opțiune	Descriere
Manual	Faceți clic pe "Sincronizare acum" când este necesar
La import	Sincronizează atunci când declanșați un import
Programat	Configurați prin SmartFlow (vezi mai jos)

Programarea cu SmartFlow

Pentru a sincroniza automat datele din Airtable:

1. Creați un nou SmartFlow
2. Adăugați un declanșator Programat (zilnic, săptămânal, etc.)
3. Adăugați acțiunea Sincronizare → Selectați Airtable
4. Salvați și activați fluxul de lucru

---

Cazuri de Utilizare

Catalog Produse/Servicii

Sincronizați baza de date a produselor pentru ca clienții să poată întreba:

• "Ce produse aveți sub 100$?"
• "Comparați Widget Pro și Widget Lite"
• "Aveți ceva în categoria Unelte?"

Întrebări Frecvente / Baza de Cunoștințe

Stocați întrebările frecvente în Airtable cu coloane Întrebare/Răspuns:

• "Cum îmi resetez parola?"
• "Care este politica de returnare?"
• "Unde pot găsi factura mea?"

Director de Echipă

Sincronizați datele membrilor echipei pentru întrebări interne:

• "Cine se ocupă de suportul clienți?"
• "Care este rolul lui Sarah?"
• "Listați pe toți din echipa de Inginerie"

Date Evenimente/Program

Sincronizați tabelele de evenimente pentru întrebări legate de programare:

• "Ce evenimente urmează?"
• "Când este următorul webinar?"
• "Ce s-a întâmplat la întâlnirea de luna trecută?"

---

Rezolvarea Problemelor

Probleme de Conexiune

Problemă	Soluție
"Cheie API invalidă"	Regenerați tokenul în centrul de dezvoltare Airtable
"Baza nu a fost găsită"	Asigurați-vă că tokenul are acces la acea bază
"Permisiune refuzată"	Adăugați domeniul data.records:read la tokenul dumneavoastră

Probleme de Sincronizare

Problemă	Soluție
Înregistrări lipsă	Verificați că înregistrările nu sunt filtrate/ascunse în vizualizare
Date învechite	Faceți clic pe Sincronizare acum pentru a actualiza
Sincronizarea câmpurilor greșite	Revizuiți selecția câmpurilor în setările de integrare

AI Nu Poate Găsi Date

Problemă	Soluție
Fără rezultate pentru interogări	Așteptați finalizarea sincronizării și procesarea de către AI
Răspunsuri parțiale	Asigurați-vă că toate câmpurile relevante sunt incluse în sincronizare

---

Gestionarea Conexiunii

Acțiune	Cum
Actualizați cheia API	Setări → Integrații → Airtable → Actualizați Tokenul
Adăugați tabele	Editați conexiunea → Selectați tabele suplimentare
Eliminați tabele	Debifați tabelele pe care nu doriți să le sincronizați
Deconectați	Setări → Integrații → Airtable → Deconectați

---

Cele Mai Bune Practici

1. Structură pentru AI: Utilizați nume de câmpuri clare și descriptive
2. Deduplicarea datelor: Îndepărtați înregistrările duplicate înainte de sincronizare
3. Utilizați câmpurile principale cu înțelepciune: Alegeți identificatori unici și descriptivi
4. Sincronizări regulate: Mențineți datele actualizate, mai ales pentru conținutul în schimbare
5. Limitați domeniul: Sincronizați doar tabelele de care AI are nevoie pentru a răspunde întrebărilor

Documentație Relaționată

• Prezentare Generală a Integrărilor
• Gestionarea Bazei de Cunoștințe
• Import URL CSV — Alternativă pentru date statice
• Declanșatoare Programate SmartFlow — Automatizați sincronizările