CSV URL Integracija

Uvezite dokumente izravno iz javno dostupnih CSV datoteka putem URL-a u bazu znanja vašeg AI asistenta.

---

Brzi Početak

Započnite u 3 koraka:

1. Navigirajte: Administracija → Moji Asistenti → [Ime Asistenta] → Integracije → CSV URL
2. Dodajte URL: Unesite svoj javni CSV URL i odaberite tip uvoza (FAQ/Proizvod/Default)
3. Uvezite: Kliknite "Dodaj URL" i pratite status

Savjet: Prvo testirajte s malom CSV datotekom kako biste se upoznali s procesom.

---

Što Možete Učiniti

• ✅ Uvezite s javnih HTTP/HTTPS CSV URL-ova
• ✅ Uvezite više URL-ova odjednom
• ✅ Automatski otkrijte strukturu CSV-a (FAQ, Proizvod ili Općenito)
• ✅ Dodijelite kategorije i mapirajte prilagođene stupce
• ✅ Pratite status i povijest uvoza

---

Preduvjeti

• Administratorski pristup vašem AI SmartTalk asistentu
• Javne CSV datoteke (bez autentifikacije)
• Ispravna CSV struktura sa zaglavljem stupaca
• Preporučena UTF-8 kodiranje

---

Tipovi Uvoza

1. FAQ Uvoz

Najbolje za: Dokumentaciju podrške, baze znanja

Obavezni stupci:

• question
• answer

Primjer:

question,answer
"Kako mogu resetirati svoju lozinku?","Kliknite 'Zaboravili ste lozinku' i slijedite upute."
"Koje su vaše radne sate?","Ponedjeljak-Petak, 9 AM - 6 PM."

2. Uvoz Proizvoda

Najbolje za: E-trgovinske kataloge, inventar

Obavezni stupac:

• idProduct (ili prilagođeni mapirani stupac)

Opcionalno:

• name (ili prilagođeni mapirani stupac)

Primjer:

idProduct,name,description,price
"PROD001","Premium Widget","Visokokvalitetni widget","99.99"
"PROD002","Standard Widget","Osnovni widget","49.99"

3. Default Uvoz

Najbolje za: Opći sadržaj, mješoviti podaci

• Automatski otkriva FAQ ili strukturu Proizvoda
• Vraća se na opći uvoz dokumenata
• Rukuje raznim CSV formatima

---

Vodič korak po korak

Korak 1: Pristup Integraciji

1. Prijavite se u AI SmartTalk
2. Idite na Administracija → Moji asistenti → [Vaš asistent]
3. Kliknite Integracije → CSV URL

Korak 2: Dodajte CSV URL

Jedan URL:

1. Kliknite Dodaj novi CSV URL
2. Unesite URL CSV datoteke
3. Pružite opcionalno ime
4. Odaberite vrstu uvoza (FAQ/Proizvod/Predefinirano)
5. Odaberite kategoriju (opcionalno)
6. Kliknite Dodaj URL

Masovni uvoz:

1. Kliknite Masovni uvoz URL-ova
2. Unesite URL-ove (jedan po liniji)
3. Konfigurirajte zajedničke postavke
4. Kliknite Uvezi sve URL-ove

Korak 3: Konfigurirajte Mapiranje Kolona (Samo Proizvod)

Mapirajte svoje CSV kolone na očekivana polja:

• ID Kolona Proizvoda: Predefinirano idProduct → Mapirajte na product_id, sku, itd.
• Kolona Ime: Predefinirano name → Mapirajte na product_name, title, itd.

Korak 4: Pratite Uvoz

Pratite status u Povijesti Uvoza:

• Na čekanju: Čeka na obradu
• Uvezeno: Uspješno završeno
• Greška: Neuspješno (pogledajte detalje)

Korak 5: Ponovni uvoz (Ažuriranje podataka)

1. Pronađite URL u povijesti
2. Kliknite Ponovno uvezi
3. Potvrdite radnju
4. Pratite ažurirani status

