Qu'est-ce que Humind
Humind est un assistant IA de shopping qui vient se poser par-dessus ton storefront e-commerce. Il répond aux questions sur tes produits, guide les shoppers dans des quiz de découverte et passe la main à un opérateur humain quand il faut.
Cette page est un tour produit. Si tu sais déjà ce que Humind fait et que tu veux intégrer directement, saute au démarrage Shopify ou au démarrage générique.
Deux surfaces
Humind s'embarque par deux surfaces indépendantes. Tu peux les utiliser ensemble ou séparément.
Overlay de chat
Un panneau de chat pleine hauteur qui slide par-dessus ton storefront. Ouvert à la demande par le shopper (bouton flottant) ou programmatiquement par ta page (via un custom event). Servi depuis embed.thehumind.com sous la forme d'un seul web component <humind-widget>.
À utiliser quand tu veux un assistant IA conversationnel capable de répondre à des questions ouvertes, recommander des produits et passer la main à un opérateur live.
Bundle widgets
Trois custom tags Angular Elements que tu déposes dans la page comme n'importe quel tag HTML. Servis ensemble dans un seul fichier JavaScript à widgets.thehumind.com/v1/humind-widgets.js :
<humind-quiz>— un quiz de découverte multi-étapes pour une collection.<humind-gift-finder>— un bloc de recherche « demande ce que tu veux » (layout default ou bannière).<humind-product-questions>— Q&A préconfigurées sur une page produit.
Chaque widget a sa propre API et son UI. Ils partagent l'overlay de chat : cliquer sur une chip de question dans n'importe quel widget dispatche un event humind-open-chat, que l'overlay (si installé) récupère pour ouvrir un thread.
Synchro catalogue
Humind a besoin de ton catalogue produits pour pouvoir recommander quoi que ce soit. Deux chemins :
- Shopify — installe l'app Humind depuis l'App Store. Produits, collections et locale shop transitent par webhooks. Tu ne fais rien.
- Toute autre plateforme — push tes produits vers l'API REST Humind. Voir Intégration catalogue custom pour la forme JSON et l'endpoint.
Contenu du site
| Section | Pour |
|---|---|
| Démarrage | La vue d'ensemble que tu lis. |
| Widget chat | Installer et configurer l'overlay de chat. |
| Widgets | Les trois widgets storefront, leurs attributs et leurs évènements. |
| Synchro catalogue | Webhooks Shopify et API REST custom. |
| Personnalisation | Couleurs, libellés, langues. |
| Référence | Dépannage, changelog et questions ouvertes. |
Endpoints de production
| Service | URL |
|---|---|
| Loader chat | https://embed.thehumind.com/loader.js |
| Bundle widgets | https://widgets.thehumind.com/v1/humind-widgets.js |
| API | https://api.thehumind.com |
| Dashboard marchand | https://app.thehumind.com |
Les hosts preprod reprennent la même structure sous *.preprod.thehumind.com.
Versioning
Le bundle widgets est servi sous le préfixe de chemin /v1/. Quand un changement cassant sort, il passe en /v2/ et /v1/ reste vivant pendant la fenêtre de migration. Le loader chat n'est pas versionné et sert toujours le dernier build.