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), enregistrez l'URL du flux produit que vous avez déjà (CSV, XML comme Google Shopping ou Lengow, JSON, ou notre format NDJSON) dans le dashboard sous Réglages > Catalogue > Import catalogue > Flux produit. Testez-le d'abord : Humind relie automatiquement ses champs au format Humind, montre ce qui serait importé et ce qui manque, et vous pouvez ajuster la correspondance. Humind le récupère ensuite à 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

Humind peut activer des metafields de lui-même : après chaque import, une analyse active les filtres de recherche et les champs IA (include_in_ai) dont les valeurs aident à répondre aux questions des acheteurs (composition, usage, compatibilité). Une valeur que vous fixez par PUT /settings/metafields n'est jamais réécrite par cette analyse. Pour reprendre la main, 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.