Quickstart

You'll create a project, upload your knowledge base, configure the widget, whitelist your domain, and paste the embed script.

1. Create a project

Sign in and create a project from the dashboard. Each project has its own knowledge base, widget, conversations, and billing.

2. Upload your knowledge base

Go to Settings → Context → Knowledge Base inside your project. Upload the documents the bot should know: FAQ, policies, product descriptions, setup guides. Plain text, markdown, and PDFs work.

See Knowledge Base for details on what gets indexed.

3. Configure the widget

Go to Settings → Widget. Pick a position, theme, and colors. Choose which form fields to ask for (name, email, phone). Pick a default language (EN or PT).

See Widget Configuration for the full list of options.

4. Whitelist your domain

In the same Widget settings page, add the domains where the widget is allowed to load (for example example.com, www.example.com). The embed script refuses to run on any other domain.

See Security for details.

5. Paste the embed script

Copy the script tag from Settings → Widget → Embed and paste it before </body> on your site:

<script
  src="https://lxaira.com/api/widget/script?projectId=YOUR_PROJECT_ID"
  async
></script>

Reload your page. The floating chat button should appear in the corner you chose.

Next steps

  • Widget JS API — open/close programmatically or send user data into the chat
  • Live Context — push per-visitor data (name, orders, plan) from your site into the chat
  • Hot Leads — so sales gets pinged on qualified conversations
Quickstart — Docs — Aira