CSV URL Integrimi

Importoni dokumente drejtpërdrejt nga skedarë CSV të aksesueshëm publikisht përmes URL-së në bazën e njohurive të ndihmësit tuaj AI.

---

Fillimi i Shpejtë

Nisni në 3 hapa:

1. Navigoni: Administrata → Ndihmësit e Mi → [Emri i Ndihmësit] → Integrimet → CSV URL
2. Shtoni URL: Shkruani URL-në tuaj publike CSV dhe zgjidhni llojin e importit (FAQ/Produkt/Default)
3. Importoni: Klikoni "Shto URL" dhe monitoroni statusin

Këshillë: Testoni fillimisht me një skedar të vogël CSV për t'u njohur me procesin.

---

Çfarë Mund të Bëni

• ✅ Importoni nga URL-të publike HTTP/HTTPS CSV
• ✅ Importoni në grup disa URL njëherësh
• ✅ Auto-detect struktura e CSV (FAQ, Produkt, ose Gjenerik)
• ✅ Caktoni kategori dhe maponi kolona të personalizuara
• ✅ Ndjekni statusin dhe historinë e importit

---

Kushtet e Nevojshme

• Qasje admin në ndihmësin tuaj AI SmartTalk
• Skedarë CSV të aksesueshëm publikisht (nuk kërkohet autentifikim)
• Strukturë e duhur CSV me tituj kolone
• Kodimi UTF-8 i rekomanduar

---

Llojet e Importit

1. Importi i FAQ

Më i mirë për: Dokumentacionin e mbështetjes, bazat e njohurive

Kolonat e kërkuara:

• question
• answer

Shembull:

question,answer
"Si ta rivendos password-in tim?","Klikoni 'Harro Password-in' dhe ndiqni udhëzimet."
"Cilat janë oraret tuaja?","E hënë - E premte, 9 AM - 6 PM."

2. Importi i Produktit

Më i mirë për: Katalogët e e-commerce, inventarin

Kolona e kërkuar:

• idProduct (ose kolona e mapuar e personalizuar)

Opsionale:

• name (ose kolona e mapuar e personalizuar)

Shembull:

idProduct,name,description,price
"PROD001","Widget Premium","Widget me cilësi të lartë","99.99"
"PROD002","Widget Standard","Widget bazik","49.99"

3. Importi Default

Më i mirë për: Përmbajtje të përgjithshme, të dhëna të përziera

• Auto-detect struktura e FAQ ose Produktit
• Kthehet në importin e dokumenteve gjenerike
• Trajton formate të ndryshme CSV

---

Udhëzues Hapi-Pas-Hapi

Hapi 1: Qasja në Integrim

1. Hyni në AI SmartTalk
2. Shkoni te Administrata → Asistentët e Mi → [Asistenti Juaj]
3. Klikoni Integrimet → CSV URL

Hapi 2: Shtoni CSV URL

URL e Vetme:

1. Klikoni Shto CSV URL të Ri
2. Futni URL-në e skedarit CSV
3. Jepni emrin opsional
4. Zgjidhni llojin e importit (FAQ/Produkt/Default)
5. Zgjidhni kategorinë (opsionale)
6. Klikoni Shto URL

Importi në Masë:

1. Klikoni Importi në Masë të URL-ve
2. Futni URL-të (një për rresht)
3. Konfiguroni cilësimet e ndara
4. Klikoni Importo Të Gjitha URL-të

Hapi 3: Konfiguroni Hartimin e Kolonave (Vetëm Produkt)

Hartoni kolonat tuaja CSV në fushat e pritura:

• Kolona ID Produkti: Default idProduct → Hartoni në product_id, sku, etj.
• Kolona Emri: Default name → Hartoni në product_name, title, etj.

Hapi 4: Monitoroni Importin

Ndjekni statusin në Historinë e Importit:

• Në Pritje: Po pret për përpunim
• E Importuar: E përfunduar me sukses
• Gabim: Dështuar (shih detajet)

Hapi 5: Riprocesoni (Përditësoni Të Dhënat)

1. Gjeni URL-në në histori
2. Klikoni Riprocesoni
3. Konfirmoni veprimin
4. Monitoroni statusin e përditësuar

Hapi 6: Verifikoni Importin

