Une connexion de catalogue Shopify permet à Humind d'utiliser les produits actuels et les données commerciales associées pour la découverte et la recommandation. La connexion n'est que la première étape : vous devez vérifier la bonne boutique, le contexte de marché, le nombre de produits, les enregistrements représentatifs, la visibilité et l'expérience sur la vitrine.

Ce guide documente le processus actuel de connexion et de reconnexion Shopify. Les autres intégrations de catalogue affichées dans la marketplace ne sont pas disponibles de la même manière et ne doivent pas être présentées comme des alternatives Shopify actives.

Comment cela s'intègre dans Humind

Les données du catalogue constituent la base factuelle de la découverte et de la recommandation de produits. L'état de l'intégration, la visibilité des produits, les filtres de métachamps, les collections, les promotions, les marchés et le déploiement sur la vitrine influencent tous ce qu'un acheteur peut voir et ce que l'Agent peut expliquer.

Vérifiez les données sources avant de compenser avec les conseils de l'Agent. Si un prix, une variante, une collection ou un attribut est incorrect dans le catalogue, corrigez ou resynchronisez d'abord cette source, puis testez à nouveau le parcours produit exact dans Humind.

Avant de commencer

Accès : Un accès d'administration de l'entreprise ou du catalogue est requis dans Humind, et l'opérateur qui effectue OAuth doit être autorisé à gérer la boutique Shopify.

• Utilisez le domaine myshopify.com permanent pour la boutique visée.
• Confirmez quel Shopify Market est principal et quels marchés supplémentaires doivent avoir des entreprises Humind distinctes.
• Planifiez une fenêtre de révision avant de modifier une connexion de catalogue en production.

Procédure étape par étape

1. Connecter la boutique Shopify

   Ouvrez Intégrations ou Paramètres, Catalogue, Shopify. Choisissez Se connecter et saisissez le domaine de la boutique au format myshopify.com attendu. Humind lance le processus d'autorisation Shopify ; terminez-le pour la même boutique que celle que vous vouliez connecter.

   N'utilisez pas un domaine personnalisé de vitrine dans le champ de la boutique. Si l'entreprise affiche déjà un domaine Shopify connecté, vérifiez-le avant d'initier une reconnexion.

2. Vérifier Shopify Markets

   Pour les boutiques avec plus d'un marché, la section Shopify Markets répertorie le marché principal, les marchés déjà actifs et les marchés qui peuvent être activés. L'activation d'un marché supplémentaire crée une entreprise Humind limitée à ce marché et démarre sa synchronisation du catalogue.

   Si l'autorisation Shopify existante est antérieure à la portée de marché requise, Humind affiche une invite de reconnexion. Terminez la reconnexion avant d'essayer d'interpréter une liste de marchés manquante.

3. Vérifier la liste des produits

   Ouvrez AI Agent, Catalogue, puis Produits. Comparez les nombres total et synchronisé, recherchez des produits représentatifs et inspectez les titres, les variantes, les prix, la disponibilité, les images, les collections, les descriptions et les métachamps pertinents.

   Utilisez plusieurs types de produits et cas limites, pas seulement une meilleure vente. Un nombre complet peut tout de même masquer un problème de qualité de champ qui affecte les recommandations.

4. Préparer les filtres et exécuter des tests produit

   Une fois les données sources stables, examinez Filtres et Collections. Activez uniquement les attributs utiles et cohérents et vérifiez les groupes de produits spécifiques au marché. Utilisez Test product pour des questions ciblées et Playground pour une découverte plus large.

   Testez les variantes disponibles et indisponibles, les questions sensibles au prix, les comparaisons, ainsi qu'une requête qui ne doit renvoyer aucun résultat. L'Agent ne doit pas inventer un produit correspondant lorsque le catalogue n'en contient pas.

Autorisations et points importants

• L'activation d'un nouveau Shopify Market crée un contexte d'entreprise Humind distinct au lieu de fusionner tous les marchés dans une seule vue du catalogue.
• Reconnect est une étape de réparation de l'autorisation ; confirmez la boutique avant de continuer.
• Les modifications du catalogue peuvent prendre du temps à se synchroniser et à apparaître dans les filtres.
• Corrigez les données Shopify en amont lorsque ce système reste la source de référence.

Vérifier le résultat

Utilisez cette liste de contrôle avant de considérer le travail comme terminé :

• Le domaine myshopify.com connecté et l'entreprise Humind active correspondent.
• Les Shopify Markets principaux et supplémentaires sont représentés comme prévu.
• Les nombres et les champs de produits représentatifs sont corrects après synchronisation.
• Les tests produit gèrent correctement les requêtes valides, indisponibles et sans résultat.

Résolution des problèmes

Le domaine de la boutique est rejeté

Saisissez le domaine Shopify permanent sous la forme store-name.myshopify.com, sans protocole ni chemin de vitrine. Confirmez l'orthographe et la propriété avant de réessayer.

Des marchés sont manquants ou Humind demande de se reconnecter

Utilisez l'action de reconnexion pour accorder la portée de marché Shopify actuelle pour la même boutique. Rechargez ensuite la section Markets et confirmez le marché principal avant d'en activer un autre.

Les produits ou les champs sont incomplets

Confirmez l'entreprise et le marché actifs, laissez la synchronisation se terminer, inspectez le produit dans Shopify et corrigez la source lorsque cela est approprié. Testez de nouveau après la prochaine synchronisation réussie.

Guides associés

• Connecter Shopify et synchroniser votre catalogue
• Configurer les marchés, les langues et les domaines autorisés
• Configurer les collections du catalogue et les filtres IA
• Testez votre Agent dans Playground