CSV URL Integratie

Importeer documenten rechtstreeks vanuit openbaar toegankelijke CSV-bestanden via URL in de kennisbank van uw AI-assistent.

---

Snelle Start

Begin in 3 stappen:

1. Navigeer: Beheer → Mijn Assistenten → [Assistent Naam] → Integraties → CSV URL
2. Voeg URL toe: Voer uw openbare CSV-URL in en selecteer het importtype (FAQ/Product/Standaard)
3. Importeer: Klik op "Voeg URL toe" en volg de status

Tip: Test eerst met een klein CSV-bestand om vertrouwd te raken met het proces.

---

Wat U Kunt Doen

• ✅ Importeren van openbare HTTP/HTTPS CSV-URL's
• ✅ Bulkimport van meerdere URL's tegelijk
• ✅ Automatisch detecteren van CSV-structuur (FAQ, Product of Generiek)
• ✅ Categorieën toewijzen en aangepaste kolommen in kaart brengen
• ✅ Importstatus en geschiedenis volgen

---

Voorwaarden

• Beheertoegang tot uw AI SmartTalk-assistent
• Publiek toegankelijke CSV-bestanden (geen authenticatie vereist)
• Juiste CSV-structuur met kolomkoppen
• UTF-8-codering aanbevolen

Import Types

1. FAQ Import

Best for: Ondersteuningsdocumentatie, kennisbanken

Vereiste kolommen:

• question
• answer

Voorbeeld:

question,answer
"Hoe reset ik mijn wachtwoord?","Klik op 'Wachtwoord Vergeten' en volg de instructies."
"Wat zijn uw openingstijden?","Maandag-Vrijdag, 9 AM - 6 PM."

2. Product Import

Best for: E-commerce catalogi, voorraad

Vereiste kolom:

• idProduct (of aangepaste gemapte kolom)

Optioneel:

• name (of aangepaste gemapte kolom)

Voorbeeld:

idProduct,name,description,price
"PROD001","Premium Widget","Hoogwaardige widget","99.99"
"PROD002","Standaard Widget","Basis widget","49.99"

3. Default Import

Best for: Algemene inhoud, gemengde gegevens

• Auto-detecteert FAQ of Productstructuur
• Valt terug op generieke documentimport
• Behandelt verschillende CSV-indelingen

---

Stapsgewijze Handleiding

Stap 1: Toegang tot Integratie

1. Log in op AI SmartTalk
2. Ga naar Administratie → Mijn Assistenten → [Jouw Assistent]
3. Klik op Integraties → CSV URL

Stap 2: Voeg CSV URL toe

Enkele URL:

1. Klik op Nieuwe CSV URL toevoegen
2. Voer de CSV-bestand URL in
3. Geef een optionele naam op
4. Selecteer het importtype (FAQ/Product/Standaard)
5. Kies een categorie (optioneel)
6. Klik op URL toevoegen

Bulk Import:

1. Klik op Bulk Import URLs
2. Voer URLs in (één per regel)
3. Configureer gedeelde instellingen
4. Klik op Importeer Alle URLs

Stap 3: Configureer Kolom Mapping (Alleen Product)

Koppel je CSV-kolommen aan verwachte velden:

• ID Product Kolom: Standaard idProduct → Koppel aan product_id, sku, enz.
• Naam Kolom: Standaard name → Koppel aan product_name, title, enz.

Stap 4: Monitor Import

Volg de status in de Importgeschiedenis:

• In afwachting: Wacht op verwerking
• Geïmporteerd: Succesvol voltooid
• Fout: Mislukt (bekijk details)

Stap 5: Herimporteren (Gegevens Bijwerken)

1. Zoek URL in de geschiedenis
2. Klik op Herimporteren
3. Bevestig actie
4. Volg de bijgewerkte status

Stap 6: Verifieer Import

1. Controleer de Kennisbank op nieuwe documenten
2. Test de chatbot met vragen over de geïmporteerde inhoud

CSV Vereisten

Geldige URL's

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP niet ondersteund)
❌ https://private.site.com/auth-data.csv (Authenticatie vereist)
❌ file:///local/data.csv (Lokale bestanden niet ondersteund)

Bestandsvereisten

• Toegang: Publiek toegankelijk via HTTP/HTTPS
• Headers: De eerste rij moet kolomnamen bevatten
• Scheidingstekens: Komma (,) of puntkomma (;)
• Codering: UTF-8 aanbevolen
• Grootte: Maximaal 10MB per bestand

---

Probleemoplossing

Veelvoorkomende Fouten

Fout	Oplossing
URL Niet Toegankelijk	Controleer of de URL openbaar en geldig is
Ongeldig Formaat	Controleer scheidingsteken en kopteksten
Ontbrekende Kolommen	Zorg ervoor dat vereiste kolommen bestaan (vraag/antwoord of idProduct)
Grote Bestands Timeout	Splits bestand of verklein de grootte onder 10MB

Oplossingsstappen

1. Test de URL in de browser
2. Valideer de CSV-structuur en codering
3. Bekijk foutmeldingen in de importgeschiedenis
4. Test met een kleiner voorbeeldbestand
5. Neem contact op met de ondersteuning als het probleem aanhoudt

Best Practices

URL Management

• Gebruik stabiele, permanente URL's
• Test URL's maandelijks op toegankelijkheid
• Gebruik CDN voor betere prestaties
• Voeg versie toe in bestandsnamen: products-v2024.csv

Data Organization

• Gebruik duidelijke categorienamen
• Handhaaf consistente CSV-formaten
• Maak gegevens schoon voor import (verwijder lege rijen)
• Houd bestanden onder 10MB

Performance

• Test eerst met kleine monsters
• Verwerk grote imports tijdens daluren
• Gebruik bulkimport voor meerdere gerelateerde URL's
• Monitor regelmatig het succespercentage van imports

---

Security

• ✅ HTTPS versleutelde overdrachten
• ✅ URL-validatie
• ✅ Toegangscontrole op basis van permissies
• ✅ Tijdelijke bestandsverwerking (geen permanente opslag)
• ✅ Automatische opruiming van oude gegevens
• ✅ Auditlogs voor alle activiteiten

---

Na Import

Zodra je gegevens zijn geïmporteerd:

1. Worden ze doorzoekbaar in de kennisbank
2. Voeden ze onmiddellijk de chatbot-antwoorden
3. Verschijnen ze georganiseerd per categorie
4. Kunnen ze worden geverifieerd in de sectie Kennisbank

Verifieer je import:

• Controleer de Kennisbank op nieuwe documenten
• Test de chatbot met vragen over geïmporteerde inhoud
• Bekijk de categorieën en organisatie

---

Ondersteuning

Hulp nodig?

• 📧 E-mail: contact@aismarttalk.tech
• 📚 Documentatie: https://docs.aismarttalk.tech/

---

Samenvatting

Je kunt nu:

• ✅ CSV-gegevens importeren van openbare URL's
• ✅ FAQ-, Product- en generieke gegevenstypen verwerken
• ✅ Meerdere bronnen in bulk importeren
• ✅ Aangepaste kolommen voor producten in kaart brengen
• ✅ Importen monitoren en beheren
• ✅ Gegevens bijwerken via herimporten

Volgende stappen:

1. Test met een voorbeeld-CSV
2. Importeer je productiedata
3. Stel categorieën in
4. Plan regelmatige herimporten
5. Monitor de prestaties

Vragen? Neem op elk moment contact op met ons ondersteuningsteam.