Quickstart

From an empty dashboard to a widget answering on your site. Most of the elapsed time is waiting for a crawl to finish.

1. Create your business

Sign in and you get a business record with a siteKey — the public identifier the widget uses to fetch its configuration. It is safe to put in client-side HTML; it only works on domains you allowlist.

2. Add some content

Go to Knowledge base and add at least one source. The fastest start is a URL:

1. Choose the URL tab.
2. Enter your site root, e.g. https://example.com.
3. Submit, and watch the status move from pending to ready.

Ingestion runs in a background worker. If a source stays at pending forever, the worker process is not running — see How it works.

3. Make it yours

Under Widget appearance, set the primary colour, assistant name, and logo. The live preview updates as you type. Full reference: Appearance.

4. Allow your domain

Add the domains that may embed the widget. Requests from any other origin are rejected, so this is what stops someone else using your site key.

https://example.com
https://www.example.com

5. Paste the snippet

Copy it from Install & embed and drop it in before your closing </body> tag:

<script
  src="https://widget.minaya.ai/widget.js"
  data-site-key="your-site-key"
  data-api-url="https://api.minaya.ai"
  async
></script>

Reload your site and the launcher appears in the corner. Details of every attribute: Install the widget.

6. Ask it something

Open the widget and ask a question your content answers. If it replies that it does not have that information, the content may not have been crawled — see Answer quality.