CSV URL Integratioun

Importéiert Dokumenter direkt vun ëffentlech zougängleche CSV-Dateien iwwer URL an d'Wëssenbasis vun Ärem AI Assistant.

---

Schnellstart

Starten an 3 Schrëtt:

1. Navigéieren: Administratioun → Meng Assistente → [Assistant Name] → Integratiounen → CSV URL
2. URL derbäisetzen: Gitt Äre public CSV URL an wielt Importtyp (FAQ/Produkt/Standard)
3. Importéieren: Klickt op "Add URL" an iwwerwaacht de Status

Tip: Testt éischt mat enger klenger CSV-Datei fir Iech mat dem Prozess vertraut ze maachen.

---

Wat Dir Kënnt Maachen

• ✅ Importéieren vun ëffentleche HTTP/HTTPS CSV URLs
• ✅ Bulk-Import vu ville URLs zur gläicher Zäit
• ✅ Auto-detect CSV Struktur (FAQ, Produkt, oder Generesch)
• ✅ Kategorien zouweisen an personaliséiert Spalten mappen
• ✅ Importstatus an Geschicht verfollegen

---

Virbedingunge

• Administrateur Zougang zu Ärem AI SmartTalk Assistant
• Ëffentlech zougänglech CSV-Dateien (keen Authentifikatioun erfuerderlech)
• Richteg CSV Struktur mat Spaltenheader
• UTF-8 Kodéierung empfohl

---

Importtypë

1. FAQ Import

Am beschten fir: Supportdokumentatioun, Wëssenbasen

Fuerderlech Spalten:

• question
• answer

Beispill:

question,answer
"How do I reset my password?","Click 'Forgot Password' and follow instructions."
"What are your hours?","Monday-Friday, 9 AM - 6 PM."

2. Produkt Import

Am beschten fir: E-Commerce Kataloge, Inventar

Fuerderlech Spalte:

• idProduct (oder personaliséiert gemappte Spalte)

Optional:

• name (oder personaliséiert gemappte Spalte)

Beispill:

idProduct,name,description,price
"PROD001","Premium Widget","High-quality widget","99.99"
"PROD002","Standard Widget","Basic widget","49.99"

3. Standard Import

Am beschten fir: Allgemeng Inhalter, gemëschte Daten

• Auto-detects FAQ oder Produktstruktur
• Fält zréck op generesch Dokumentimport
• Handhabt verschidde CSV Formater

---

Schrëtt-fir-Schrëtt Guide

Schrëtt 1: Zougang Integratioun

1. Loggt Iech an AI SmartTalk an
2. Geet op Administratioun → Meng Assistente → [Ären Assistant]
3. Klickt op Integratiounen → CSV URL

Schrëtt 2: CSV URL derbäisetzen

Eenzel URL:

1. Klickt op Nei CSV URL derbäisetzen
2. Gitt d'CSV Datei URL an
3. Bitt optionalen Numm un
4. Wielt Importtyp (FAQ/Produkt/Standard)
5. Wielt Kategorie (optional)
6. Klickt op URL derbäisetzen

Bulk Import:

1. Klickt op Bulk Import URLs
2. Gitt URLs an (eng pro Zeil)
3. Konfiguréiert gemeinsam Astellungen
4. Klickt op All URLs importéieren

Schrëtt 3: Spalte Mapping konfiguréieren (Produkt nëmmen)

Mappt Är CSV Spalten op déi erwaart Felder:

• ID Produkt Spalte: Standard idProduct → Mappt op product_id, sku, etc.
• Numm Spalte: Standard name → Mappt op product_name, title, etc.

Schrëtt 4: Import iwwerwaachen

Verfollegt de Status am Importhistorie:

• Wäiting: Waart op Veraarbechtung
• Importéiert: Erfollegräich ofgeschloss
• Feeler: Gefailegt (gesin d'Detailer)

Schrëtt 5: Re-importéieren (Daten aktualiséieren)

1. Fannt d'URL an der Geschicht
2. Klickt op Re-importéieren
3. Bestätegt d'Aktioun
4. Iwwerwaacht de aktualiséierten Status

Schrëtt 6: Import veriféieren

1. Kontrolléiert d'Wëssen Basis fir nei Dokumenter
2. Testt de Chatbot mat Froen iwwer importéiert Inhalter

---

CSV Ufuerderungen

Gültig URLs

✅ 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 net ënnerstëtzt)
❌ https://private.site.com/auth-data.csv (Authentifikatioun erfuerderlech)
❌ file:///local/data.csv (Lokal Dateien net ënnerstëtzt)

