Airtable

Sinċronizza t-tables tiegħek ta' Airtable fil-bażi tal-għarfien ta' AI SmartTalk. Ittraduċi d-dejta strutturata tiegħek f'għarfien li jista' jiġi mistoqsi mill-AI—ideali għall-kataloġhi tal-prodotti, FAQs, dizzjunarji tat-tim, u aktar.

---

Overview

L-integrazzjoni ta' Airtable tippermettilek li:

• Tikkonnettja l-bażi tiegħek ta' Airtable permezz tal-API key
• Sinċronizza d-dejta tat-tabelli bħala entries fil-bażi tal-għarfien
• Mistoqsi d-dejta tiegħek b'mod konversazzjonali permezz tal-AI
• Żomm id-dejta friski b'sinċronizzazzjonijiet manwali jew skedati

---

Prerequisites

Qabel ma tibda, kun żgur li għandek:

• Kont attiv ta' AI SmartTalk
• Kont ta' Airtable b'inqas bażi waħda
• API key ta' Airtable (Personal Access Token)

---

Step-by-Step Setup

Step 1: Generate Your Airtable API Key

1. Log in fil-kont tiegħek ta' Airtable
2. Mur fil-Settings tal-Kont → Developer hub
3. Ikklikkja Create new token
4. Ikkonfigura t-token tiegħek:
   • Isem: AI SmartTalk Integration
   • Scopes: Agħżel data.records:read u schema.bases:read
   • Access: Agħżel il-bażi speċifiċi li tixtieq tikkonnettja
5. Ikklikkja Create token u kkopja immedjatament

Importanti: Iħażen it-token tiegħek b'mod sikur—Airtable turiha biss darba!

Step 2: Connect to AI SmartTalk

1. Log in fil-kont tiegħek ta' AI SmartTalk
2. Naviga lejn Settings → Integrations
3. Sib Airtable u ikklikkja Connect
4. Ippasta l-API key tiegħek fil-qasam Personal Access Token
5. Ikklikkja Validate

Step 3: Select Tables to Sync

Wara l-validazzjoni, tara l-bażi u t-tabelli disponibbli tiegħek:

1. Iċċekkja l-bażi: Ikklikkja biex tespandi kull bażi
2. Agħżel it-tabelli: Iċċekkja t-tabelli li tixtieq sinċronizza
3. Ikonfigura l-kampijiet: Agħżel liema kolonni tixtieq tinkludi
4. Ikklikkja Start Sync

Step 4: Verify the Import

1. Mur fil-Knowledge f'AI SmartTalk
2. Ir-rekords tiegħek ta' Airtable jidhru bħala entries individwali tal-għarfien
3. Ittestja l-AI tiegħek billi tistaqsi mistoqsijiet dwar id-dejta tiegħek

---

What Gets Synced

Data Type	How It's Processed
Text fields	Sinċronizzati bħala kontenut li jista' jiġi mfittx
Number fields	Inkludi fil-kuntest tar-rekord
Select/Multi-select	Trattati bħala kategoriji/tags
Linked records	Referenzi inklużi
Attachments	URLs referenzi (fajls mhux niżżel)
Formulas	Valuri kkalkulati sinċronizzati

Example: Product Catalog

Jekk għandek tabella "Prodotti":

Isem	Deskrizzjoni	Prezz	Kategorija
Widget Pro	Widget ta' grad professjonali...	$99	Għodod
Widget Lite	Widget ta' livell ta' dħul...	$49	Għodod

Il-AI tiegħek tista' tweġib:

• "X'prodotti għandek?"
• "Għidli dwar Widget Pro"
• "X'inhu l-aktar għodda irħisa tiegħek?"

---

Sync Configuration

Field Selection

Għal kull tabella, tista' tikkonfigura:

• Primary field: Identifikatur ewlieni għal kull rekord
• Content fields: Fields li għandhom jiġu inklużi fil-bażi ta' għarfien
• Exclude fields: Fields interni li għandhom jiġu evitati (IDs, timestamps, eċċ.)

Sync Frequency

