L’assistant d'achat Mira AI utilise votre flux de produits pour recommander des produits, répondre aux questions de prix et vérifier la disponibilité. Ce guide explique les formats de flux acceptés par Mira AI, les balises qu’il lit, et où trouver les instructions officielles d’exportation pour les plateformes de commerce électronique les plus populaires.

Nous avons divisé le guide en les sections suivantes :

Le flux ou le web scrape ne fonctionne pas ? Dépannage des sources de connaissances de Mira AI

Avant de commencer

Mira AI accepte les flux de produits XML standards — le même format que la plupart des plateformes de commerce électronique génèrent pour Heuréka, Google Shopping, Zboží.cz et d'autres places de marché similaires. Plus votre flux est riche (prix, disponibilité, description, lien, catégorie), plus les recommandations de Mira seront pertinentes.

Pour ajouter le flux dans Smartsupp :

Dans le builder de l’assistant, ouvrez Base de connaissances → Produits et cliquez sur Ajouter.
Saisissez un nom pour la source.
Collez l’URL complète de votre flux de produits.
À l’étape Mise à jour, choisissez la fréquence de rafraîchissement du flux.

Conseil : Consultez Introduction à Mira AI pour la configuration complète.

Mira AI actualise automatiquement votre flux de produits à intervalles réguliers — les changements de prix, les mises à jour de disponibilité et les nouveaux produits apparaîtront dans le chat sans que vous ayez besoin de re-téléverser le fichier.

Remarque : Mira AI charge les images des cartes produits directement depuis votre flux XML. Si un produit ne comporte pas d’image dans le flux, Mira utilisera l’image Open Graph ou l’image mise en avant sur la page produit — il est donc conseillé de configurer aussi ces images.

Remarque : Si votre serveur limite les connexions entrantes (pare-feu, liste blanche d’IP), assurez-vous d'autoriser l’accès depuis les adresses IP du robot de récupération des flux de Smartsupp : 94.130.187.58 et 188.245.65.74. Sinon, Mira AI ne pourra pas télécharger votre flux de produits.

Ces adresses IP peuvent occasionnellement changer. Si votre flux cesse soudainement d'être mis à jour, consultez cet article pour la liste actuelle ou contactez notre support.

Formats de flux pris en charge

Mira AI prend en charge deux formats de flux de produits standards — Heuréka et Google Merchant. Les deux suivent des conventions XML courantes :

L’extension du fichier est .xml ou .rss.
La toute première ligne doit commencer par <?xml ...?> ou <rss ...>.
Une balise parent englobe tous les produits. Le nom de la balise parent peut être quelconque (par ex. <SHOP>) — seule son existence compte.
Chaque produit est enveloppé dans sa propre balise (voir les sections spécifiques ci-dessous).

Un squelette minimal valide est le suivant :

<?xml version="1.0" encoding="UTF-8"?> <SHOP> <SHOPITEM> ... </SHOPITEM> <SHOPITEM> ... </SHOPITEM> </SHOP>

Important : Si une balise obligatoire est manquante sur un produit, ce produit entier est ignoré par l’index de Mira — les visiteurs ne le verront pas dans les recommandations. Assurez-vous que chaque produit comporte toutes les balises requises remplies.

Structure du flux Heuréka

Pour le format Heuréka, Mira AI lit les balises suivantes. Consultez la documentation officielle du flux XML Heuréka pour la spécification complète.

