Importer un catalogue CSV
Importez votre catalogue produits en quelques secondes depuis un fichier CSV. Le chatbot pourra ensuite recommander vos produits directement dans la conversation.
Prérequis : La feature Recommandations produits doit être activée sur votre chatbot (Dashboard → Features → Recommandations produits).
Format du fichier CSV
Le fichier CSV doit être encodé en UTF-8 avec des virgules comme séparateur. La première ligne doit contenir les en-têtes de colonnes.
Colonnes requises
| Colonne | Type | Description |
|---|---|---|
| name | Texte | Nom du produit |
| description | Texte | Description complète (utilisée pour la recherche sémantique) |
| price | Nombre | Prix (ex. 29.99) |
Colonnes optionnelles
| Colonne | Type | Description |
|---|---|---|
| currency | Texte | Devise (défaut : EUR) |
| image_url | URL | URL de l'image produit (affichée dans le carrousel) |
| product_url | URL | Lien vers la page produit sur votre site |
| stock_status | Enum | in_stock | low_stock | out_of_stock |
| sku | Texte | Référence interne du produit |
| category | Texte | Catégorie produit (pour filtrage) |
| tags | Texte | Tags séparés par des virgules (ex. bio,vegane,bestseller) |
Exemple de fichier CSV
name,description,price,currency,image_url,product_url,stock_status,sku,category "Crème hydratante visage","Crème nourrissante pour peaux sèches, enrichie en acide hyaluronique et vitamine E. Convient aux peaux sensibles.",29.99,EUR,https://cdn.monsite.fr/creme.jpg,https://monsite.fr/creme,in_stock,SKU-001,Soins visage "Sérum anti-âge","Sérum concentré avec rétinol 0.3% et peptides. Atténue les rides et améliore l'éclat en 4 semaines.",49.99,EUR,https://cdn.monsite.fr/serum.jpg,https://monsite.fr/serum,in_stock,SKU-002,Soins visage "Baume lèvres","Baume réparateur naturel parfum vanille. Format pocket, sans paraben.",8.99,EUR,,https://monsite.fr/baume,low_stock,SKU-003,Lèvres
Procédure d'import
- Dashboard → votre chatbot → Produits
- Cliquez sur Importer un CSV
- Sélectionnez votre fichier (max 10 Mo)
- Kaiply valide le format et affiche un aperçu des données
- Confirmez l'import — les produits sont ajoutés au catalogue
Import partiel : Si certaines lignes contiennent des erreurs (URL invalide, prix non numérique), les lignes valides sont importées et les lignes erronées sont signalées dans un rapport d'erreurs.
Comment le chatbot utilise le catalogue
Quand un visiteur décrit ce qu'il cherche ("je veux quelque chose pour les peaux sèches"), le chatbot :
- Effectue une recherche sémantique dans votre catalogue
- Sélectionne les 3 produits les plus pertinents
- Les affiche en carrousel visuel dans le widget (image, nom, prix, lien)
- Enregistre un "view" pour chaque produit affiché
- Enregistre un "click" quand le visiteur clique sur un produit
Astuce : Plus la description de vos produits est détaillée et inclut les cas d'usage ("idéal pour les peaux sèches", "parfait pour l'hiver"), plus la recherche sémantique sera précise.