Datei Ufuerderungen

• Zougang: Public zougänglech iwwer HTTP/HTTPS
• Header: Déi éischt Zeil muss Spaltennimm enthalen
• Delimiters: Komma (,) oder Semikolon (;)
• Encoding: UTF-8 empfohl
• Gréisst: Maximum 10MB pro Datei

---

Problemer léisen

Gemeinsam Feeler

Feeler	Léisung
URL Net Zougänglech	Verifizéiert datt d'URL public an gülteg ass
Ungëlteg Format	Kontrolléiert de Delimiter an d'Header
Fehlend Spalten	Stellt sécher datt déi erfuerderlech Spalten existéieren (Fro/Äntwert oder idProduct)
Grouss Datei Timeout	Deelt d'Datei oder reduzéiert d'Gréisst ënner 10MB

Resolutiouns Schrëtt

1. Testt d'URL am Browser
2. Validéiert d'CSV Struktur an Encoding
3. Iwwerpréift d'Feelerbotschaften an der Importhistorie
4. Testt mat enger méi klenger Beispieldatei
5. Kontaktéiert den Support wann d'Probleem weiderbesteet

---

Bescht Praktiken

URL Management

• Benotzt stabil, permanent URLs
• Testt URLs monatlech fir Zougänglechkeet
• Benotzt CDN fir besser Leeschtung
• Füügt Versioun an Dateinimmerecher an: products-v2024.csv

Datenorganisatioun

• Benotzt kloer Kategorie Nimm
• Hält konsequent CSV Formater
• Botzt Daten virum Import (läscht eidel Reien)
• Hält Dateien ënner 10MB

Leeschtung

• Testt mat klengen Proben éischt
• Verarbeitet grouss Importer während Off-Peak Stonnen
• Benotzt Bulk Import fir vill verbonnen URLs
• Iwwerwaacht Import Erfolgsquote regelméisseg

---

Sécherheet

• ✅ HTTPS verschlësselt Transfers
• ✅ URL Validatioun
• ✅ Berechtigung-baséiert Zougangskontroll
• ✅ Temporär Datei Veraarbechtung (keen permanenten Speicher)
• ✅ Automatesch Cleanup vun alten Daten
• ✅ Audit Logs fir all Aktivitéiten

---

No Import

Eemol importéiert, Är Daten:

1. Warden sichbar an der Wissensbasis
2. Aktivéieren Chatbot Äntwerten direkt
3. Erscheinen organiséiert no Kategorien
4. Kënnen an der Wissensbasis Sektioun verifiziert ginn

Verifizéiert Ären Import:

• Kuckt an der Wissensbasis no neie Dokumenter
• Testt den Chatbot mat Froen iwwer importéiert Inhalter
• Iwwerpréift Kategorien an Organisatioun

---

Ënnerstëtzung

Braucht Hëllef?

• 📧 E-Mail: contact@aismarttalk.tech
• 📚 Dokumenter: https://docs.aismarttalk.tech/

---

Zesummesummung

Dir kënnt elo:

• ✅ CSV Daten vun ëffentleche URLs importéieren
• ✅ FAQ, Produkt, a generesch Datentypen behandelen
• ✅ Bulk Import vu ville Quell maachen
• ✅ Mapper personaliséiert Spalten fir Produkter
• ✅ Iwwerwaachen a verwalten Importer
• ✅ Aktualiséieren Daten duerch Re-importer

Nächste Schrëtt:

1. Testt mat enger Probe CSV
2. Importéiert Är Produktiounsdaten
3. Setzt Kategorien op
4. Plangt regelméisseg Re-importer
5. Iwwerwaacht Leeschtung

Froen? Kontaktéiert eis Ënnerstëtzungs-Team zu all Moment.