CSV URL Integrazjoni

Importa dokumenti direttament minn fajls CSV aċċessibbli pubblikament permezz ta' URL fil-bażi ta' għarfien tal-assistent AI tiegħek.

---

Għat-tibdil Malajr

Ibda f'3 passi:

1. Naviga: Amministrazzjoni → Il-Assistenti Tiegħi → [Isem l-Assistent] → Integrazjonijiet → CSV URL
2. Żid URL: Daħħal l-URL CSV pubbliku tiegħek u agħżel it-tip ta' importazzjoni (FAQ/Prodott/Default)
3. Importa: Ikklikkja "Żid URL" u segwi l-istatus

Parir: Ittestja ma' fajl CSV żgħir l-ewwel biex tiddipendi ruħek mal-proċess.

---

X'tista' Tagħmel

• ✅ Importa minn URLs CSV HTTP/HTTPS pubbliċi
• ✅ Importazzjoni b'mod massivo ta' diversi URLs fl-istess ħin
• ✅ Auto-detect CSV struttura (FAQ, Prodott, jew Ġeneriku)
• ✅ Assegna kategoriji u mappa kolonni personalizzati
• ✅ Segwi l-istatus u l-istorja tal-importazzjoni

---

Pre-rekwiżiti

• Aċċess amministrattiv għall-assistent AI SmartTalk tiegħek
• Fajls CSV aċċessibbli pubblikament (ebda awtentiċazzjoni meħtieġa)
• Struttura CSV xierqa bil-kolonni ta' titoli
• UTF-8 encoding rakkomandat

---

Tipi ta' Importazzjoni

1. Importazzjoni FAQ

Aħjar għal: Dokumentazzjoni ta' appoġġ, bażijiet ta' għarfien

Kolonni meħtieġa:

• question
• answer

Eżempju:

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. Importazzjoni Prodott

Aħjar għal: Kataloġhi ta' e-commerce, inventarju

Kolonna meħtieġa:

• idProduct (jew kolonna mappata personalizzata)

Opcjonali:

• name (jew kolonna mappata personalizzata)

Eżempju:

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

3. Importazzjoni Default

Aħjar għal: Kontenut ġenerali, data miksija

• Auto-detects struttura FAQ jew Prodott
• Jirritorna għall-importazzjoni ta' dokument ġeneriku
• Jittratta diversi formati CSV

---

Ghid Pass Pass

Pass 1: Aċċess Integrazzjoni

1. Logga fil-AI SmartTalk
2. Mur għal Amministrazzjoni → Il-Assistenti Tiegħi → [Il-Assistenti Tiegħek]
3. Ikklikkja Integrazzjonijiet → CSV URL

Pass 2: Żid CSV URL

URL Uniku:

1. Ikklikkja Żid CSV URL Ġdid
2. Daħħal l-URL tal-fajl CSV
3. Agħti isem fakultattiv
4. Agħżel it-tip ta' importazzjoni (FAQ/Prodott/Default)
5. Agħżel kategorija (fakultattiv)
6. Ikklikkja Żid URL

Importazzjoni Bilk:

1. Ikklikkja Importazzjoni Bilk ta' URLs
2. Daħħal URLs (waħda kull linja)
3. Ikonfigura s-settings kondiviżi
4. Ikklikkja Importa L-Aħjar URLs

Pass 3: Ikonfigura Mappjar tal-Kolonni (Prodott Biss)

Mappa l-kolonni CSV tiegħek mal-qasam mistenni:

• ID Kolonna tal-Prodott: Default idProduct → Mappa għal product_id, sku, eċċ.
• Kolonna tal-Isem: Default name → Mappa għal product_name, title, eċċ.

Pass 4: Ikkontrolla l-Importazzjoni

Segwi l-istatus fl-Istorja tal-Importazzjoni:

• Pendenti: Stennija biex tiġi pproċessata
• Importat: Kompletament suċċess
• Żball: Falliment (ara d-dettalji)

Pass 5: Re-importa (Aġġorna Dati)

1. Sib l-URL fl-istorja
2. Ikklikkja Re-importa
3. Ikkonferma l-azzjoni
4. Ikkontrolla l-istatus aġġornat

Pass 6: Ivvverifika l-Importazzjoni

1. Iċċekkja l-Bażi tal-Għarfien għal dokumenti ġodda
2. Ittestja l-chatbot bil-mistoqsijiet dwar il-kontenut imimportat

---

Rekwiżiti CSV

