Changelog

Historique des versions des surfaces publiques Humind : bundle widgets, loader chat et ce site de documentation.

Les fonctionnalités produit et les changements côté merchant dans le backend et le dashboard sont suivis dans le panneau What's New du dashboard ; cette page ne couvre que les surfaces d'embed publiques.

Bundle widgets (widgets.thehumind.com/v1/loader.js)

v1 (actuelle), avril 2026

Première release publique du bundle widgets unifié. Remplace l'ancien host quiz.thehumind.com (qui ne servait que le quiz de collection) par un bundle pour trois custom elements.

Custom elements :

• <humind-quiz> : quiz de découverte de collection
• <humind-gift-finder> : bloc de recherche « demande ce que vous voulez »
• <humind-product-questions> : Q&A sur page produit

Changement cassant depuis quiz.thehumind.com : l'URL du bundle a changé de https://quiz.thehumind.com/humind-quiz.js à https://widgets.thehumind.com/v1/loader.js. Le préfixe /v1/ est nouveau et restera dans l'URL. Updatez tous les blocs theme ou script tags qui référencent encore l'ancien host.

Futur : v2 (prévu)

Une version avec changements cassants sortira sous /v2/. /v1/ reste vivant pendant la fenêtre de migration. Abonnez-vous au changelog Humind dans le dashboard pour les notices en avance.

Loader chat (embed.thehumind.com/loader.js)

Le loader chat n'est pas versionné. Chaque déploiement remplace le bundle. Les changements significatifs en attributs, évènements ou comportement sont enregistrés ici.

Avril 2026

• Isolation Shadow DOM pour tous les styles widget.
• Internationalisation pour 11 langues.
• Passation opérateur live basée sur WebSocket.

Documentation

2026-08-31 : Deux réglages d'URL catalogue retirés

• Les clés de réglage catalog.add_params_to_product_url et catalog.product_url_params sont retirées de l'endpoint Settings. Elles n'étaient jamais appliquées par l'assistant et aucune boutique ne les avait activées. Les envoyer renvoie désormais une erreur validation_failed, comme toute clé inconnue.
• La capacité qu'elles décrivaient vit maintenant dans les règles produit du dashboard (Réglages, Catalogue, Règles produit) : l'effet « Ajouter des paramètres à l'URL » ajoute une query string définie par le marchand à chaque URL produit ouverte par l'assistant, par périmètre de règle plutôt que pour toute la boutique.

2026-08-28 : Texte de consentement cookies personnalisable

• Nouveau setting cookie_consent.custom_text (agent, string, max 500 caractères, nullable) sur l'endpoint Settings : le message de consentement rédigé par le marchand, affiché dans le widget à la place du texte traduit par défaut. null restaure le texte par défaut ; la chaîne vide est rejetée.
• Les variantes par langue du message se gèrent depuis le dashboard et ne sont pas exposées via l'API publique des settings.

2026-08-28 : Les références metaobject Shopify résolues en libellés lisibles

• Pour les boutiques connectées à Shopify, les métachamps produit de type metaobject_reference et list.metaobject_reference portent désormais dans value le nom d'affichage du metaobject référencé, au lieu d'un identifiant opaque gid://shopify/Metaobject/..., dès que le marchand a accordé le scope additif read_metaobjects. La valeur résolue garde la forme du type texte équivalent : une chaîne simple pour une référence unique, une chaîne JSON de tableau pour les listes. Le déploiement est progressif : les boutiques non reconnectées conservent les identifiants bruts.
• Aucun changement de schéma : metafields[].value reste une chaîne, et le champ type est inchangé. Si votre intégration détectait le préfixe gid:// dans les valeurs de métachamps, considérez les libellés résolus comme la nouvelle forme normale.

2026-08-19 : Les endpoints webhook renvoient un prefix masqué et plus de checksum

• Sur GET /webhooks/endpoints, GET /webhooks/endpoints/:id, PATCH et le bloc endpoint de POST /rotate-secret, le champ prefix est désormais masqué (whsec_ + les 4 premiers et 4 derniers caractères de la partie secrète, par exemple whsec_5f9e••••••••3f0c) et le champ checksum n'est plus renvoyé. Les deux valeurs brutes réunies permettaient de reconstruire le secret de signature complet, ce qui contredisait la garantie « affiché une seule fois ». POST /webhooks/endpoints et POST /rotate-secret renvoient toujours le secret complet au premier niveau, une seule fois. Si votre intégration comparait prefix aux premiers caractères de votre secret stocké, comparez plutôt les 4 + 4 caractères visibles. Documenté dans la référence webhooks.

2026-08-19 : Les imports ignorent les lignes inchangées, et l'enrichissement IA suit l'import

