Zum Hauptinhalt springen

CSV URL Integration

Importieren Sie Dokumente direkt aus öffentlich zugänglichen CSV-Dateien über URL in die Wissensdatenbank Ihres KI-Assistenten.

Schnellstart​

Beginnen Sie in 3 Schritten:

  1. Navigieren: Verwaltung → Meine Assistenten → [Assistentenname] → Integrationen → CSV URL
  2. URL hinzufügen: Geben Sie Ihre öffentliche CSV-URL ein und wählen Sie den Importtyp (FAQ/Produkt/Standard)
  3. Importieren: Klicken Sie auf "URL hinzufügen" und überwachen Sie den Status

Tipp: Testen Sie zuerst mit einer kleinen CSV-Datei, um sich mit dem Prozess vertraut zu machen.

CSV URL Integration Overview

Was Sie tun können​

  • ✅ Importieren von öffentlichen HTTP/HTTPS CSV-URLs
  • ✅ Mehrere URLs gleichzeitig im Bulk importieren
  • ✅ CSV-Struktur automatisch erkennen (FAQ, Produkt oder Allgemein)
  • ✅ Kategorien zuweisen und benutzerdefinierte Spalten zuordnen
  • ✅ Importstatus und -verlauf verfolgen

Voraussetzungen​

  • Administratorzugang zu Ihrem AI SmartTalk-Assistenten
  • Öffentlich zugängliche CSV-Dateien (keine Authentifizierung erforderlich)
  • Korrekte CSV-Struktur mit Spaltenüberschriften
  • UTF-8-Codierung empfohlen

Importtypen​

1. FAQ-Import​

Am besten geeignet für: Support-Dokumentation, Wissensdatenbanken

Erforderliche Spalten:

  • question
  • answer

Beispiel:

question,answer
"Wie setze ich mein Passwort zurück?","Klicken Sie auf 'Passwort vergessen' und folgen Sie den Anweisungen."
"Was sind Ihre Öffnungszeiten?","Montag-Freitag, 9 Uhr - 18 Uhr."

2. Produkt-Import​

Am besten geeignet für: E-Commerce-Kataloge, Inventar

Erforderliche Spalte:

  • idProduct (oder benutzerdefinierte zugeordnete Spalte)

Optional:

  • name (oder benutzerdefinierte zugeordnete Spalte)

Beispiel:

idProduct,name,description,price
"PROD001","Premium Widget","Hochwertiges Widget","99.99"
"PROD002","Standard Widget","Basis-Widget","49.99"

3. Standard-Import​

Am besten geeignet für: Allgemeine Inhalte, gemischte Daten

  • Erkennt automatisch FAQ- oder Produktstruktur
  • Fällt auf generischen Dokumentenimport zurück
  • Verarbeitet verschiedene CSV-Formate

Schritt-für-Schritt-Anleitung​

Schritt 1: Integration Zugreifen​

  1. Melden Sie sich bei AI SmartTalk an
  2. Gehen Sie zu Administration → Meine Assistenten → [Ihr Assistent]
  3. Klicken Sie auf Integrationen → CSV-URL

Schritt 2: CSV-URL Hinzufügen​

Einzelne URL:

  1. Klicken Sie auf Neue CSV-URL hinzufügen
  2. Geben Sie die CSV-Datei-URL ein
  3. Geben Sie einen optionalen Namen an
  4. Wählen Sie den Importtyp (FAQ/Produkt/Standard)
  5. Wählen Sie eine Kategorie (optional)
  6. Klicken Sie auf URL hinzufügen

Einzelnes CSV-URL-Importformular

Massenimport:

  1. Klicken Sie auf Massenimport-URLs
  2. Geben Sie die URLs ein (eine pro Zeile)
  3. Konfigurieren Sie die gemeinsamen Einstellungen
  4. Klicken Sie auf Alle URLs importieren

Massenimport CSV-URL

Schritt 3: Spaltenzuordnung Konfigurieren (Nur Produkt)​

Ordnen Sie Ihre CSV-Spalten den erwarteten Feldern zu:

  • ID Produktspalte: Standard idProduct → Zuordnen zu product_id, sku usw.
  • Namensspalte: Standard name → Zuordnen zu product_name, title usw.

Schritt 4: Import überwachen​

Status im Importverlauf verfolgen:

  • Ausstehend: Wartet auf Verarbeitung
  • Importiert: Erfolgreich abgeschlossen
  • Fehler: Fehlgeschlagen (Details anzeigen)

Importstatus-Dashboard