Catégorie	Balises	Remarques
Enveloppe produit (obligatoire)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Chacune de ces balises entoure chaque produit.
Description (obligatoire)	`PRODUCTNAME` (ou `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Chaque balise doit contenir du contenu. Une balise vide est considérée comme manquante.
Volontaire	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE` : 0 = en stock, 1–7 = disponible sous une semaine, tout autre valeur / manquant = non disponible. `PARAM` peut être présent plusieurs fois par produit.
Image	`IMGURL`	Image du produit sur la fiche. Si elle est absente, Mira utilisera l’image Open Graph ou l’image mise en avant sur la page produit.
Ignoré	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ignore ces balises — vous pouvez les laisser dans le flux pour d’autres outils.

Une balise PARAM transporte un attribut supplémentaire du produit comme paire nom–valeur :

<PARAM> <PARAM_NAME>Largeur</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Structure du flux Google Merchant

Pour le format Google Merchant, Mira AI lit les balises suivantes. Consultez la spécification officielle du flux Google Merchant pour la référence complète.

Remarque : Les identifiants numériques google_product_category ne sont pas encore pris en charge. Utilisez toujours la version texte de la catégorie — par exemple « Vêtements et accessoires > Vêtements > Chemises et hauts » — ou utilisez product_type à la place.

Catégorie	Balises	Remarques
Enveloppe produit (obligatoire)	`item`, `entry`, `product`	Chacune de ces balises entoure chaque produit.
Description (obligatoire)	`title`, `description`, `product_type` (ou `google_product_category`), `link`, `price`	Pour la catégorie, utilisez `product_type` ou `google_product_category` avec le nom texte — les identifiants numériques de catégorie ne sont pas encore pris en charge.
Format du prix	`price`	Format autorisé : `236 CZK` ou `CZK 236`. Sont également acceptés les séparateurs décimaux et de milliers, par exemple `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ou `1 049,00 CHF`. La devise est un code à trois lettres (CZK, EUR, GBP…).
Prix promotionnel (optionnel)	`sale_price`, `sale_price_effective_date`	Si `sale_price` est présent, dans la même devise que `price` et inférieur à celui-ci, Mira citera le prix promotionnel dans les réponses, les recherches de produits et sur les fiches produit. Avec `sale_price_effective_date`, le prix promotionnel n’est utilisé que pendant la période donnée (vérifiée au moment de la question) ; en dehors de celle-ci, ou si la plage ne peut pas être lue, Mira utilise le prix normal. Les flux existants récupèrent les prix promotionnels lors de leur prochaine mise à jour.
Volontaire	`availability`	En stock : `in_stock`, `in stock`. Non disponible : `out_of_stock`, `out of stock`, `preorder`, `backorder`, toute autre valeur / manquant.
Image	`image_link`	Image du produit sur la fiche. Si elle est absente, Mira utilisera l’image Open Graph ou l’image mise en avant sur la page produit.
Ignoré	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ignore ces balises — vous pouvez les laisser dans le flux pour d’autres outils.

Mira lit également les tailles des produits dans votre flux (balise size) et peut les mentionner lors des recommandations de produits. Les tailles apparaissent dès que votre flux est mis à jour.

Exporter un flux par plateforme

Trouvez votre plateforme de commerce électronique dans le tableau ci-dessous et suivez le guide d’exportation officiel.

Plateforme	Ce que cela génère	Guide officiel
Shoptet	XML Heuréka & Google Shopping depuis le panneau d’administration	Flux XML • XML Heuréka
Shopsys	Flux de produits via la plateforme avec documentation développeur	Flux produits
Eshop-rychle	Flux pour les comparateurs de prix	Exportation produits
Upgates	Exportation de données XML avec la structure complète des produits	Exportation de données • Docs XML
Shoper	Flux produit Google directement depuis la plateforme	Flux Google
Shopware	Google Shopping — exportation directe ou via des compléments	Exportation directe • Compléments
Shoprenter	Flux Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping via compléments	Compléments
Magento	Google Shopping via extensions	Extensions
WooCommerce	Google Product Feed via compléments	Compléments • Recommandé

Et après ?

Introduction à l’assistant d'achat Mira AI — configurez Mira AI et ajoutez votre flux de produits comme source.
Comment commencer à entraîner Mira AI — ajustez les réponses de l’IA avec des paires questions/réponses personnalisées.
Mira AI : disponibilité en stock — laissez les visiteurs vérifier si un produit est en stock.
FAQ de l’assistant d'achat Mira AI — questions fréquentes sur Mira AI.

💡 Besoin d’aide supplémentaire ? Contactez notre équipe support — nous sommes là pour vous aider !

Comment exporter les flux de produits à partir de diverses plateformes de commerce électronique pour l’assistant d'achat Mira AI ?