Synchroniser votre catalogue

Où aller dépend de votre stack.

• Merchants Shopify : voir Sync catalogue Shopify. L'app Humind gère tout via webhooks ; rien à construire de votre côté.
• Tous les autres (WooCommerce, Magento, headless commerce, backends custom, ERP qui possède la data produit) : poussez votre catalogue depuis n'importe quelle stack avec l'API Humind. Authentification avec un seul bearer token, JSON sur HTTPS, JSON en retour.

Si vous ne pouvez pas exécuter de code contre l'API (module PrestaShop ou CMS, export PIM ou ERP, flux construit par votre agence), exposez votre catalogue sous forme de fichier NDJSON à une URL HTTPS et enregistrez cette URL dans le dashboard sous Réglages > Catalogue > Import catalogue > Flux produit. Humind le récupère à la fréquence choisie (toutes les 1 à 24 heures) et le passe dans le même pipeline d'import. Voir URL de flux produit.

Parcours d'intégration recommandé

Une intégration custom complète tient en quatre étapes. Chacune renvoie vers la référence complète.

1. Poussez vos produits

Utilisez POST /products pour une poignée de produits, ou l'import NDJSON en masse pour un catalogue complet (un produit par ligne, asynchrone, rapport d'erreurs par ligne).

Poussez autant de données produit structurées que possible : l'assistant n'est bon que si les données sur lesquelles il s'ancre le sont. En pratique :

• Les champs standards d'abord : titre, description, images, variantes avec prix et stock, online_store_url, catégories, marque.
• Tout le reste en metafields : composition, conseils d'utilisation, notes olfactives, matières, dimensions, instructions d'entretien, classements internes. Le nommage vous appartient ; un namespace stable par domaine de données fonctionne le mieux (ex. olfactif.notes_tete, conseil.utilisation).
• Les listes (une pyramide olfactive, une liste de thèmes) sont des chaînes JSON encodées avec un type list.* : {"namespace": "olfactif", "key": "notes_tete", "type": "list.single_line_text_field", "value": "[\"Bergamote\",\"Mandarine\"]"}.
• Poussez les metafields utiles à l'IA au niveau produit, pas au niveau variante : les metafields de variante sont stockés mais pas lus par l'assistant.
• Vous vendez en plusieurs langues ? Utilisez translations pour les titres, les descriptions et les overrides de metafields par langue.
• Les recommandations éditorialisées (« se marie bien avec », « vous aimerez aussi ») vont dans related_products / complementary_products ; l'assistant les utilise pour le cross-sell.

2. Activez vos metafields

Les metafields stockés n'alimentent pas l'assistant tant qu'ils ne sont pas activés. Appelez GET /settings/metafields pour voir ce qu'Humind a détecté, puis PUT /settings/metafields pour activer les champs pour l'IA (include_in_ai), les filtres de recherche (use_as_filter) et l'affichage. Cette étape peut tourner en fin de pipeline d'import ; la référence documente les jobs de ré-indexation que l'appel déclenche.

3. Ajoutez la connaissance hors catalogue

FAQ, politiques de livraison et de retour, guides des tailles, contenu de marque : poussez-les via l'API Knowledge pour que l'assistant réponde aussi aux questions de support, pas seulement aux questions produit.

4. Gardez le catalogue frais

Relancez votre import à chaque changement de catalogue (un run NDJSON quotidien ou horaire est le pattern courant ; les imports sont idempotents par external_id), ou laissez Humind le faire pour vous avec une URL de flux produit. Utilisez les webhooks si vous devez réagir à des événements côté Humind.

Regroupement et merchandising

• Groupes de produits : déclarez que plusieurs produits sont le même modèle en différentes couleurs ou matières pour que l'assistant propose des alternatives au sein de la famille.
• Collections : des regroupements de merchandising (« essentiels de l'été ») que l'assistant peut parcourir et sur lesquels il peut filtrer.