Option	Deskrizzjoni
Manual	Ikklikkja "Sync Now" meta jkun meħtieġ
On import	Jissinkronizza meta tikkawża importazzjoni
Scheduled	Iwaqqaf permezz ta' SmartFlow (ara hawn taħt)

Scheduling with SmartFlow

Biex issinkronizza awtomatikament id-dejta tiegħek ta' Airtable:

1. Oħloq SmartFlow ġdid
2. Żid trigger Scheduled (kuljum, kull ġimgħa, eċċ.)
3. Żid l-azzjoni Sync → Agħżel Airtable
4. Iħżen u attiva l-fluss tax-xogħol

---

Use Cases

Product/Service Catalog

Issinkronizza d-database tal-prodotti tiegħek sabiex il-klijenti jkunu jistgħu jitolbu:

• "X'prodotti għandek taħt $100?"
• "Paraguna Widget Pro u Widget Lite"
• "Għandek xejn fil-kategorija tal-Gadgets?"

FAQ / Knowledge Base

Ħażen FAQs f'Airtable bil-kolonni Mistoqsija/Weġiba:

• "Kif nista' nresetja l-password tiegħi?"
• "X'inhi l-politika ta' rifużjoni tiegħek?"
• "Fejn nista' nsib il-fattura tiegħi?"

Team Directory

Issinkronizza d-dejta tal-membri tat-tim għal mistoqsijiet interni:

• "Min jieħu ħsieb il-appoġġ tal-klijenti?"
• "X'ħidma għandha Sarah?"
• "Elenka lil kulħadd fit-tim tal-Inġinerija"

Event/Schedule Data

Issinkronizza t-tables tal-avvenimenti għal mistoqsijiet ta' skedul:

• "X'ġrajjiet qed jiġu?"
• "Meta huwa l-webinar li jmiss?"
• "X'ġara fil-laqgħa tal-xahar li għadda?"

---

Troubleshooting

Connection Issues

Problema	Soluzzjoni
"Invalid API key"	Irriġenera t-token fil-hub tal-iżviluppaturi ta' Airtable
"Base not found"	Żgura li t-token għandha aċċess għal dik il-bażi
"Permission denied"	Żid is-skop data.records:read għat-token tiegħek

Sync Issues

Problema	Soluzzjoni
Rekords nieqsa	Iċċekkja li r-rekords mhumiex imfiltar/mohbija fil-view
Dejta stale	Ikklikkja Sync Now biex tħarreġ
Fields ħżiena qed jissinkronizzaw	Irrevedi l-għażla tal-fields fil-settings tal-integrazzjoni

AI Can't Find Data

Problema	Soluzzjoni
L-ebda riżultati għall-mistoqsijiet	Stenna biex is-sinkronizzazzjoni tkompli u l-AI jipproċessa
Risposti parzjali	Żgura li l-fields kollha relevanti huma inklużi fis-sinkronizzazzjoni

---

Managing the Connection

Azzjoni	Kif
Update API key	Settings → Integrations → Airtable → Update Token
Add tables	Edit connection → Agħżel tabelli addizzjonali
Remove tables	Iċċekkja t-tables li m'għandekx aktar bżonn issinkronizza
Disconnect	Settings → Integrations → Airtable → Disconnect

---

Best Practices

1. Struttura għal AI: Uża isimijiet ta' fields ċari u deskrittivi
2. Deduplicate data: Neħħi r-rekords duplicati qabel issinkronizza
3. Uża l-fields primarji b'mod għaqli: Agħżel identifikaturi uniċi u deskrittivi
4. Sync regolari: Żomm id-dejta friska, speċjalment għal kontenut li qed jinbidel
5. Limit scope: Biss issinkronizza t-tables li l-AI tiegħek għandha bżonn biex tweġiba mistoqsijiet

---

Dokumentazzjoni Relatata

• Oversight tal-Integrazzjonijiet
• Ġestjoni tal-Bażi ta' Għarfien
• Importazzjoni ta' CSV URL — Alternattiva għal data statika
• Ħeġġiċi Skedati ta' SmartFlow — Ittimbrar awtomatiku