Korak 6: Verificirajte Uvoz

1. Provjerite Bazu znanja za nove dokumente
2. Testirajte chatbot s pitanjima o uvezenom sadržaju

---

CSV Zahtjevi

Valjani URL-ovi

✅ 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 nije podržan)
❌ https://private.site.com/auth-data.csv (Potrebna autentifikacija)
❌ file:///local/data.csv (Lokalne datoteke nisu podržane)

Zahtjevi za datoteke

• Pristup: Javno dostupno putem HTTP/HTTPS
• Zaglavlja: Prvi redak mora sadržavati nazive kolona
• Odvojivači: Zarez (,) ili točka s zarezom (;)
• Kodiranje: Preporučuje se UTF-8
• Veličina: Maksimalno 10MB po datoteci

---

Rješavanje problema

Uobičajene greške

Greška	Rješenje
URL nije dostupan	Provjerite je li URL javan i valjan
Nevažeći format	Provjerite odvojivač i zaglavlja
Nedostajuće kolone	Osigurajte da potrebne kolone postoje (pitanje/odgovor ili idProduct)
Timeout velike datoteke	Podijelite datoteku ili smanjite veličinu ispod 10MB

Koraci za rješavanje

1. Testirajte URL u pregledniku
2. Potvrdite strukturu i kodiranje CSV-a
3. Pregledajte poruke o greškama u povijesti uvoza
4. Testirajte s manjom uzorkom datoteke
5. Kontaktirajte podršku ako problem i dalje postoji

---

Najbolje Prakse

Upravljanje URL-ovima

• Koristite stabilne, trajne URL-ove
• Testirajte URL-ove mjesečno za dostupnost
• Koristite CDN za bolju izvedbu
• Uključite verziju u nazive datoteka: products-v2024.csv

Organizacija Podataka

• Koristite jasne nazive kategorija
• Održavajte dosljedne CSV formate
• Očistite podatke prije uvoza (uklonite prazne redove)
• Držite datoteke ispod 10MB

Izvedba

• Prvo testirajte s malim uzorcima
• Procesuirajte velike uvoze tijekom izvanpikovnih sati
• Koristite masovni uvoz za više povezanih URL-ova
• Redovito pratite stopu uspješnosti uvoza

---

Sigurnost

• ✅ HTTPS enkriptirani prijenosi
• ✅ Validacija URL-a
• ✅ Kontrola pristupa temeljem dozvola
• ✅ Privremeno procesiranje datoteka (bez trajnog pohranjivanja)
• ✅ Automatsko čišćenje starih podataka
• ✅ Revizijski dnevnici za sve aktivnosti

---

Nakon Uvoza

Nakon uvoza, vaši podaci:

1. Postaju pretraživi u bazi znanja
2. Odmah pokreću odgovore chatbota
3. Pojavljuju se organizirani po kategorijama
4. Mogu se provjeriti u odjeljku Baze Znanja

Provjerite svoj uvoz:

• Provjerite Bazu Znanja za nove dokumente
• Testirajte chatbota s pitanjima o uvezenom sadržaju
• Pregledajte kategorije i organizaciju

---

Podrška

Trebate pomoć?

• 📧 Email: contact@aismarttalk.tech
• 📚 Dokumentacija: https://docs.aismarttalk.tech/

---

Sažetak

Sada možete:

• ✅ Uvesti CSV podatke s javnih URL-ova
• ✅ Rukovati FAQ, proizvodnim i generičkim tipovima podataka
• ✅ Masovno uvesti više izvora
• ✅ Mapirati prilagođene stupce za proizvode
• ✅ Pratiti i upravljati uvozima
• ✅ Ažurirati podatke putem ponovnih uvoza

Sljedeći koraci:

1. Testirajte s uzorkom CSV-a
2. Uvezite svoje proizvodne podatke
3. Postavite kategorije
4. Planirajte redovite ponovne uvoze
5. Pratite izvedbu

Imate pitanja? Kontaktirajte naš tim za podršku u bilo kojem trenutku.