Schritt 5: Erneut importieren (Daten aktualisieren)​

  1. URL im Verlauf finden
  2. Auf Erneut importieren klicken
  3. Aktion bestätigen
  4. Aktualisierten Status überwachen

Schritt 6: Import überprüfen​

  1. Wissensdatenbank auf neue Dokumente überprüfen
  2. Chatbot mit Fragen zum importierten Inhalt testen

Wissensdatenbank nach dem Import

CSV-Anforderungen​

Gültige 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 nicht unterstützt)
❌ https://private.site.com/auth-data.csv (Authentifizierung erforderlich)
❌ file:///local/data.csv (Lokale Dateien nicht unterstützt)

Datei-Anforderungen​

  • Zugriff: Öffentlich zugänglich über HTTP/HTTPS
  • Kopfzeilen: Die erste Zeile muss die Spaltennamen enthalten
  • Trennzeichen: Komma (,) oder Semikolon (;)
  • Kodierung: UTF-8 empfohlen
  • Größe: Maximal 10MB pro Datei

Fehlerbehebung​

Häufige Fehler​

FehlerLösung
URL Nicht ZugänglichÜberprüfen Sie, ob die URL öffentlich und gültig ist
Ungültiges FormatÜberprüfen Sie den Trennzeichen und die Kopfzeilen
Fehlende SpaltenStellen Sie sicher, dass die erforderlichen Spalten vorhanden sind (Frage/Antwort oder idProduct)
Timeout bei großer DateiTeilen Sie die Datei oder reduzieren Sie die Größe auf unter 10MB

Schritte zur Behebung​

  1. Testen Sie die URL im Browser
  2. Validieren Sie die CSV-Struktur und -Kodierung
  3. Überprüfen Sie die Fehlermeldungen im Importverlauf
  4. Testen Sie mit einer kleineren Beispieldatei
  5. Kontaktieren Sie den Support, wenn das Problem weiterhin besteht

Best Practices​

URL-Management​

  • Verwenden Sie stabile, permanente URLs
  • Testen Sie URLs monatlich auf Zugänglichkeit
  • Verwenden Sie CDN für bessere Leistung
  • Fügen Sie die Version in Dateinamen ein: products-v2024.csv

Datenorganisation​

  • Verwenden Sie klare Kategorienamen
  • Halten Sie konsistente CSV-Formate ein
  • Bereinigen Sie Daten vor dem Import (leere Zeilen entfernen)
  • Halten Sie Dateien unter 10MB

Leistung​

  • Testen Sie zuerst mit kleinen Proben
  • Verarbeiten Sie große Importe während der Nebenzeiten
  • Verwenden Sie den Bulk-Import für mehrere verwandte URLs
  • Überwachen Sie regelmäßig die Erfolgsquote beim Import

Sicherheit​

  • ✅ HTTPS-verschlüsselte Übertragungen
  • ✅ URL-Validierung
  • ✅ Berechtigungsbasierte Zugriffskontrolle
  • ✅ Temporäre Dateiverarbeitung (keine permanente Speicherung)
  • ✅ Automatische Bereinigung alter Daten
  • ✅ Protokolle für alle Aktivitäten

Nach dem Import​

Sobald Ihre Daten importiert sind:

  1. Werden sie in der Wissensdatenbank durchsuchbar
  2. Unterstützen sie sofort die Antworten des Chatbots
  3. Erscheinen sie organisiert nach Kategorien
  4. Können sie im Abschnitt Wissensdatenbank überprüft werden

Überprüfen Sie Ihren Import:

  • Überprüfen Sie die Wissensdatenbank auf neue Dokumente
  • Testen Sie den Chatbot mit Fragen zum importierten Inhalt
  • Überprüfen Sie Kategorien und Organisation

Unterstützung​

Brauchen Sie Hilfe?

Zusammenfassung​

Sie können jetzt:

  • ✅ CSV-Daten von öffentlichen URLs importieren
  • ✅ FAQ-, Produkt- und allgemeine Datentypen verarbeiten
  • ✅ Mehrere Quellen im Bulk importieren
  • ✅ Benutzerdefinierte Spalten für Produkte zuordnen
  • ✅ Importe überwachen und verwalten
  • ✅ Daten durch erneuten Import aktualisieren

Nächste Schritte:

  1. Testen Sie mit einer Beispiel-CSV
  2. Importieren Sie Ihre Produktionsdaten
  3. Richten Sie Kategorien ein
  4. Planen Sie regelmäßige erneute Importe
  5. Überwachen Sie die Leistung

Fragen? Kontaktieren Sie unser Support-Team jederzeit.