# Kelsie website assistant - developer docs

Kelsie is the virtual front desk for appointment businesses (spas, salons, studios, tutors, clinics, rentals). This guide covers adding the hosted Kelsie assistant to a custom website.

Source: https://usekelsie.com/docs

## What it is

- A business-aware AI assistant for your own website, included with the Pro and Premium plans.
- It answers from the business's public information only: services, prices, opening hours, policies, team, and business profile.
- It sends guests to the hosted booking flow (https://usekelsie.com/s/YOUR_BUSINESS_SLUG) when they are ready to pick a time.
- Voice calls are supported: guests can talk to the assistant out loud, in their own language.
- White label is included with Pro: enable it in Settings -> Branding and the assistant carries the business name only, with no Kelsie marks.

## Quick start

1. Activate Pro or Premium for the business workspace.
2. Find the business slug: the final part of the Kelsie booking-page URL (usekelsie.com/s/river-studio -> river-studio).
3. Add the launcher script (recommended) or the inline iframe below, replacing YOUR_BUSINESS_SLUG.

## Launcher script (recommended)

One tag adds a floating chat bubble to every page:

```html
<script
  src="https://usekelsie.com/widget.js"
  data-business="YOUR_BUSINESS_SLUG"
  async
></script>
```

Optional attributes:

- data-position="left" (default right)
- data-color="#111723" (bubble color, default #4d6bfe)
- data-offset="24" (px from the viewport edges, default 20)

## Inline iframe

Embed the assistant panel directly in a page (for example a contact page):

```html
<iframe
  src="https://usekelsie.com/embed/YOUR_BUSINESS_SLUG"
  title="Ask Kelsie"
  loading="lazy"
  allow="microphone; autoplay"
  style="width: min(420px, calc(100vw - 32px)); height: min(620px, calc(100vh - 32px)); border: 0; background: transparent;"
></iframe>
```

## Works with every site builder

The launcher is dependency-free vanilla JS and the embed is a plain iframe, so Kelsie works anywhere custom code is allowed:

- WordPress: paste the script in a Custom HTML block or the theme footer (any self-hosted site; WordPress.com needs the plan tier that allows custom code).
- Wix: Settings -> Custom Code -> add to end of body (needs a premium Wix plan with a connected domain).
- Framer: Site Settings -> Custom Code -> end of body tag (paid Framer sites).
- Squarespace: Settings -> Advanced -> Code Injection, or a Code block.
- Shopify: paste before </body> in theme.liquid (all plans).
- Webflow: Project Settings -> Custom Code, or an Embed element.
- Hand-coded sites: paste the tag anywhere in the page.

The iframe grants `allow="microphone; autoplay"` so guest voice calls work inside the embed on any host site.

## Behavior and safety

- Answers come only from the business's public service menu, prices, hours, and profile.
- No access to admin data, private client details, or internal reports.
- Never promises live availability; it directs guests to the booking flow.
- Rate limited, bot-gated (Cloudflare Turnstile), and model responses are excluded from provider storage.
- If the AI provider is briefly unavailable, the assistant still answers prices, hours, policies, and booking questions from the business's own data.

## Support

Email support@usekelsie.com for custom placements, content-security policies, or anything else.