Skip to main content

​
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
  • Multi-language — supports 25+ languages with automatic content localization
  • Session persistence — conversation history is preserved across page navigations

​
Prerequisites

Before integrating ScentBot, you need:
RequirementDescription
Public API keySupplied by ScentXP for each environment (development, staging, production)
Allowed originYour domain must be registered with ScentXP to authorize widget requests
Product FeedA Product Feed connecting your catalog to WikiParfum
Contact your ScentXP account manager to obtain your API key and register your domain.

​
Quick start

Add ScentBot to any page in three steps:
1

Load the widget script

Add the ScentBot runtime to your page:
<script src="https://scentbot.widgets.scentxp.net/index.iife.js" type="application/javascript"></script>
2

Load fonts

ScentBot uses Graphik and Dover Serif by default. Include the font-face declarations in your CSS or <style> tag. See Installation for the full font setup.
3

Add the widget

Insert the widget tag with your API key:
<scentbot-widget
  public-key="your_public_key"
  language="en"
></scentbot-widget>
That’s it. ScentBot appears as a floating chat button on your page.

​
Next steps

Installation

Full setup instructions — script loading, fonts, and widget markup.

Configuration

All widget attributes — positioning, notifications, metadata, and more.

Events

Custom events for cart integration and programmatic control.

Capabilities

Search types, image search, multi-language, and session persistence.