1. Kontrolloni Bazën e Njohurive për dokumentet e reja
2. Testoni chatbot-in me pyetje rreth përmbajtjes së importuar

---

Kërkesat për CSV

URL të Validuara

✅ 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 nuk mbështetet)
❌ https://private.site.com/auth-data.csv (Autentifikimi i nevojshëm)
❌ file:///local/data.csv (Skedarët lokalë nuk mbështeten)

Kërkesat për Skedarët

• Qasja: Qasje publike përmes HTTP/HTTPS
• Krenat: Rreshti i parë duhet të përmbajë emrat e kolonave
• Shkëputësit: Nënvijë (,) ose pikëpresje (;)
• Kodimi: UTF-8 e rekomanduar
• Madhësia: Maksimumi 10MB për skedar

---

Zgjidhja e Problemeve

Gabimet e Zakonshme

Gabim	Zgjidhja
URL Jo e Qasshme	Verifikoni që URL-ja është publike dhe e vlefshme
Format i Pakuptueshëm	Kontrolloni shkëputësin dhe krenat
Kolona të Munguar	Sigurohuni që kolonat e kërkuara ekzistojnë (pyetje/ përgjigje ose idProduct)
Koha e Skedarit të Madh	Pjesëtoni skedarin ose reduktoni madhësinë nën 10MB

Hapat e Zgjidhjes

1. Testoni URL-në në shfletues
2. Validoni strukturën dhe kodimin e CSV
3. Rishikoni mesazhet e gabimeve në historinë e importit
4. Testoni me një skedar më të vogël
5. Kontaktoni mbështetje nëse problemi vazhdon

---

Praktikat më të Mira

Menaxhimi i URL-ve

• Përdorni URL të qëndrueshme dhe të përhershme
• Testoni URL-të çdo muaj për aksesueshmëri
• Përdorni CDN për performancë më të mirë
• Përfshini versionin në emrat e skedarëve: products-v2024.csv

Organizimi i të Dhënave

• Përdorni emra të qartë kategori
• Ruani formate CSV të qëndrueshme
• Pastroni të dhënat para importit (hiqni rreshtat e zbrazët)
• Mbani skedarët nën 10MB

Performanca

• Testoni fillimisht me mostra të vogla
• Procesoni importet e mëdha gjatë orëve të papikë
• Përdorni import masiv për URL të shumta të lidhura
• Monitoroni rrethin e suksesit të importit rregullisht

---

Siguria

• ✅ Transferime të koduara HTTPS
• ✅ Validimi i URL-ve
• ✅ Kontrolli i aksesit i bazuar në leje
• ✅ Procesimi i skedarëve të përkohshëm (pa ruajtje të përhershme)
• ✅ Pastrimi automatik i të dhënave të vjetra
• ✅ Regjistrat e auditit për të gjitha aktivitetet

---

Pas Importit

Pasi të importohen, të dhënat tuaja:

1. Bëhen të kërkueshme në bazën e njohurive
2. Fuqizojnë përgjigjet e chatbot-it menjëherë
3. Shfaqen të organizuara sipas kategorive
4. Mund të verifikohen në seksionin e Bazës së Njohurive

Verifikoni importin tuaj:

• Kontrolloni Bazën e Njohurive për dokumente të reja
• Testoni chatbot-in me pyetje mbi përmbajtjen e importuar
• Rishikoni kategoritë dhe organizimin

---

Mbështetje

Keni nevojë për ndihmë?

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

---

Përmbledhje

Tani mund të:

• ✅ Importoni të dhëna CSV nga URL publike
• ✅ Trajtoni FAQ, Produkt, dhe lloje të dhënash të përgjithshme
• ✅ Importoni në masë burime të shumta
• ✅ Hartoni kolona të personalizuara për produktet
• ✅ Monitoroni dhe menaxhoni importet
• ✅ Përditësoni të dhënat përmes ri-importimeve

Hapat e ardhshëm:

1. Testoni me një mostër CSV
2. Importoni të dhënat tuaja të prodhimit
3. Vendosni kategoritë
4. Planifikoni ri-importime të rregullta
5. Monitoroni performancën

Pyetje? Kontaktoni ekipin tonë të mbështetjes në çdo kohë.