Getting started
Get your AI shopping assistant live on your store in under 5 minutes.
Create your account
Go to /register and sign up with your store email. You'll get a free account with 100 messages/month to start.
Add your product catalog
Navigate to Products in the dashboard sidebar. Enter your product API endpoint URL and click Sync now. We'll import your entire catalog.
name, price, and description. See the Products & sync section for the full schema.Configure your store
Go to Settings and set your store name, bot tone (friendly, professional, casual, or enthusiastic), default language, and currency. Optionally add store info like hours, policies, and FAQs.
Test in the Playground
Open Playground from the sidebar to chat with your AI assistant before going live. Try searching for products, asking about categories, and placing a test order.
Embed the widget
Go to Embed, customize the widget appearance, copy the embed code, and paste it before the </body> tag on your site. Done.
Dashboard overview
Your dashboard is the command center for your AI assistant. Here's what each section does:
Overview
At-a-glance stats — messages this month, active sessions, synced products, CSAT score, pending orders, and missed searches. Plus an onboarding checklist for new accounts.
Products
Connect your product API, trigger syncs, and browse your imported catalog with pagination.
Orders
View and manage orders created through the chat. Filter by status, search by order number or email, and update order states.
Conversations
Browse every chat session. See the full thread including tool calls, and check shopper feedback ratings.
Insights
Conversion funnel, zero-result searches (products shoppers asked for but you don't have), and captured leads.
Playground
A built-in chat interface to test your bot without embedding it anywhere.
Settings
Store profile, bot personality, language, currency, store info (hours, policies, FAQs), and custom system prompts.
Embed
Your API key, widget customization controls, and the copy-paste embed snippet.
Billing
Current plan, usage meter, and upgrade options.
Products & sync
The AI assistant searches your product catalog to answer shopper questions. To populate it, you provide a product API endpoint that returns JSON.
Setting up your endpoint
In Products, paste the full URL of your product feed. This can be:
- A REST API endpoint (e.g.
https://mystore.com/api/products) - A static JSON file hosted anywhere
- A Shopify/WooCommerce product export URL
Expected product schema
Your endpoint should return a JSON array. Each product object should include:
[
{
"externalId": "SKU-001", // unique ID from your system
"name": "AquaRun Trail", // product name (required)
"description": "Waterproof hiking sneaker with Vibram outsole",
"price": 69.99, // numeric price (required)
"currency": "USD", // ISO currency code
"category": "Shoes", // category name
"imageUrl": "https://...", // product image
"productUrl": "https://...", // link to product page
"tags": ["waterproof", "hiking", "new"],
"inStock": true
}
]name and price are required. The more fields you provide, the smarter the AI's search and recommendations will be.Automatic sync
Products sync automatically every 4 hours. You can also trigger a manual sync from the Products page by clicking Sync now. The sync status (pending, success, failed) is shown on the page.
Store settings
Configure how the AI assistant behaves and what it knows about your store.
Bot personality
| tone | One of: friendly, professional, casual, enthusiastic. Controls the assistant's conversational style. |
| language | Default language (e.g. English, Spanish). The AI auto-detects the shopper's language and switches automatically. |
| currency | Display currency for prices (e.g. USD, EUR, BDT). |
Store information
Add details the AI can reference when shoppers ask about your store:
- About text — what your store does, story, values
- Business hours — when you're open
- Address & contact — physical location, phone, email
- Shipping policy — delivery times, costs, methods
- Return policy — return window, conditions, process
- FAQs — add question/answer pairs the AI can quote directly
Custom system prompt
For advanced users: add a custom system prompt override that appends to the default instructions. Use this to add store-specific rules like "always recommend our loyalty program" or "never compare our prices to competitors."
Widget integration
Embed the chat widget on any website with a single script tag.
Basic installation
Go to Embed in the dashboard, customize the widget, then copy the generated code. Paste it before </body> on every page:
<script>
window.SellMateConfig = {
apiKey: "your-api-key-here",
position: "bottom-right",
primaryColor: "#E54B33",
welcomeMessage: "Hi! Ask me anything about our products",
};
</script>
<script src="https://yourdomain.com/widget.min.js" async></script>Platform-specific guides
Shopify
Go to Online Store → Themes → Edit code. Open theme.liquid and paste the embed code before </body>.
WooCommerce / WordPress
Go to Appearance → Theme Editor. Open footer.php and paste the code before </body>. Alternatively, use a "Header & Footer Scripts" plugin.
Custom / Static site
Paste the embed code in your main HTML layout file, right before the closing </body> tag.
React / Next.js / SPA
Add a <script> tag to your index.html, or dynamically inject it in a useEffect on your root layout component.
Configuration options
All configuration is set via the window.SellMateConfig object before loading the widget script.
| Property | Type | Default | Description |
|---|---|---|---|
| apiKey | string | required | Your unique API key from the Embed page. |
| position | string | "bottom-right" | "bottom-right" or "bottom-left" — where the chat bubble appears. |
| primaryColor | string | "#6366f1" | Hex color for the bubble, header, and user messages. |
| welcomeMessage | string | "Hi! Ask me anything..." | First message shown when the widget opens. |
| suggestedQuestions | string[] | ["Show me best sellers", ...] | Clickable suggestion chips shown below the welcome message. |
| proactiveDelay | number | 0 | Seconds before auto-opening the widget. 0 = disabled. |
| proactiveOnExitIntent | boolean | false | Open the widget when the visitor moves their mouse toward the browser tab bar. |
| theme | string | "light" | "light" or "dark" — widget color scheme. |
| backendUrl | string | auto | Override the API endpoint URL. Only needed for self-hosted setups. |
Full example
<script>
window.SellMateConfig = {
apiKey: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
position: "bottom-right",
primaryColor: "#1F6F62",
welcomeMessage: "Welcome to our store! How can I help?",
suggestedQuestions: [
"What's new this week?",
"Do you have running shoes?",
"What's your return policy?"
],
proactiveDelay: 10,
proactiveOnExitIntent: true,
theme: "light"
};
</script>
<script src="https://yourdomain.com/widget.min.js" async></script>Orders
When a shopper decides to buy through the chat, the AI collects their details (name, email, address) and creates an order. All orders appear in the Orders section.
Order lifecycle
You can transition orders between statuses from the order detail view. The AI can also look up order status for shoppers when they provide their order number.
Order lookup endpoint (optional)
If you have your own order system, configure an Order lookup endpoint in Settings. When a shopper asks about their order, the AI will call your endpoint to fetch real-time status instead of using the built-in order database.
Export
Export orders as CSV from the Orders page. Filter by status and date range before exporting.
Conversations
Every chat session is logged and viewable in Conversations. Use this to:
- Review what shoppers are asking about
- See which AI tools were called (product search, price filter, etc.)
- Check shopper feedback (thumbs up/down on each bot reply)
- Identify common questions to add to your FAQs
- Spot issues where the AI gave incorrect or incomplete answers
Analytics & insights
The Overview and Insights pages give you visibility into how your AI assistant is performing.
Overview metrics
| Messages this month | Total messages across all sessions, shown as % of your plan limit. |
| Active sessions today | Number of unique chat sessions started today. |
| Synced products | Total products in your catalog. |
| Shopper feedback | CSAT score — percentage of thumbs-up ratings out of all feedback. |
| Pending orders | Orders in "pending" status awaiting confirmation. |
| Missed searches | Queries where the AI found zero results — signals products to add. |
Conversion funnel
The funnel in Insights tracks four stages:
Zero-result searches
When a shopper asks for something and the AI finds no matching products, it's logged. These are your biggest opportunities — they tell you exactly what shoppers want but you don't carry. The AI also offers to capture the shopper's email so you can notify them when the product becomes available.
Lead capture
Emails collected from zero-result prompts appear in the Insights page. Each lead includes what the shopper was searching for and when they left their email.
Billing & plans
| Plan | Messages | Price |
|---|---|---|
| Free | 100/month | $0 |
| Pro | 5,000/month | $29/month |
| Business | Unlimited | $99/month |
Upgrade from the Billing page. Payments are handled securely through Stripe. You can manage your subscription, update payment methods, and download invoices from the Stripe billing portal.
FAQ
What happens when I hit my message limit?
The widget will show a friendly message saying the assistant is temporarily unavailable. No data is lost — sessions resume when the limit resets next month or you upgrade.
Can I use the widget on multiple websites?
Yes. The same API key works on any site. All conversations and orders flow into the same dashboard.
Does the widget slow down my site?
No. The widget script loads asynchronously and weighs under 50KB. It renders in a Shadow DOM so it doesn't affect your page's CSS or JavaScript.
What AI model powers the assistant?
We use Google Gemini (gemini-2.5-flash) with real-time function calling. The AI can search products, filter by price, find categories, look up orders, and more — all through tool calls, not hardcoded logic.
Can I customize what the AI says?
Yes. Set the tone, language, and currency in Settings. For fine-grained control, use the custom system prompt override to add store-specific rules and instructions.
How do I remove the widget?
Delete the embed code from your site. If you want to keep the account but pause the widget, you can regenerate the API key to invalidate the old one.
Is my data secure?
Every store's data is isolated by storeId — no cross-store data leaks. API keys authenticate widget requests, JWTs protect the dashboard, and internal services use shared secrets.