Quickstart

This guide gets a chat widget live on your site in five minutes.

1. Create a workspace

Sign up at cs.askais.com/signup. You'll pick a subdomain (e.g. acme.cs.askais.com) and create an OWNER user.

2. Create an inbox

From the admin, go to Settings → Inboxes → New inbox. Pick channel WEBand give it a name like "Website chat". You'll get an appId and a secretKey.

Save the secret key — it's only shown once. You can rotate it later.

3. Embed the widget

Paste this snippet before </body> on your site:

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"></script>

4. Configure your AI agent

Go to AI Agent in the admin. You have two options:

• Use platform-provided keys (depends on your plan's AI quota)
• BYOK — add your own OpenAI / Anthropic / DuckLLM key (encrypted at rest)

5. (Optional) Add knowledge

Upload docs in Knowledge. The worker will chunk, embed, and index them so the AI replies are anchored in your real content.

6. Test it

Open your site, click the chat bubble, and send a question. The first message creates a conversation in the admin Inbox; the AI replies stream back token-by-token.

Done. Next: customize the widget, or hook into webhooks.