• Sur POST /imports (et le flux produit), une ligne identique au dernier import de ce produit n'est plus réécrite : elle compte dans report.updated mais ne coûte rien. Les produits créés ou modifiés par un import reçoivent leur enrichissement IA (embedding de recherche, questions générées) d'un job en arrière-plan lancé quand l'import atteint done ; un produit peut donc mettre quelques minutes après l'import avant que l'assistant le recommande. Les deux points sont documentés dans la référence imports (report.updated, Enrichissement après l'import).

2026-08-18 : website_visits et interaction_rate sur les longues périodes viennent d'un agrégat quotidien

• Sur GET /analytics/kpis (et l'outil MCP get_kpis), website_visits et interaction_rate ne changent pas jusqu'à 90_days : visiteurs distincts sur toute la fenêtre, tendance comprise. Pour year, total et les plages personnalisées qui remontent à plus de 180 jours, ces deux KPI et leur tendance sont désormais sommés à partir d'un agrégat quotidien, où un visiteur revenu plusieurs jours compte une fois par jour. Les valeurs sur ces périodes sont légèrement plus élevées qu'avant ; sessions et conversations ne sont pas concernées. Documenté dans la référence analytics.

2026-08-17 : cart_url ajoute un bouton « Aller au paiement » aux confirmations function

• Nouveau champ optionnel cart_url sur les cart actions function : votre page panier ou paiement. S'il est renseigné, le toast de confirmation que le widget affiche après un ajout réussi propose un bouton « Aller au paiement » qui l'ouvre, le même raccourci que les marchands Shopify, PrestaShop et WooCommerce ont déjà. S'il est absent, rien ne change : le toast continue de masquer le bouton, puisque le widget n'a pas de panier à lui à ouvrir sur une boutique custom. Les lectures renvoient le champ. Le guide add to cart le montre dans l'exemple.

2026-08-15 : errorName décide de ce qui est dit au visiteur

• Un ajout au panier en échec était jusqu'ici silencieux : le bouton revenait simplement à la normale, quelle qu'en soit la raison. Le widget affiche désormais un message traduit dans ses 11 langues, et c'est l'errorName que retourne votre cart action function qui le choisit. Dix noms sont reconnus, listés dans le guide. Rien n'est exigé de vous : errorName reste optionnel, et un nom que nous ne reconnaissons pas produit un message générique plutôt qu'une erreur.
• selection_required n'est pas un message, c'est une redirection. Retournez-le quand le visiteur doit d'abord choisir quelque chose, et le widget l'envoie vers votre product_url au lieu de lui montrer une impasse.
• Vaut pour toutes les plateformes, pas seulement les actions function : les échecs Shopify, PrestaShop et WooCommerce sont ramenés aux mêmes noms et reçoivent les mêmes messages.

2026-08-14 : les cart actions redirect déclarent leur destination avec target

• Nouveau champ optionnel target sur les cart actions redirect, avec deux valeurs : product_page (url est une fiche produit, le CTA affiche « Voir le produit » et y mène directement) et add_to_cart (url est un lien profond qui remplit le panier, le CTA affiche « Ajouter au panier »). Les deux destinations ont toujours été supportées et le widget ne pouvait pas les distinguer, d'où le CTA « Voir le produit » sur tous les redirect depuis le 13 août. Il suit désormais ce que vous déclarez.
• Un target absent vaut add_to_cart. Si votre redirect pointe vers une fiche produit, posez "target": "product_page" sur ces variantes : sinon le bouton affiche « Ajouter au panier » et dépose l'acheteur sur votre page sans rien avoir ajouté. Le défaut penche de ce côté volontairement, car l'erreur inverse est un bouton « Voir le produit » qui remplit le panier en silence. Les marchands qui utilisent un lien profond d'ajout au panier n'ont rien à faire, et cela remplace aussi le conseil précédent de basculer sur une action function juste pour obtenir un libellé « Ajouter au panier ».
• Les lectures renvoient le champ : un GET sur un produit retourne target quand il est stocké. Les plateformes natives (shopify, prestashop, woocommerce) et les actions function ne sont pas concernées.

2026-08-13 : les cart actions redirect affichent un CTA « Voir le produit »

• Une variante dont la cart action est redirect n'ajoute rien depuis la conversation : elle envoie le visiteur vers une URL. Le widget le dit désormais, avec un CTA « Voir le produit » au lieu d'« Ajouter au panier », qui mène directement à cette URL. Les produits dont toutes les variantes utilisent redirect n'ouvrent plus le sélecteur de variantes au préalable : le visiteur choisit sa variante sur votre propre fiche produit. Les marchands dont le redirect pointe vers un lien profond d'ajout au panier fonctionnent exactement comme avant, mais leur CTA affiche lui aussi « Voir le produit », le widget ne pouvant pas distinguer les deux destinations ; utilisez une action function si vous voulez que le bouton promette un ajout au panier. Les plateformes natives (shopify, prestashop, woocommerce) et les actions function sont inchangées.

2026-08-11 : Toast de confirmation du widget pour les cart actions function

• Lors d'un ajout au panier function réussi, le widget affiche désormais son propre toast de confirmation dans la conversation (image du produit, titre et quantité, sans le raccourci vers le paiement). Les fonctions marchandes ne doivent plus afficher leur propre modale de confirmation : la fenêtre de chat se place au-dessus de la page (plein écran sur mobile), une confirmation au niveau de la page serait donc masquée derrière elle. Le guide Ajout au panier reflète le nouveau contrat. Le comportement en cas d'échec et le repli restent inchangés.

2026-08-11 : Suppression du réglage widget.show_add_to_cart_button

• Le réglage widget.show_add_to_cart_button a été retiré de l'API Settings. L'affichage du bouton d'ajout au panier est désormais décidé uniquement par produit et par variante (disponibilité et action panier) : le widget montre le bouton dès que le produit peut réellement être ajouté au panier. Les requêtes qui écrivent cette clé échouent maintenant avec une erreur 400 validation_failed ; retirez-la de tout envoi automatisé de réglages. Les valeurs déjà stockées sont ignorées.

2026-08-10 : Metafields traduisibles, produits liés, API de configuration des metafields

• Les metafields sont désormais traduisibles : l'API Produits accepte un tableau metafields dans chaque entrée translations.<lang> (et sur la sub-resource translations). Une entrée traduite remplace la valeur du metafield de base qui porte les mêmes namespace et key quand l'assistant sert le produit dans cette langue.
• Nouveaux champs produit related_products et complementary_products : des recommandations choisies par le marchand, référencées par external_id, avec la même sémantique que Shopify Search & Discovery. L'assistant les résout et suggère proactivement les produits complémentaires en cross-sell. Pour les marchands Shopify, les recommandations configurées dans l'app Search & Discovery sont désormais importées automatiquement.
• Nouveaux endpoints de configuration des metafields : GET /settings/metafields liste chaque metafield détecté sur votre catalogue avec sa configuration, PUT /settings/metafields active les champs pour l'IA, les filtres de recherche et l'affichage. Les intégrations peuvent désormais pousser la donnée et l'activer dans un seul pipeline automatisé, sans étape dans le dashboard.
• La doc dit maintenant explicitement que les metafields de variante sont stockés mais pas lus par l'assistant : poussez les données utiles à l'IA au niveau produit.
• Le guide catalogue custom est désormais un parcours d'intégration complet : pousser, activer, connaissance, fraîcheur.

2026-08-03 : Guide Ajout au panier, cart action function, référence cart action complète

• Nouveau type de cart action function dans l'API Produits : le widget appelle une fonction JavaScript de quick-buy que votre boutique expose sur window (par exemple injectée via votre tag manager), avec repli automatique vers une redirection fiche produit quand la fonction est absente. Permet aux boutiques custom d'ajouter au panier sans quitter la conversation.
• Nouveau guide Ajout au panier : comment fonctionne l'ajout au panier du widget sur Shopify, PrestaShop, WooCommerce, et les trois options pour les boutiques custom (function, redirect, noop), avec le contrat function côté marchand.
• La référence cart action documente maintenant le contrat complet : les types natifs shopify et woocommerce (déjà acceptés par l'API) rejoignent redirect, noop et prestashop, et le tip d'auto-dérivation couvre les trois plateformes natives.
• La spec OpenAPI intègre le nouveau schéma PublicCartActionFunction.

2026-07-29 : Settings de personnalisation des blocs du widget

• Cinq nouvelles clés dans l'API Settings et le tool MCP update_settings : widget.home_greeting, widget.show_sparkle_icon, widget.sparkle_icon_url, widget.show_gift_finder_image, plus un contrat clarifié pour widget.home_title.
• Les textes de l'écran d'accueil (widget.home_title, widget.home_greeting) sont désormais nullables : null restaure le défaut traduit intégré, une chaîne vide masque entièrement la ligne dans le widget.
• widget.show_sparkle_icon active ou désactive l'icône étoiles dans les bulles de chat et les suggestions de questions ; widget.sparkle_icon_url la remplace par votre propre icône hébergée.
• widget.show_gift_finder_image masque le bloc image de l'en-tête du widget chercheur de cadeaux (titre et sous-titre seulement).

2026-07-28 : Serveur MCP marchand, API settings & analytics

• Humind est maintenant un serveur MCP : connectez Claude ou tout agent compatible MCP à votre boutique sur https://api.thehumind.com/public/mcp, avec votre clé API existante. 17 tools dont la disponibilité s'adapte aux scopes de la clé.
• get_store_overview renvoie des compteurs en direct (produits, documents de connaissance, conversations), la dernière sync catalogue terminée, et si le widget est installé sur le site. Le tool get_setup_status en fait une checklist d'onboarding, avec une action suggérée (y compris le tool MCP qui peut la compléter) pour chaque étape restante.
• Tools MCP search_docs et get_doc_page : tout agent connecté peut chercher et lire cette documentation directement via le serveur MCP, en anglais ou en français. Les sources markdown brutes sont aussi publiées sous /raw/ avec un index llms.txt.
• La page MCP documente les formes d'arguments faciles à deviner de travers (upsert_knowledge, delete_knowledge, get_kpis, get_top_questions).
• Nouvelle API Settings : lecture et modification d'environ 50 paramètres marchands (apparence du widget, comportement IA, modération, CSAT, limites, quiz, tracking, catalogue, localisation) avec un endpoint de schéma machine-readable.
• Nouvelle API Analytics : KPIs du dashboard et top questions clusterisées via l'API.
• Conversations : recherche libre (q) et nouveaux filtres (langues, points d'entrée, CSAT, nombre de messages, tags), plus de nouveaux champs de réponse (csat, entry_point, summary, message_count, indicateurs de tickets).
• Trois nouveaux scopes de clé API : settings:read, settings:write, analytics:read ; le tableau des scopes est désormais complet (il manquait imports:write et webhooks:manage).

2026-07-28 : Blocs de thème Shopify pour le quiz de collection

• Nouveau bloc de thème Bouton Quiz Collection : un bouton personnalisable qui ouvre le quiz en plein écran, pour les marchands qui ont leur propre page dédiée au quiz. La recommandation est présentée dans l'assistant de chat.
• Le bloc en ligne Quiz Collection fonctionne désormais sur n'importe quel template, plus seulement les pages collection. Les deux blocs résolvent automatiquement la collection courante sur les pages collection et exposent un sélecteur de collection partout ailleurs.
• Les titres des blocs sont désormais traduits dans l'éditeur de thème, alignés sur les libellés du dashboard.
• Le quiz plein écran est documenté pour les intégrations custom : un exemple bouton + surcouche à copier-coller, plus les attributs display-mode et page-image-url et les événements page-back et results-in-chat.
• Guide d'installation du quiz de collection mis à jour en conséquence.

2026-07-28 : Section protection des données

• Nouvelle référence Conservation et suppression des données : durées de conservation côté serveur, purge automatique, suppression en fin de contrat et effacement individuel.
• Nouvelle référence Gestion des incidents et violations de données personnelles : niveaux de gravité, notification des marchands sous 72 heures et répartition des rôles RGPD.
• Stockage navigateur mis à jour : durée de vie définie pour chaque élément stocké, et mesure d'usage anonyme ne nécessitant aucun consentement.

2026-07-25 : SSO et confidentialité

• Nouveau guide Microsoft Entra SSO & SCIM : configuration du single sign-on, provisioning des utilisateurs via SCIM et isolation des tenants.
• Nouvelle référence Stockage navigateur : inventaire complet et exact de ce que le widget chat stocke dans le navigateur du visiteur.
• Documentation de l'analytics sans cookies pour les visiteurs européens.

2026-07-22 : API publique : modélisation du catalogue

• Nouvelle référence API Groupes de produits.
• Documentation des metafields produit sur l'API catalogue.
• Documentation de la gestion des produits désindexés (unlisted).

2026-07-10 : Intégration analytics

• Nouveau guide Analytics : miroir des évènements du widget vers GA4 via le dataLayer GTM.
• Documentation de l'attribut product-id du widget chat sur les pages produit.

2026-06-09 : API publique : conversations

• Nouvelle référence de l'endpoint Conversations, avec le flux d'authentification associé.

2026-05-25 : Section Agent IA

• Nouvelle section Agent IA : instructions, base de connaissances, snippets produit et snippets partagés.
• Docs françaises synchronisées avec toutes les mises à jour anglaises récentes.

2026-04-27 : Référence API catalogue publique

• Publication de la référence API complète (EN + FR) : produits, collections, connaissances, imports, webhooks, erreurs et rate limits, auditée contre le comportement réel du backend.
• Ajout d'un bouton « Copy page » pour l'export des pages au format IA.
• Réorganisation de la page d'accueil et de l'index de la référence API.

2026-04-24

Guides d'installation alignés sur le runtime widgets ; ajout de tables de décision Shopify/hybride/custom sur chaque page d'installation ; docs catalogue et dépannage enrichies.

2026-04-21

Lancement initial de ce site, avec une couverture pour :

• Démarrage (Shopify + générique)
• Installation et évènements du widget chat
• Les trois widgets du bundle
• Synchro catalogue (webhooks Shopify + REST custom)
• Thème et i18n
• Dépannage