FAQ

Est-ce que Humind ralentit mon site ?

Aucun impact significatif. Les scripts chargent avec defer, donc ils ne bloquent jamais le rendu de la page ni le Time to Interactive. Ils sont servis depuis un CDN (embed.thehumind.com, widgets.thehumind.com), code-splittés en chunks, et seul le chunk d'entrée tourne au mount. Le reste est fetché à la demande quand le visiteur interagit.

Les widgets ne touchent pas votre chemin de rendu critique et n'ajoutent aucune requête bloquante. Si vous mesurez les Core Web Vitals avant et après installation, ni le LCP ni le CLS ne doivent régresser.

Que se passe-t-il si le script Humind ne charge pas ?

Rien ne casse. La balise <script> est chargée en defer, donc une erreur réseau ne bloque jamais le rendu de la page. Les custom elements restent inertes : pas de layout shift, pas d'erreur visible côté visiteur, pas d'exception levée.

Que se passe-t-il pendant une panne Humind ?

L'overlay de chat affiche un message de fallback « indisponible » et retente en arrière-plan. Les widgets in-page qui dépendent de l'API se cachent silencieusement (voir la section correspondante du dépannage). Votre site hôte continue de fonctionner comme si Humind n'était pas là. Abonnez-vous à la page de statut.

Est-ce que c'est un iframe ?

Non. Chaque widget (<humind-widget>, <humind-quiz>, <humind-gift-finder>, <humind-product-questions>) est un custom element HTML natif, autrement dit un Web Component. Pas d'overhead d'iframe, pas de postMessage cross-frame, pas de document séparé.

L'overlay de chat et deux des widgets (<humind-gift-finder>, <humind-product-questions>) utilisent le Shadow DOM en interne pour isoler les styles, donc le CSS du site hôte ne peut ni entrer ni sortir. <humind-quiz> est l'exception : il render dans le light DOM, donc votre CSS s'y applique (voir Dépannage → Styles qui fuient).

Je peux mettre plusieurs widgets sur la même page ?

Oui. Chaque custom element est indépendant : vous pouvez embarquer <humind-widget>, <humind-gift-finder> et <humind-product-questions> sur la même page, et ils se coordonnent via l'event humind-open-chat (les widgets dispatchent, le chat écoute).

Ne dupliquez pas <humind-widget> lui-même : le loader l'enregistre une fois et log un warning console sur une seconde registration.

Ça marche en SSR (Next.js, Nuxt, Astro) ?

