Integrazione CSV URL

Importa documenti direttamente da file CSV accessibili pubblicamente tramite URL nella base di conoscenza del tuo assistente AI.

---

Inizio Rapido

Inizia in 3 passaggi:

1. Naviga: Amministrazione → I miei Assistenti → [Nome Assistente] → Integrazioni → CSV URL
2. Aggiungi URL: Inserisci il tuo URL CSV pubblico e seleziona il tipo di importazione (FAQ/Prodotto/Predefinito)
3. Importa: Clicca su "Aggiungi URL" e monitora lo stato

Suggerimento: Prova prima con un piccolo file CSV per familiarizzare con il processo.

---

Cosa Puoi Fare

• ✅ Importa da URL CSV pubblici HTTP/HTTPS
• ✅ Importa in blocco più URL contemporaneamente
• ✅ Rilevamento automatico della struttura CSV (FAQ, Prodotto o Generico)
• ✅ Assegna categorie e mappa colonne personalizzate
• ✅ Monitora lo stato e la cronologia dell'importazione

---

Requisiti

• Accesso amministrativo al tuo assistente AI SmartTalk
• File CSV accessibili pubblicamente (nessuna autenticazione richiesta)
• Struttura CSV corretta con intestazioni di colonna
• Codifica UTF-8 raccomandata

---

Tipi di Importazione

1. Importazione FAQ

Ideale per: Documentazione di supporto, basi di conoscenza

Colonne richieste:

• question
• answer

Esempio:

question,answer
"Come posso reimpostare la mia password?","Clicca su 'Password Dimenticata' e segui le istruzioni."
"Quali sono i vostri orari?","Lunedì-Venerdì, 9:00 - 18:00."

2. Importazione Prodotto

Ideale per: Cataloghi e-commerce, inventario

Colonna richiesta:

• idProduct (o colonna mappata personalizzata)

Opzionale:

• name (o colonna mappata personalizzata)

Esempio:

idProduct,name,description,price
"PROD001","Widget Premium","Widget di alta qualità","99.99"
"PROD002","Widget Standard","Widget base","49.99"

3. Importazione Predefinita

Ideale per: Contenuti generali, dati misti

• Rileva automaticamente la struttura FAQ o Prodotto
• Ricade sull'importazione di documenti generici
• Gestisce vari formati CSV

---

Guida Passo-Passo

Passo 1: Accesso all'Integrazione

1. Accedi a AI SmartTalk
2. Vai su Amministrazione → I Miei Assistenti → [Il Tuo Assistente]
3. Clicca su Integrazioni → CSV URL

Passo 2: Aggiungi CSV URL

URL Singolo:

1. Clicca su Aggiungi Nuovo CSV URL
2. Inserisci l'URL del file CSV
3. Fornisci un nome opzionale
4. Seleziona il tipo di importazione (FAQ/Prodotto/Predefinito)
5. Scegli la categoria (opzionale)
6. Clicca su Aggiungi URL

Importazione di Massa:

1. Clicca su Importa URL di Massa
2. Inserisci gli URL (uno per riga)
3. Configura le impostazioni condivise
4. Clicca su Importa Tutti gli URL

Passo 3: Configura Mappatura delle Colonne (Solo Prodotto)

Mappa le colonne del tuo CSV ai campi attesi:

• Colonna ID Prodotto: Predefinito idProduct → Mappa a product_id, sku, ecc.
• Colonna Nome: Predefinito name → Mappa a product_name, title, ecc.

Passo 4: Monitora l'Importazione

Monitora lo stato nella Cronologia Importazioni:

• In Attesa: In attesa di elaborazione
• Importato: Completato con successo
• Errore: Fallito (visualizza dettagli)

Passo 5: Re-importa (Aggiorna Dati)

1. Trova l'URL nella cronologia
2. Clicca su Re-importa
3. Conferma l'azione
4. Monitora lo stato aggiornato

Passo 6: Verifica l'Importazione

1. Controlla la Base di Conoscenza per nuovi documenti
2. Testa il chatbot con domande sui contenuti importati

---

Requisiti CSV

URL Validi

✅ 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 non supportato)
❌ https://private.site.com/auth-data.csv (Autenticazione richiesta)
❌ file:///local/data.csv (File locali non supportati)

Requisiti del File

• Accesso: Accessibile pubblicamente tramite HTTP/HTTPS
• Intestazioni: La prima riga deve contenere i nomi delle colonne
• Delimitatori: Virgola (,) o punto e virgola (;)
• Codifica: UTF-8 consigliata
• Dimensione: Massimo 10MB per file

---

Risoluzione dei Problemi

Errori Comuni

Errore	Soluzione
URL Non Accessibile	Verifica che l'URL sia pubblico e valido
Formato Non Valido	Controlla il delimitatore e le intestazioni
Colonne Mancanti	Assicurati che le colonne richieste esistano (domanda/risposta o idProduct)
Timeout File Grande	Suddividi il file o riduci la dimensione sotto 10MB

Passi di Risoluzione

1. Testa l'URL nel browser
2. Valida la struttura e la codifica del CSV
3. Rivedi i messaggi di errore nella cronologia importazioni
4. Testa con un file di esempio più piccolo
5. Contatta il supporto se il problema persiste

---

Best Practices

URL Management

• Utilizzare URL stabili e permanenti
• Testare gli URL mensilmente per l'accessibilità
• Utilizzare CDN per migliori prestazioni
• Includere la versione nei nomi dei file: products-v2024.csv

Data Organization

• Utilizzare nomi di categoria chiari
• Mantenere formati CSV coerenti
• Pulire i dati prima dell'importazione (rimuovere righe vuote)
• Tenere i file sotto 10MB

Performance

• Testare prima con campioni piccoli
• Elaborare grandi importazioni durante le ore di bassa affluenza
• Utilizzare l'importazione in blocco per più URL correlati
• Monitorare regolarmente il tasso di successo dell'importazione

---

Security

• ✅ Trasferimenti crittografati HTTPS
• ✅ Validazione degli URL
• ✅ Controllo degli accessi basato su permessi
• ✅ Elaborazione di file temporanei (nesso storage permanente)
• ✅ Pulizia automatica dei dati obsoleti
• ✅ Registri di audit per tutte le attività

---

After Import

Una volta importati, i tuoi dati:

1. Diventano ricercabili nella knowledge base
2. Attivano immediatamente le risposte del chatbot
3. Appaiono organizzati per categorie
4. Possono essere verificati nella sezione Knowledge Base

Verifica il tuo import:

• Controlla la Knowledge Base per nuovi documenti
• Testa il chatbot con domande sui contenuti importati
• Rivedi categorie e organizzazione

---

Support

Hai bisogno di aiuto?

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

---

Summary

Ora puoi:

• ✅ Importare dati CSV da URL pubblici
• ✅ Gestire tipi di dati FAQ, Prodotto e generici
• ✅ Importare in blocco più fonti
• ✅ Mappare colonne personalizzate per i prodotti
• ✅ Monitorare e gestire le importazioni
• ✅ Aggiornare i dati tramite re-importazioni

Prossimi passi:

1. Testa con un CSV di esempio
2. Importa i tuoi dati di produzione
3. Configura le categorie
4. Pianifica re-importazioni regolari
5. Monitora le prestazioni

Domande? Contatta il nostro team di supporto in qualsiasi momento.