URLs Validu

✅ 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 mhux appoġġjat)
❌ https://private.site.com/auth-data.csv (Awtorizzazzjoni meħtieġa)
❌ file:///local/data.csv (Fajls lokali mhux appoġġjati)

Rekwiżiti tal-Fajl

• Aċċess: Aċċessibbli pubblikament permezz ta' HTTP/HTTPS
• Headers: Il-linja l-ewwel trid tinkludi l-ismijiet tal-kolonni
• Delimiters: Koma (,) jew semikolon (;)
• Encoding: UTF-8 rakkomandat
• Daqs: Massimu ta' 10MB għal kull fajl

---

Problemi

Żbalji Komuni

Żball	Soluzzjoni
URL Mhux Aċċessibbli	Iċċekkja li l-URL huwa pubbliku u validu
Format Invalidu	Iċċekkja d-delimitatur u l-headers
Kolonni Nieqsa	Assigura li l-kolonni meħtieġa jeżistu (mistoqsija/risposta jew idProduct)
Timeout tal-Fajl Kbir	Iqsam il-fajl jew inaqqas id-daqs taħt 10MB

Passi ta' Riżoluzzjoni

1. Ittestja l-URL fil-browser
2. Ivalida l-struttura u l-encoding tal-CSV
3. Iċċekkja l-messaġġi ta' żball fl-istorja tal-importazzjoni
4. Ittestja b'fajl ta' kampjun iżgħar
5. Ikkuntattja l-appoġġ jekk il-problema tibqa' persistenti

---

Aħjar Prattiċi

Ġestjoni tal-URL

• Uża URLs stabbli, permanenti
• Ittestja l-URLs kull xahar għall-aċċessibilità
• Uża CDN għal prestazzjoni aħjar
• Inkludi l-verżjoni fil-ismijiet tal-fajls: products-v2024.csv

Organizzazzjoni tad-Data

• Uża ismijiet ċari tal-kategoriji
• Żomm formati CSV konsistenti
• Aħsel id-data qabel l-importazzjoni (neħħi r-rigħat vojta)
• Żomm il-fajls taħt 10MB

Prestazzjoni

• Ittestja b'sampli żgħar l-ewwel
• Ipproċessa importazzjonijiet kbar waqt l-iskedi mhux impenjati
• Uża l-importazzjoni bil-kolla għal URLs relatati multipli
• Ikkontrolla r-rata ta' suċċess tal-importazzjoni regolarment

---

Sigurtà

• ✅ Trasferimenti enkriptiċi HTTPS
• ✅ Validazzjoni tal-URL
• ✅ Kontroll ta' aċċess ibbażat fuq il-permessi
• ✅ Proċessar ta' fajls temporanji (mingħajr ħażna permanenti)
• ✅ Tindif awtomatiku tad-data qadima
• ✅ Logs ta' audit għal kull attivitá

---

Wara l-Importazzjoni

Ladarba l-data tiegħek tkun importata:

1. Isir jista' jiġi mfittxija fil-bażi ta' għarfien
2. Iħaddem ir-risposti tal-chatbot immedjatament
3. Juri organizzat skont il-kategoriji
4. Jista' jiġi verifikat fis-sezzjoni tal-Bażi ta' Għarfien

Verifika l-importazzjoni tiegħek:

• Iċċekkja l-Bażi ta' Għarfien għal dokumenti ġodda
• Ittestja l-chatbot bil-mistoqsijiet dwar il-kontenut imimportat
• Reviżjoni tal-kategoriji u l-organizzazzjoni

---

Appoġġ

Bżonn għajnuna?

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

---

Sommarju

Issa tista':

• ✅ Importa data CSV minn URLs pubbliċi
• ✅ Iħaddem FAQ, Prodott, u tipi ta' data ġenerika
• ✅ Importa bil-kolla sorsi multipli
• ✅ Mappa kolonni personalizzati għal prodotti
• ✅ Ikkontrolla u ġestixxi l-importazzjonijiet
• ✅ Aġġorna d-data permezz ta' re-importazzjonijiet

Passi li jmiss:

1. Ittestja b'sampel CSV
2. Importa d-data tal-produzzjoni tiegħek
3. Stabbilixxi kategoriji
4. Ippjana re-importazzjonijiet regolari
5. Ikkontrolla l-prestazzjoni

Mistoqsijiet? Ikkuntattja t-tim ta' appoġġ tagħna fi kwalunkwe ħin.