Airtable

Synchroniseer je Airtable-tabellen met de kennisbasis van AI SmartTalk. Zet je gestructureerde gegevens om in AI-doorzoekbare kennis—perfect voor productcatalogi, FAQ's, teamdirectories en meer.

---

Overzicht

De Airtable-integratie stelt je in staat om:

• Verbinden met je Airtable-base via API-sleutel
• Synchroniseren van tabelgegevens als kennisbasis-invoer
• Vragen over je gegevens op een conversatiële manier via de AI
• Houd gegevens actueel met handmatige of geplande synchronisaties

---

Vereisten

Voordat je begint, zorg ervoor dat je hebt:

• Een actief AI SmartTalk-account
• Een Airtable-account met ten minste één base
• Een Airtable API-sleutel (Persoonlijke Toegangstoken)

---

Stapsgewijze Setup

Stap 1: Genereer je Airtable API-sleutel

1. Log in op je Airtable-account
2. Ga naar Accountinstellingen → Ontwikkelaarshub
3. Klik op Maak nieuwe token
4. Configureer je token:
   • Naam: AI SmartTalk Integratie
   • Scopes: Selecteer data.records:read en schema.bases:read
   • Toegang: Kies de specifieke bases die je wilt verbinden
5. Klik op Maak token en kopieer het onmiddellijk

Belangrijk: Bewaar je token veilig—Airtable toont het maar één keer!

Stap 2: Verbinden met AI SmartTalk

1. Log in op je AI SmartTalk-account
2. Navigeer naar Instellingen → Integraties
3. Zoek Airtable en klik op Verbinden
4. Plak je API-sleutel in het veld Persoonlijke Toegangstoken
5. Klik op Valideren

Stap 3: Selecteer tabellen om te synchroniseren

Na validatie zie je je beschikbare bases en tabellen:

1. Blader door bases: Klik om elke base uit te vouwen
2. Selecteer tabellen: Vink de tabellen aan die je wilt synchroniseren
3. Configureer velden: Kies welke kolommen je wilt opnemen
4. Klik op Start Synchronisatie

Stap 4: Verifieer de Import

1. Ga naar Kennis in AI SmartTalk
2. Je Airtable-records verschijnen als individuele kennisinvoeren
3. Test je AI door vragen te stellen over je gegevens

---

Wat wordt gesynchroniseerd

Gegevenstype	Hoe het wordt verwerkt
Tekstvelden	Gesynchroniseerd als doorzoekbare inhoud
Getalvelden	Opgenomen in de recordcontext
Selectie/Multi-selectie	Behandeld als categorieën/tags
Gekoppelde records	Referenties zijn inbegrepen
Bijlagen	URL's worden verwezen (bestanden worden niet gedownload)
Formules	Berekende waarden worden gesynchroniseerd

Voorbeeld: Productcatalogus

Als je een "Producten" tabel hebt:

Naam	Beschrijving	Prijs	Categorie
Widget Pro	Professionele widget...	$99	Gereedschap
Widget Lite	Instapmodel widget...	$49	Gereedschap

Je AI kan antwoorden:

• "Welke producten heb je?"
• "Vertel me over Widget Pro"
• "Wat is je goedkoopste gereedschap?"

---

Synchronisatieconfiguratie

Veldselectie

Voor elke tabel kun je configureren:

• Primaire veld: Hoofdidentificator voor elk record
• Inhoudsvelden: Velden die je wilt opnemen in de kennisbasis
• Uitsluiten velden: Interne velden die je wilt overslaan (ID's, tijdstempels, enz.)

Synchronisatiefrequentie

Optie	Beschrijving
Handmatig	Klik op "Synchroniseer Nu" wanneer nodig
Bij import	Synchroniseert wanneer je een import activeert
Gepland	In te stellen via SmartFlow (zie hieronder)

Plannen met SmartFlow

Om je Airtable-gegevens automatisch te synchroniseren:

1. Maak een nieuwe SmartFlow
2. Voeg een Gepland trigger toe (dagelijks, wekelijks, enz.)
3. Voeg de Synchroniseer actie toe → Selecteer Airtable
4. Sla de workflow op en activeer deze

---

Gebruikscases

Product-/Dienstencatalogus

Synchroniseer je productdatabase zodat klanten kunnen vragen:

• "Welke producten heb je onder de $100?"
• "Vergelijk Widget Pro en Widget Lite"
• "Heb je iets in de categorie Gereedschap?"

FAQ / Kennisbasis

Bewaar FAQ's in Airtable met Vraag/Antwoord kolommen:

• "Hoe reset ik mijn wachtwoord?"
• "Wat is jullie retourbeleid?"
• "Waar kan ik mijn factuur vinden?"

Teamdirectory

Synchroniseer gegevens van teamleden voor interne vragen:

• "Wie behandelt klantenservice?"
• "Wat is Sarah's rol?"
• "Lijst iedereen op in het Engineering team"

Evenement-/Schema-gegevens

Synchroniseer evenementtabellen voor planningsvragen:

• "Welke evenementen komen eraan?"
• "Wanneer is het volgende webinar?"
• "Wat is er gebeurd tijdens de meetup van vorige maand?"

---

Probleemoplossing

Verbinding Problemen

Probleem	Oplossing
"Ongeldige API-sleutel"	Genereer token opnieuw in Airtable Ontwikkelaarshub
"Base niet gevonden"	Zorg ervoor dat de token toegang heeft tot die base
"Toegang geweigerd"	Voeg data.records:read scope toe aan je token

Synchronisatieproblemen

Probleem	Oplossing
Ontbrekende records	Controleer of records niet gefilterd/verborgen zijn in weergave
Verouderde gegevens	Klik op Synchroniseer Nu om te verversen
Verkeerde velden synchroniseren	Controleer de veldselectie in de integratie-instellingen

AI Kan Gegevens Niet Vinden

Probleem	Oplossing
Geen resultaten voor vragen	Wacht tot de synchronisatie is voltooid en de AI te verwerken
Gedeeltelijke antwoorden	Zorg ervoor dat alle relevante velden zijn opgenomen in de synchronisatie

---

Beheren van de Verbinding

Actie	Hoe
Update API-sleutel	Instellingen → Integraties → Airtable → Update Token
Tabellen toevoegen	Bewerk verbinding → Selecteer aanvullende tabellen
Tabellen verwijderen	Vink tabellen uit die je niet meer wilt synchroniseren
Verbreken	Instellingen → Integraties → Airtable → Verbreken

---

Beste Praktijken

1. Structuur voor AI: Gebruik duidelijke, beschrijvende veldnamen
2. Deduplicate gegevens: Verwijder dubbele records voordat je synchroniseert
3. Gebruik primaire velden verstandig: Kies unieke, beschrijvende identificatoren
4. Regelmatige synchronisaties: Houd gegevens actueel, vooral voor veranderende inhoud
5. Beperk scope: Synchroniseer alleen tabellen die je AI nodig heeft om vragen te beantwoorden

---

Gerelateerde Documentatie

• Integraties Overzicht
• Beheer van de Kennisbasis
• CSV URL Import — Alternatief voor statische gegevens
• SmartFlow Geplande Triggers — Automatiseer synchronisaties