CSV URL Integration

Importera dokument direkt från offentligt tillgängliga CSV-filer via URL till din AI-assistents kunskapsbas.

---

Snabbstart

Kom igång på 3 steg:

1. Navigera: Administration → Mina Assistenter → [Assistant Name] → Integrationer → CSV URL
2. Lägg till URL: Ange din offentliga CSV-URL och välj importtyp (FAQ/Produkt/Standard)
3. Importera: Klicka på "Lägg till URL" och övervaka status

Tips: Testa med en liten CSV-fil först för att bekanta dig med processen.

---

Vad Du Kan Göra

• ✅ Importera från offentliga HTTP/HTTPS CSV-URL:er
• ✅ Massimportera flera URL:er samtidigt
• ✅ Automatisk upptäckning av CSV-struktur (FAQ, Produkt eller Generisk)
• ✅ Tilldela kategorier och mappa anpassade kolumner
• ✅ Spåra importstatus och historik

---

Förutsättningar

• Administratörsbehörighet till din AI SmartTalk-assistent
• Offentligt tillgängliga CSV-filer (ingen autentisering krävs)
• Korrekt CSV-struktur med kolumnrubriker
• UTF-8-kodning rekommenderas

---

Importtyper

1. FAQ-import

Bäst för: Supportdokumentation, kunskapsbaser

Obligatoriska kolumner:

• question
• answer

Exempel:

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. Produktimport

Bäst för: E-handelskataloger, lager

Obligatorisk kolumn:

• idProduct (eller anpassad mappad kolumn)

Valfritt:

• name (eller anpassad mappad kolumn)

Exempel:

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

3. Standardimport

Bäst för: Allmänt innehåll, blandade data

• Automatisk upptäckning av FAQ- eller produktstruktur
• Återgår till generell dokumentimport
• Hanterar olika CSV-format

---

Steg-för-steg-guide

Steg 1: Åtkomst till Integration

1. Logga in på AI SmartTalk
2. Gå till Administration → Mina Assistenter → [Din Assistent]
3. Klicka på Integrationer → CSV URL

Steg 2: Lägg till CSV URL

Enskild URL:

1. Klicka på Lägg till ny CSV URL
2. Ange CSV-filens URL
3. Ange valfritt namn
4. Välj importtyp (FAQ/Produkt/Standard)
5. Välj kategori (valfritt)
6. Klicka på Lägg till URL

Massimport:

1. Klicka på Massimportera URL:er
2. Ange URL:er (en per rad)
3. Konfigurera delade inställningar
4. Klicka på Importera alla URL:er

Steg 3: Konfigurera Kolumnmappning (Endast Produkt)

Mappa dina CSV-kolumner till förväntade fält:

• ID Produktkolumn: Standard idProduct → Mappa till product_id, sku, etc.
• Namnkolumn: Standard name → Mappa till product_name, title, etc.

Steg 4: Övervaka Import

Följ status i Importhistorik:

• Väntande: Väntar på bearbetning
• Importerad: Framgångsrikt slutförd
• Fel: Misslyckades (visa detaljer)

Steg 5: Återimportera (Uppdatera Data)

1. Hitta URL i historiken
2. Klicka på Återimportera
3. Bekräfta åtgärd
4. Övervaka uppdaterad status

Steg 6: Verifiera Import

1. Kontrollera kunskapsbasen för nya dokument
2. Testa chatboten med frågor om importerad innehåll

---

CSV Krav

Giltiga URL:er

✅ 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 stöds inte)
❌ https://private.site.com/auth-data.csv (Autentisering krävs)
❌ file:///local/data.csv (Lokala filer stöds inte)

Filkrav

• Åtkomst: Offentligt tillgänglig via HTTP/HTTPS
• Rubriker: Första raden måste innehålla kolumnnamn
• Avgränsare: Komma (,) eller semikolon (;)
• Kodning: UTF-8 rekommenderas
• Storlek: Maximalt 10MB per fil

---

Felsökning

Vanliga Fel

Fel	Lösning
URL Inte Tillgänglig	Verifiera att URL:en är offentlig och giltig
Ogiltigt Format	Kontrollera avgränsare och rubriker
Saknade Kolumner	Säkerställ att nödvändiga kolumner finns (fråga/svar eller idProduct)
Stort Fil Timeout	Dela upp filen eller minska storleken under 10MB

Lösningssteg

1. Testa URL:en i webbläsaren
2. Validera CSV-struktur och kodning
3. Granska felmeddelanden i importhistoriken
4. Testa med en mindre provfil
5. Kontakta support om problemet kvarstår

---

Bästa Praxis

URL-hantering

• Använd stabila, permanenta URL:er
• Testa URL:er månadsvis för tillgänglighet
• Använd CDN för bättre prestanda
• Inkludera version i filnamn: products-v2024.csv

Dataorganisation

• Använd tydliga kategorinamn
• Upprätthåll konsekventa CSV-format
• Rensa data före import (ta bort tomma rader)
• Håll filer under 10MB

Prestanda

• Testa med små prover först
• Bearbeta stora importer under lågsäsong
• Använd bulkimport för flera relaterade URL:er
• Övervaka importens framgångsgrad regelbundet

---

Säkerhet

• ✅ HTTPS-krypterade överföringar
• ✅ URL-validering
• ✅ Behörighetsbaserad åtkomstkontroll
• ✅ Tillfällig filbearbetning (ingen permanent lagring)
• ✅ Automatisk rensning av gammal data
• ✅ Granskningsloggar för alla aktiviteter

---

Efter Import

När din data har importerats:

1. Blir sökbar i kunskapsbasen
2. Driver chatbot-svar omedelbart
3. Framstår organiserad efter kategorier
4. Kan verifieras i avsnittet för kunskapsbas

Verifiera din import:

• Kontrollera kunskapsbasen för nya dokument
• Testa chatboten med frågor om importerad innehåll
• Granska kategorier och organisation

---

Support

Behöver du hjälp?

• 📧 E-post: contact@aismarttalk.tech
• 📚 Dokumentation: https://docs.aismarttalk.tech/

---

Sammanfattning

Du kan nu:

• ✅ Importera CSV-data från offentliga URL:er
• ✅ Hantera FAQ, produkt- och generiska datatyper
• ✅ Bulkimportera flera källor
• ✅ Karta anpassade kolumner för produkter
• ✅ Övervaka och hantera importer
• ✅ Uppdatera data genom re-importer

Nästa steg:

1. Testa med ett prov-CSV
2. Importera dina produktionsdata
3. Ställ in kategorier
4. Schemalägg regelbundna re-importer
5. Övervaka prestanda

Frågor? Kontakta vårt supportteam när som helst.