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

# Quickstart

> Get your AI chat widget up and running in 5 minutes.

# 5-Minute Setup Guide

Here is the fastest way to go from zero to a working AI chat widget on your website.

<Steps>
  <Step title="Create Your Account" icon="user-plus">
    Go to [bestchatbot.io](https://bestchatbot.io) and click **Get Started**. Sign up with your **Google account** or **email and password**.
  </Step>

  <Step title="Create a Workspace" icon="grid-2">
    After signing in, create a new workspace. A workspace holds your knowledge base, settings, and widget configuration.

    <Tip>Each workspace runs one chat widget with its own isolated knowledge base. Create separate workspaces if you need to manage multiple websites or brands.</Tip>
  </Step>

  <Step title="Configure Your Widget" icon="window-maximize">
    From your workspace, open the **Web Widget** setup and fill in:

    * **Name**: a label (e.g., "My Website Widget")
    * **Allowed Origins**: the domains where the widget may run (supports wildcards like `*.example.com`)
    * **Primary Color**: your brand color in hex

    The dashboard generates a unique embed snippet for you.
  </Step>

  <Step title="Add Knowledge" icon="book-open">
    Give the bot something to learn from. You have two options:

    * **Upload Documents**: Drag and drop PDFs, DOCX, TXT, or MD files
    * **Add URLs**: Paste a website URL and let BestChatBot scrape the content (direct URL, sitemap, or full crawl)

    <Note>After adding content, click **Rebuild Knowledge Base** so the bot can process your data.</Note>
  </Step>

  <Step title="Embed on Your Site" icon="code">
    Copy the script tag from your widget's **Installation** tab and paste it just before the closing `</body>` tag on any page where you want the widget to appear.

    ```html theme={null}
    <script
      src="https://widget.bestchatbot.io/widget/v1/chat.js"
      data-api-key="rk_live_xxxxxxxxxxxxxxxxxxxx"
      defer
    ></script>
    ```
  </Step>

  <Step title="Test and Go Live" icon="circle-check">
    Open your website and a chat bubble appears in the bottom-right corner. Click it and try a question. You can also use the **Retrieval Testing** page in your dashboard to dry-run the bot before opening it to visitors.

    Once you're satisfied, the widget is already live for everyone visiting your site.
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Upload Documents" icon="file-arrow-up" href="/knowledge-base/upload-documents">
    Learn how to add files to your knowledge base.
  </Card>

  <Card title="Add URLs" icon="globe" href="/knowledge-base/add-urls">
    Scrape content from your website or docs.
  </Card>

  <Card title="Customize Responses" icon="sliders" href="/customization/response-preferences">
    Set the bot's tone and response length.
  </Card>

  <Card title="View Bot Responses" icon="chart-line" href="/using-the-bot/bot-responses">
    Monitor how the widget performs.
  </Card>
</CardGroup>