Airtable

Sincronizați tabelele Airtable în baza de cunoștințe AI SmartTalk. Transformați datele structurate în cunoștințe interogabile de AI—perfect pentru cataloage de produse, întrebări frecvente, directoare de echipă și multe altele.

---

Prezentare generală

Integrarea Airtable vă permite să:

• Conectați baza dvs. Airtable prin API key
• Sincronizați datele din tabele ca intrări în baza de cunoștințe
• Interogați datele dvs. conversațional prin AI
• Mențineți datele actualizate cu sincronizări manuale sau programate

---

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

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

---

Configurare pas cu pas

Pasul 1: Generați API Key-ul dvs. Airtable

1. Conectați-vă la contul dvs. Airtable
2. Accesați Setările contului → Developer hub
3. Faceți clic pe Creează un nou token
4. Configurați tokenul dvs.:
   • Nume: AI SmartTalk Integration
   • Scopes: Selectați data.records:read și schema.bases:read
   • Acces: Alegeți bazele specifice pe care doriți să le conectați
5. Faceți clic pe Creează token și copiați-l imediat

Important: Salvați tokenul în siguranță—Airtable îl arată doar o dată!

Pasul 2: Conectați-vă la AI SmartTalk

1. Conectați-vă la contul dvs. AI SmartTalk
2. Navigați la Setări → Integrări
3. Găsiți Airtable și faceți clic pe Conectare
4. Lipiți API key-ul dvs. în câmpul Token de acces personal
5. Faceți clic pe Validare

Pasul 3: Selectați tabelele de sincronizat

După validare, veți vedea bazele și tabelele disponibile:

1. Răsfoiți bazele: Faceți clic pentru a extinde fiecare bază
2. Selectați tabele: Bifați tabelele pe care doriți să le sincronizați
3. Configurați câmpurile: Alegeți ce coloane să includeți
4. Faceți clic pe Începeți sincronizarea

Pasul 4: Verificați importul

1. Accesați Cunoștințe în AI SmartTalk
2. Înregistrările dvs. Airtable apar ca intrări individuale în baza de cunoștințe
3. Testați AI-ul dvs. punând întrebări despre datele dvs.

---

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
Selectare/Selectare multiplă	Tratați ca categorii/etichete
Înregistrări legate	Referințele incluse
Atașamente	URL-uri referite (fișierele nu sunt descărcate)
Formule	Valori calculate sincronizate

Exemplu: Catalog de produse

Dacă aveți un 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 dvs. 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
• Excluderea câmpurilor: Câmpuri interne de omis (ID-uri, timpi, etc.)

Frecvența sincronizării

Opțiune	Descriere
Manual	Faceți clic pe "Sincronizați 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 dvs. 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 de produse/servicii

Sincronizați baza de date a produselor astfel încât clienții să poată întreba:

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

FAQ / Baza de cunoștințe

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

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

Director de echipă

Sincronizați datele membrilor echipei pentru interogări interne:

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

Date despre evenimente/program

Sincronizați tabelele de evenimente pentru interogări de programare:

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

---

Depanare

Probleme de conexiune

Problemă	Soluție
"API key invalid"	Regenerați tokenul în Developer hub Airtable
"Baza nu a fost găsită"	Asigurați-vă că tokenul are acces la acea bază
"Permisiune refuzată"	Adăugați data.records:read scope la tokenul dvs.

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 Sincronizați acum pentru a actualiza
Sincronizarea câmpurilor greșite	Revizuiți selecția câmpurilor în setările integrării

AI-ul 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 API key	Setări → Integrări → Airtable → Actualizați Token
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 → Integrări → Airtable → Deconectați

---

Cele mai bune practici

1. Structurați 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 care se schimbă
5. Limitați domeniul: Sincronizați doar tabelele de care AI-ul dvs. are nevoie pentru a răspunde la întrebări

---

Documentație conexă

• 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