Intégration CSV URL

Importez des documents directement à partir de fichiers CSV accessibles publiquement via URL dans la base de connaissances de votre assistant IA.

---

Démarrage rapide

Commencez en 3 étapes :

1. Naviguez : Administration → Mes Assistants → [Nom de l'Assistant] → Intégrations → CSV URL
2. Ajoutez l'URL : Entrez votre URL CSV publique et sélectionnez le type d'importation (FAQ/Produit/Par défaut)
3. Importez : Cliquez sur "Ajouter l'URL" et surveillez l'état

Astuce : Testez d'abord avec un petit fichier CSV pour vous familiariser avec le processus.

---

Ce que vous pouvez faire

• ✅ Importer à partir d'URL CSV HTTP/HTTPS publiques
• ✅ Importer en masse plusieurs URL à la fois
• ✅ Détecter automatiquement la structure CSV (FAQ, Produit ou Générique)
• ✅ Assigner des catégories et mapper des colonnes personnalisées
• ✅ Suivre l'état et l'historique des importations

---

Prérequis

• Accès administrateur à votre assistant AI SmartTalk
• Fichiers CSV accessibles publiquement (aucune authentification requise)
• Structure CSV appropriée avec en-têtes de colonnes
• Encodage UTF-8 recommandé

---

Types d'importation

1. Importation FAQ

Idéal pour : Documentation de support, bases de connaissances

Colonnes requises :

• question
• answer

Exemple :

question,answer
"Comment réinitialiser mon mot de passe ?","Cliquez sur 'Mot de passe oublié' et suivez les instructions."
"Quels sont vos horaires ?","Du lundi au vendredi, de 9h à 18h."

2. Importation Produit

Idéal pour : Catalogues de commerce électronique, inventaire

Colonne requise :

• idProduct (ou colonne mappée personnalisée)

Optionnel :

• name (ou colonne mappée personnalisée)

Exemple :

idProduct,name,description,price
"PROD001","Widget Premium","Widget de haute qualité","99.99"
"PROD002","Widget Standard","Widget basique","49.99"

3. Importation Par défaut

Idéal pour : Contenu général, données mixtes

• Détecte automatiquement la structure FAQ ou Produit
• Revertit à l'importation de documents génériques
• Gère divers formats CSV

---

Guide étape par étape

Étape 1 : Accéder à l'intégration

1. Connectez-vous à AI SmartTalk
2. Allez dans Administration → Mes Assistants → [Votre Assistant]
3. Cliquez sur Intégrations → CSV URL

Étape 2 : Ajouter l'URL CSV

URL unique :

1. Cliquez sur Ajouter une nouvelle URL CSV
2. Entrez l'URL du fichier CSV
3. Fournissez un nom optionnel
4. Sélectionnez le type d'importation (FAQ/Produit/Par défaut)
5. Choisissez une catégorie (optionnel)
6. Cliquez sur Ajouter l'URL

Importation en masse :

1. Cliquez sur Importation en masse d'URLs
2. Entrez les URLs (une par ligne)
3. Configurez les paramètres partagés
4. Cliquez sur Importer toutes les URLs

Étape 3 : Configurer le mappage des colonnes (Produit uniquement)

Mappez vos colonnes CSV aux champs attendus :

• Colonne ID Produit : Par défaut idProduct → Mapper à product_id, sku, etc.
• Colonne Nom : Par défaut name → Mapper à product_name, title, etc.

Étape 4 : Suivre l'importation

Suivez le statut dans l'historique des importations :

• En attente : En attente de traitement
• Importé : Terminé avec succès
• Erreur : Échoué (voir les détails)

Étape 5 : Réimporter (Mettre à jour les données)

1. Trouvez l'URL dans l'historique
2. Cliquez sur Réimporter
3. Confirmez l'action
4. Suivez le statut mis à jour

Étape 6 : Vérifier l'importation

1. Vérifiez la base de connaissances pour de nouveaux documents
2. Testez le chatbot avec des questions sur le contenu importé

---

Exigences CSV

URLs valides

✅ 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 supporté)
❌ https://private.site.com/auth-data.csv (Authentification requise)
❌ file:///local/data.csv (Fichiers locaux non supportés)

Exigences de fichier

• Accès : Accessible publiquement via HTTP/HTTPS
• En-têtes : La première ligne doit contenir les noms des colonnes
• Délimiteurs : Virgule (,) ou point-virgule (;)
• Encodage : UTF-8 recommandé
• Taille : Maximum 10 Mo par fichier

---

Dépannage

Erreurs courantes

Erreur	Solution
URL non accessible	Vérifiez que l'URL est publique et valide
Format invalide	Vérifiez le délimiteur et les en-têtes
Colonnes manquantes	Assurez-vous que les colonnes requises existent (question/réponse ou idProduct)
Délai d'attente pour fichier volumineux	Divisez le fichier ou réduisez sa taille en dessous de 10 Mo

Étapes de résolution

1. Testez l'URL dans le navigateur
2. Validez la structure et l'encodage du CSV
3. Examinez les messages d'erreur dans l'historique des importations
4. Testez avec un fichier d'échantillon plus petit
5. Contactez le support si le problème persiste

---

Meilleures Pratiques

Gestion des URL

• Utilisez des URL stables et permanentes
• Testez les URL chaque mois pour l'accessibilité
• Utilisez un CDN pour de meilleures performances
• Incluez la version dans les noms de fichiers : products-v2024.csv

Organisation des Données

• Utilisez des noms de catégories clairs
• Maintenez des formats CSV cohérents
• Nettoyez les données avant l'importation (supprimez les lignes vides)
• Gardez les fichiers en dessous de 10 Mo

Performance

• Testez d'abord avec de petits échantillons
• Traitez les grandes importations pendant les heures creuses
• Utilisez l'importation en masse pour plusieurs URL connexes
• Surveillez régulièrement le taux de succès des importations

---

Sécurité

• ✅ Transferts chiffrés en HTTPS
• ✅ Validation des URL
• ✅ Contrôle d'accès basé sur les permissions
• ✅ Traitement des fichiers temporaires (pas de stockage permanent)
• ✅ Nettoyage automatique des anciennes données
• ✅ Journaux d'audit pour toutes les activités

---

Après l'Importation

Une fois importées, vos données :

1. Deviennent recherchables dans la base de connaissances
2. Alimentent immédiatement les réponses du chatbot
3. S'affichent organisées par catégories
4. Peuvent être vérifiées dans la section Base de Connaissances

Vérifiez votre importation :

• Consultez la Base de Connaissances pour de nouveaux documents
• Testez le chatbot avec des questions sur le contenu importé
• Passez en revue les catégories et l'organisation

---

Support

Besoin d'aide ?

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

---

Résumé

Vous pouvez maintenant :

• ✅ Importer des données CSV à partir d'URL publiques
• ✅ Gérer les types de données FAQ, Produit et génériques
• ✅ Importer en masse plusieurs sources
• ✅ Mapper des colonnes personnalisées pour les produits
• ✅ Surveiller et gérer les importations
• ✅ Mettre à jour les données par le biais de ré-importations

Prochaines étapes :

1. Testez avec un fichier CSV d'exemple
2. Importez vos données de production
3. Configurez les catégories
4. Planifiez des ré-importations régulières
5. Surveillez la performance

Questions ? Contactez notre équipe de support à tout moment.