Airtable

Sincronizați tabelele dvs. Airtable în baza de cunoștințe a AI SmartTalk. Transformați datele structurate în cunoștințe interogabile prin 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 intermediul 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. Mergeți la 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 dvs. î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 Personal Access Token
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 tabelele: Bifați tabelele pe care doriți să le sincronizați
3. Configurați câmpurile: Alegeți coloanele pe care doriți să le includeți
4. Faceți clic pe Începeți sincronizarea

Pasul 4: Verificați importul

1. Mergeți la 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/tag-uri
Înregistrări legate	Referințele sunt incluse
Atașamente	URL-uri referite (fișierele nu sunt descărcate)
Formule	Valori calculate sincronizate

Exemplu: Catalog de produse

Dacă aveți 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 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 sărit (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ă 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 dvs. 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 întrebă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 întrebă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 Airtable Developer hub
"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 AI-ului
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. Eliminați datele duplicate: Î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 întrebărilor

---

Documentație conexă

• Prezentare generală a integrărilor
• Gestionarea bazei de cunoștințe
• Import CSV URL — Alternativă pentru date statice
• Declanșatoare programate SmartFlow — Automatizați sincronizările