Integrarea URL CSV

Importați documente direct din fișiere CSV accesibile public prin URL în baza de cunoștințe a asistentului dumneavoastră AI.

---

Începere Rapidă

Începeți în 3 pași:

1. Navigați: Administrare → Asistenții Mei → [Numele Asistentului] → Integrări → URL CSV
2. Adăugați URL: Introduceți URL-ul dumneavoastră public CSV și selectați tipul de import (FAQ/Produs/Implicit)
3. Importați: Faceți clic pe "Adăugați URL" și monitorizați starea

Sfat: Testați mai întâi cu un fișier CSV mic pentru a vă familiariza cu procesul.

---

Ce Puteți Face

• ✅ Importați din URL-uri CSV publice HTTP/HTTPS
• ✅ Importați în masă mai multe URL-uri simultan
• ✅ Detectare automată a structurii CSV (FAQ, Produs sau Generic)
• ✅ Atribuiți categorii și mapați coloane personalizate
• ✅ Urmăriți starea și istoricul importului

---

Cerințe Prealabile

• Acces de administrator la asistentul dumneavoastră AI SmartTalk
• Fișiere CSV accesibile public (fără autentificare necesară)
• Structură CSV corespunzătoare cu antete de coloană
• Codificare UTF-8 recomandată

---

Tipuri de Import

1. Import FAQ

Cel mai bine pentru: Documentație de suport, baze de cunoștințe

Coloane necesare:

• question
• answer

Exemplu:

question,answer
"Cum îmi resetez parola?","Faceți clic pe 'Am uitat parola' și urmați instrucțiunile."
"Care sunt orele dumneavoastră de funcționare?","Luni-Vineri, 9 AM - 6 PM."

2. Import Produs

Cel mai bine pentru: Cataloage de comerț electronic, inventar

Coloană necesară:

• idProduct (sau coloană personalizată mapată)

Opțional:

• name (sau coloană personalizată mapată)

Exemplu:

idProduct,name,description,price
"PROD001","Widget Premium","Widget de înaltă calitate","99.99"
"PROD002","Widget Standard","Widget de bază","49.99"

3. Import Implicit

Cel mai bine pentru: Conținut general, date mixte

• Detectează automat structura FAQ sau Produs
• Revine la importul de documente generice
• Gestionează diverse formate CSV

---

Ghid Pas cu Pas

Pasul 1: Accesare Integrare

1. Conectați-vă la AI SmartTalk
2. Accesați Administrare → Asistenții Mei → [Asistentul Dvs.]
3. Faceți clic pe Integrări → CSV URL

Pasul 2: Adăugați CSV URL

URL Unic:

1. Faceți clic pe Adăugați un Nou CSV URL
2. Introduceți URL-ul fișierului CSV
3. Furnizați un nume opțional
4. Selectați tipul de import (FAQ/Produs/Implicit)
5. Alegeți categoria (opțional)
6. Faceți clic pe Adăugați URL

Import în Masă:

1. Faceți clic pe Import URL-uri în Masă
2. Introduceți URL-urile (câte unul pe linie)
3. Configurați setările comune
4. Faceți clic pe Importați Toate URL-urile

Pasul 3: Configurați Maparea Coloanelor (Numai Produs)

Maparea coloanelor CSV la câmpurile așteptate:

• Coloana ID Produs: Implicit idProduct → Mapare la product_id, sku, etc.
• Coloana Nume: Implicit name → Mapare la product_name, title, etc.

Pasul 4: Monitorizați Importul

Urmăriți starea în Istoricul Importurilor:

• În Așteptare: Așteaptă procesare
• Importat: Finalizat cu succes
• Eroare: Eșuat (vizualizați detalii)

Pasul 5: Re-importare (Actualizare Date)

1. Găsiți URL-ul în istoric
2. Faceți clic pe Re-importare
3. Confirmați acțiunea
4. Monitorizați starea actualizată

Pasul 6: Verificați Importul

1. Verificați Baza de Cunoștințe pentru documente noi
2. Testați chatbot-ul cu întrebări despre conținutul importat

---

Cerințe CSV

URL-uri Valide

✅ 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 nu este suportat)
❌ https://private.site.com/auth-data.csv (Autentificare necesară)
❌ file:///local/data.csv (Fișierele locale nu sunt suportate)

Cerințe Fișier

• Acces: Accesibil public prin HTTP/HTTPS
• Antete: Prima linie trebuie să conțină numele coloanelor
• Delimitatori: Virgula (,) sau punct și virgulă (;)
• Codificare: UTF-8 recomandat
• Dimensiune: Maximum 10MB pe fișier

---

Rezolvarea Problemelor

Erori Comune

Eroare	Soluție
URL Nu Este Accesibil	Verificați dacă URL-ul este public și valid
Format Invalid	Verificați delimitatorul și antetele
Coloane Lipsă	Asigurați-vă că coloanele necesare există (întrebare/răspuns sau idProduct)
Timeout Fișier Mare	Împărțiți fișierul sau reduceți dimensiunea sub 10MB

Pași de Rezolvare

1. Testați URL-ul în browser
2. Validați structura și codificarea CSV
3. Revizuiți mesajele de eroare din istoricul importurilor
4. Testați cu un fișier de probă mai mic
5. Contactați suportul dacă problema persistă

---

Cele Mai Bune Practici

Managementul URL-urilor

• Utilizați URL-uri stabile și permanente
• Testați URL-urile lunar pentru accesibilitate
• Folosiți CDN pentru o performanță mai bună
• Includeți versiunea în numele fișierelor: products-v2024.csv

Organizarea Datelor

• Utilizați denumiri clare pentru categorii
• Mențineți formate CSV consistente
• Curățați datele înainte de import (eliminați rândurile goale)
• Păstrați fișierele sub 10MB

Performanță

• Testați mai întâi cu mostre mici
• Procesați importuri mari în timpul orelor de vârf
• Folosiți importul în masă pentru mai multe URL-uri conexe
• Monitorizați periodic rata de succes a importului

---

Securitate

• ✅ Transferuri criptate HTTPS
• ✅ Validarea URL-urilor
• ✅ Controlul accesului bazat pe permisiuni
• ✅ Procesarea fișierelor temporare (fără stocare permanentă)
• ✅ Curățarea automată a datelor vechi
• ✅ Jurnale de audit pentru toate activitățile

---

După Import

Odată importate, datele dvs.:

1. Devine căutabilă în baza de cunoștințe
2. Alimentează imediat răspunsurile chatbot-ului
3. Apare organizată pe categorii
4. Poate fi verificată în secțiunea Baza de Cunoștințe

Verificați importul dvs.:

• Verificați Baza de Cunoștințe pentru documente noi
• Testați chatbot-ul cu întrebări despre conținutul importat
• Revizuiți categoriile și organizarea

---

Suport

Aveți nevoie de ajutor?

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

---

Rezumat

Acum puteți:

• ✅ Importa date CSV din URL-uri publice
• ✅ Gestiona tipuri de date FAQ, Produs și generice
• ✅ Importa în masă din mai multe surse
• ✅ Maparea coloanelor personalizate pentru produse
• ✅ Monitoriza și gestiona importurile
• ✅ Actualiza datele prin re-importuri

Pașii următori:

1. Testați cu un fișier CSV de probă
2. Importați datele dvs. de producție
3. Configurați categoriile
4. Programați re-importuri regulate
5. Monitorizați performanța

Întrebări? Contactați echipa noastră de suport oricând.