Oui. Les custom elements sont rendus comme des tags vides côté serveur et s'hydratent côté client après le chargement du loader. Rien de spécifique au framework n'est nécessaire au-delà de déclarer humind-* comme custom elements (voir le guide d'installation).

Ça marche avec le client-side routing d'un SPA ?

Oui. Si votre router remplace les composants de page à la navigation (React Router, Next App Router, Vue Router, Angular Router), le widget se re-mount proprement.

Pour le chat, on recommande de garder un seul <humind-widget> monté à la racine de l'app pour que l'état de la conversation survive à la navigation côté client. Dans ce cas, mettez à jour l'attribut template-name à chaque navigation pour que le chat sache où se trouve le visiteur. cookie-consent réagit aussi aux changements d'attribut en temps réel.

Si vous laissez le router monter et démonter <humind-widget> à chaque route, le widget fonctionne quand même, mais la conversation en cours est réinitialisée à chaque navigation.

Est-ce que le contenu est indexé pour le SEO ?

Oui, surtout pour la recherche IA, qui est là où ça compte le plus en ecommerce aujourd'hui. Il faut séparer deux cas :

Recherche IA (ChatGPT, Perplexity, Gemini, Google AI Overviews)

Les crawlers IA rendent les pages et voient les widgets Humind sur votre site, y compris les questions produit et la base de connaissances derrière le chat (FAQ, politiques, charte de marque, tout ce que vous uploadez dans le dashboard). Votre contenu catalogue devient visible par les résumeurs IA dans la forme exacte où les acheteurs en parlent. L'effet compose avec le temps à mesure que la part de la recherche IA grandit.

Les logs de chat font aussi office d'outil de recherche de mots-clés : les vraies questions que posent vos visiteurs sont celles que les moteurs IA verront d'autres acheteurs poser. Vous pouvez les réinjecter dans votre stratégie de contenu.

SEO classique (Google, Bing)

Les sorties des widgets sont rendues côté client, donc elles ne remplacent pas le copy produit serveur, les données structurées ni le schema FAQ. Continuez à les écrire vous-même.

Ce que Humind apporte est indirect : les widgets répondent aux questions des visiteurs sur place au lieu de les renvoyer vers la recherche, ce qui améliore généralement le temps passé, le nombre de pages par session et le taux de rebond. Tous des signaux d'engagement pris en compte par les moteurs.

Humind est RGPD-compliant ?

Oui. Humind agit en tant que sous-traitant (data processor) sous un DPA signé avec chaque marchand. Demandez le DPA à jour et la liste des sous-traitants à votre lead d'intégration ou à support@thehumind.com.

Où sont hébergées les données ?

Hébergement par défaut : Azure multi-région (EU + US), avec routage selon la proximité du visiteur. Un hébergement EU-only est disponible sur demande — contactez le support pour le configurer avant la mise en prod.

Est-ce que les conversations sont utilisées pour entraîner l'IA ?

Non. Les conversations marchands, les données catalogue et le contenu de la base de connaissances ne sont jamais utilisés pour entraîner des modèles fondation. Les conversations sont traitées par les providers LLM sous des contrats qui interdisent l'utilisation de vos données pour l'entraînement.

Comment je gère le consentement cookies ?

Passez le statut de consentement du visiteur via l'attribut cookie-consent sur <humind-widget>. L'attribut est réactif : modifiez-le en place et le widget s'adapte (analytics, persistance de session, etc.) sans remount.

Ça s'intègre proprement avec les plateformes de consentement (OneTrust, Didomi, Cookiebot, Axeptio) : abonnez-vous à leur event consent et mirror le résultat sur l'attribut.

Quelles données personnelles Humind collecte ?

Aucune par défaut. Le trafic des widgets est taggué avec des IDs anonymes (x-session-id par session navigateur, x-visitor-id stable à travers les sessions) qui ne contiennent pas de PII. Le contenu du chat peut contenir des infos personnelles si un visiteur en tape. Gérez cela dans votre propre politique de confidentialité.

Le widget peut-il exécuter du JavaScript arbitraire dans mon site ?

Non. Le code du widget est scopé aux custom elements servis depuis embed.thehumind.com et widgets.thehumind.com. Il ne fait pas eval, ne charge pas de scripts distants dynamiquement, et n'exécute pas de contenu soumis par l'utilisateur. Le Shadow DOM (là où il est activé) isole l'accès DOM du site hôte. Pour une revue sécurité formelle, demandez au support les hashes du bundle et un rapport CSP.

Je suis sur Shopify mais mon storefront est headless (Hydrogen, Next.js, Remix). Comment j'installe Humind ?

Vous êtes sur le chemin hybride : backend Shopify + storefront custom. Installez l'app Shopify comme d'habitude pour que les webhooks produits et l'OAuth fonctionnent. Puis embarquez les widgets manuellement dans votre code storefront, comme le ferait un marchand non-Shopify :

<humind-widget
  shop-domain="your-shop.myshopify.com"
  template-name="product"
  integration="shopify"
  product-id="gid://shopify/Product/12345"
></humind-widget>

La clé c'est integration="shopify" et de passer les GIDs Shopify (gid://shopify/Product/..., gid://shopify/Collection/...) depuis votre code storefront au lieu de Liquid. Voir Sync catalogue Shopify → storefront hybride pour le setup complet.

Ça marche avec Google Tag Manager ?

Oui. Chargez le <script> du loader via une balise HTML personnalisée sur « Toutes les pages ». N'injectez pas <humind-widget> lui-même via GTM. Il a sa place dans vos templates de page pour que le routing et les attributs de contexte (template-name, product-id) restent cohérents avec la navigation.

Je peux forwarder les events du widget vers GA4, Segment ou Mixpanel ?

Oui. Écoutez les custom events sur window et forwardez-les vers votre SDK analytics :

window.addEventListener('humind-open-chat', (e) => {
  analytics.track('Chat Opened', e.detail)
})

Events dispatchés sur window :

• humind-open-chat — overlay de chat ouvert (quel que soit le déclencheur).
• humind-continue-thread — le visiteur a repris une conversation précédente.
• humind-quiz-completed — <humind-quiz> a atteint son étape finale.

Event dispatché sur document (intégration Shopify uniquement) :

• cart:updated — émis après que le widget a ajouté un article au panier Shopify. Écoutez avec document.addEventListener('cart:updated', ...), pas window. Le detail transporte le panier mis à jour et les sections rendues optionnelles, suivant la convention cart:updated de Shopify — tout thème qui l'écoute se mettra à jour.

Pour les events de cycle de vie du chat (message envoyé, passation, session terminée), la page Analytics du dashboard est la source aujourd'hui. Les webhooks sont sur la roadmap.

Où je vois les analytics des conversations ?

Dans le dashboard sous Analytics. Volume, topics, déflection, attribution de revenus et top des requêtes visiteurs sont tous là. L'export CSV est disponible. Contactez le support pour un accès programmatique.

Je peux customiser le comportement de l'IA ?

Oui, depuis le dashboard. Vous configurez la voix de marque, le ton, les sujets interdits, et uploadez une base de connaissances (FAQ, politiques, guides de taille, tout ce sur quoi vous voulez que l'IA se base). L'IA n'invente pas de produits ou de faits. Les réponses sont grounded sur votre catalogue et votre base de connaissances.