> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scentxp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

## AI-powered fragrance assistant

ScentBot is a conversational widget that helps customers discover and choose fragrances through natural language. It embeds directly into your website as a web component — no app install, no complex setup.

Powered by WikiParfum's database of 31,000+ perfumes, ScentBot understands preferences, recommends products from your catalog, and adapts to your brand's tone and visual identity.

### What ScentBot does

* **Conversational discovery** — customers describe what they want in their own words and get personalized recommendations
* **Image-based search** — users upload a photo of an outfit or look, and ScentBot suggests fragrances that match the style
* **Catalog-scoped results** — recommendations are limited to products in your [Product Feed](/catalog-integration/product-feed)
* **Multi-language** — supports 25+ languages with automatic content localization
* **Session persistence** — conversation history is preserved across page navigations

### Prerequisites

Before integrating ScentBot, you need:

| Requirement        | Description                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------- |
| **Public API key** | Supplied by ScentXP for each environment (development, staging, production)               |
| **Allowed origin** | Your domain must be registered with ScentXP to authorize widget requests                  |
| **Product Feed**   | A [Product Feed](/catalog-integration/product-feed) connecting your catalog to WikiParfum |

<Note>
  Contact your ScentXP account manager to obtain your API key and register your domain.
</Note>

### Quick start

Add ScentBot to any page in three steps:

<Steps>
  <Step title="Load the widget script">
    Add the ScentBot runtime to your page:

    ```html theme={null}
    <script src="https://scentbot.widgets.scentxp.net/index.iife.js" type="application/javascript"></script>
    ```
  </Step>

  <Step title="Load fonts">
    ScentBot uses Graphik and Dover Serif by default. Include the font-face declarations in your CSS or `<style>` tag. See [Installation](/scentbot/installation) for the full font setup.
  </Step>

  <Step title="Add the widget">
    Insert the widget tag with your API key:

    ```html theme={null}
    <scentbot-widget
      public-key="your_public_key"
      language="en"
    ></scentbot-widget>
    ```
  </Step>
</Steps>

That's it. ScentBot appears as a floating chat button on your page.

## Next steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/scentbot/installation">
    Full setup instructions — script loading, fonts, and widget markup.
  </Card>

  <Card title="Configuration" icon="gear" href="/scentbot/configuration">
    All widget attributes — positioning, notifications, metadata, and more.
  </Card>

  <Card title="Events" icon="bolt" href="/scentbot/events">
    Custom events for cart integration and programmatic control.
  </Card>

  <Card title="Capabilities" icon="wand-magic-sparkles" href="/scentbot/capabilities">
    Search types, image search, multi-language, and session persistence.
  </Card>
</CardGroup>