What is Humind
Humind is an AI shopping assistant that sits on top of your e-commerce storefront. It answers questions about your products, guides shoppers through discovery quizzes, and escalates to a human operator when needed.
This page is a product tour. If you already know what Humind does and want to integrate, jump straight to the Shopify quickstart or the generic quickstart.
Two surfaces
You embed Humind through two independent surfaces. They can be used together or separately.
Chat overlay
A full-height chat panel that slides in over your storefront. Opened on demand by the shopper (floating button) or programmatically by your page (via a custom event). Served from embed.thehumind.com as a single <humind-widget> web component.
Use it when you want a conversational AI assistant that can answer free-form questions, recommend products, and hand off to a live operator.
Widgets bundle
Three Angular-Element custom tags that you drop into the page like any other HTML tag. Served together in one JavaScript file at widgets.thehumind.com/v1/humind-widgets.js:
<humind-quiz>— a multi-step discovery quiz for a collection.<humind-gift-finder>— an "ask anything" search block (default or banner layout).<humind-product-questions>— preset Q&A on a product page.
Each widget has its own API and UI. They share the chat overlay: clicking a question chip inside any widget dispatches a humind-open-chat event, which the chat overlay (if installed) picks up and opens a thread.
Catalog sync
Humind needs your product catalog to recommend anything. Two paths:
- Shopify — install the Humind app from the App Store. Products, collections, and shop locale flow through webhooks. You do nothing.
- Any other platform — push products to the Humind REST API. See Custom catalog integration for the JSON shape and endpoint.
What's inside this site
| Section | For |
|---|---|
| Getting started | The overview you're reading. |
| Chat widget | Installing and configuring the chat overlay. |
| Widgets | The three storefront widgets, their attributes, and events. |
| Catalog sync | Shopify webhooks and the custom REST API. |
| Customization | Colors, labels, languages. |
| Reference | Troubleshooting, changelog, and open questions. |
Production endpoints
| Service | URL |
|---|---|
| Chat loader | https://embed.thehumind.com/loader.js |
| Widgets bundle | https://widgets.thehumind.com/v1/humind-widgets.js |
| API | https://api.thehumind.com |
| Merchant dashboard | https://app.thehumind.com |
Preprod hosts mirror the layout under *.preprod.thehumind.com.
Versioning
The widgets bundle is served under a /v1/ path prefix. When a breaking change ships, it will move to /v2/ and /v1/ will stay live during the migration window. The chat loader is unversioned and always serves the latest build.