Documentation Topics

Getting started

Get your AI shopping assistant live on your store in under 5 minutes.

1

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.

2

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.

Note: Your endpoint should return a JSON array of products. Each product needs at least name, price, and description. See the Products & sync section for the full schema.
3

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.

4

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.

5

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
  }
]
Tip: Only 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

toneOne of: friendly, professional, casual, enthusiastic. Controls the assistant's conversational style.
languageDefault language (e.g. English, Spanish). The AI auto-detects the shopper's language and switches automatically.
currencyDisplay 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
Important: If a shopper asks about something you haven't configured (e.g. shipping policy), the AI will honestly say it doesn't have that information rather than guessing.

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.

Note: The widget uses Shadow DOM for complete CSS isolation. It won't conflict with your site's styles, and your styles won't leak into the widget.

Configuration options

All configuration is set via the window.SellMateConfig object before loading the widget script.

PropertyTypeDefaultDescription
apiKeystringrequiredYour unique API key from the Embed page.
positionstring"bottom-right""bottom-right" or "bottom-left" — where the chat bubble appears.
primaryColorstring"#6366f1"Hex color for the bubble, header, and user messages.
welcomeMessagestring"Hi! Ask me anything..."First message shown when the widget opens.
suggestedQuestionsstring[]["Show me best sellers", ...]Clickable suggestion chips shown below the welcome message.
proactiveDelaynumber0Seconds before auto-opening the widget. 0 = disabled.
proactiveOnExitIntentbooleanfalseOpen the widget when the visitor moves their mouse toward the browser tab bar.
themestring"light""light" or "dark" — widget color scheme.
backendUrlstringautoOverride 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

PendingConfirmedShippedDeliveredCancelled

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
Tip: Sessions expire after 30 minutes of inactivity. A returning shopper within that window continues the same conversation with full context.

Analytics & insights

The Overview and Insights pages give you visibility into how your AI assistant is performing.

Overview metrics

Messages this monthTotal messages across all sessions, shown as % of your plan limit.
Active sessions todayNumber of unique chat sessions started today.
Synced productsTotal products in your catalog.
Shopper feedbackCSAT score — percentage of thumbs-up ratings out of all feedback.
Pending ordersOrders in "pending" status awaiting confirmation.
Missed searchesQueries where the AI found zero results — signals products to add.

Conversion funnel

The funnel in Insights tracks four stages:

Widget openedProducts viewedOrder startedOrder completed

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

PlanMessagesPrice
Free100/month$0
Pro5,000/month$29/month
BusinessUnlimited$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.

Note: Messages are counted per user message sent to the AI. Tool calls and system messages don't count toward your limit.

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.