Ailistair launch guide

Configure guardrails, connect data, embed the widget, and monitor usage. This guide covers the current MVP feature set. Need help? Email support@ailistair.com or open the in-app chat from your workspace dashboard.

Getting started checklist

Create a workspace from the signup flow and complete the Stripe checkout for your plan.
Open the dashboard, add your first channel, and paste guardrail instructions (tone, escalation, restricted content).
Enable or disable MCP tools per channel; run a health check from the dashboard if you connect external sources.
Embed the chat widget on your site and send a test conversation.
Review usage in the dashboard: tokens, guardrail alerts, and MCP tool status.

Workspace setup

Guardrails

Guardrails are required per channel. Provide a short system prompt covering brand tone, what to refuse, escalation rules, allowed knowledge domains, and any MCP tool usage instructions. Requests without guardrails are blocked by the API.

Token limits

Set soft and hard token ceilings when creating or editing a channel. The assistant surfaces warnings as softLimitReached in responses and pauses the channel once the hard limit is exhausted unless auto top-ups are enabled.

Knowledge sources & MCP tools

Connect knowledge sources (Google Drive, SharePoint, web pages) through the Knowledge tab. MCP tools live under “Tools” in the workspace dashboard and can be toggled per channel. All activity is logged so you can audit calls later.

Nudge bubble

Want extra visibility? Enable the proactive nudge bubble in channel settings to show a pulsing teaser beside the launcher. Set the copy and delay to match your brand voice.

Widget install guides

Each channel exposes a public key and script snippet. The production bundle lives at https://cdn.ailistair.com/widget/ailistair-widget.js. Replace YOUR_PUBLIC_KEY with the channel key from the dashboard.

<script
  src="https://cdn.ailistair.com/widget/ailistair-widget.js"
  data-public-key="YOUR_PUBLIC_KEY"
  data-channel-key="YOUR_PUBLIC_KEY"
  data-api-base="https://api.ailistair.com/api/chat"
  defer></script>

The bundle autodetects the attributes above and mounts the widget as soon as it loads. Duplicate script tags reuse the existing instance so it’s safe for GTM and CMS injectors.

Shopify

In Shopify admin, go to Online Store → Themes → Customize → Theme settings → Custom CSS/HTML.
Choose Footer or Theme code, insert the script tag above before </body>.
Save and preview. The widget launcher appears bottom-right by default.

WordPress (Elementor / classic)

Install the Insert Headers and Footers plugin or open Appearance → Theme File Editor.
Paste the script into the Footer Scripts area or before </body> of footer.php.
Clear caches if you use a caching plugin and verify on the live site.

Wix

Open Settings → Custom Code in the Wix dashboard.
Add the script as a new snippet, choose All pages and load it in the body end.
Click Publish to deploy.

Squarespace

Go to Settings → Advanced → Code Injection.
Paste the script into the Footer field and save.
Refresh your site. The widget will appear instantly.

Custom HTML site

Copy the script into your global layout file before the closing </body>.
If you host behind a CSP, allow https://ailistair.com for script-src and connect-src.
Optional: pass data-theme="dark" or data-launcher="hidden" attributes for customization.

Guardrails, tools, and compliance

Pre-flight guardrails: ensure every request has channel instructions; otherwise the API returns GuardrailsNotConfigured.
Post-flight filters: redact emails, phone numbers, and disallowed phrases; the dashboard logs any edits for review.
MCP tooling: enable only the namespaces you trust. Health checks run hourly; failures raise alerts inside the workspace dashboard.
Audit trails: conversation transcripts and tool invocations are stored for 30 days by default (configurable per plan).
Shopify compliance: review answers to Shopify’s protected customer data questionnaire before requesting billing or protected scopes.

Billing & token management

Each plan includes a monthly token credit equal to 5% of the plan’s allowance. Token pricing is model-dependent and automatically marked up according to your plan’s factor (currently 4× OpenAI cost for GPT‑4o mini).

Toggle auto top-ups in the dashboard to authorize Stripe for prepaid bundles when balances drop below your threshold.
Review invoices, usage, and top-up history under Billing → Token history.
Set alert emails for soft limits; Mailgun dispatches notices to workspace owners and billing contacts.

Troubleshooting & best practices

Check that the script URL is reachable, CSP allows https://ailistair.com, and the channel is active. Use browser console for CORS errors.

Ensure the channel has instructions saved, guardrail text exceeds 50 characters, and required disclosures are present. Refresh the widget after editing guardrails.

Verify the success and cancel URLs in plan settings match your environment. Stripe requires HTTPS in production; localhost is allowed for testing.

Use the contact form, email support@ailistair.com, or open the in-app chat from the dashboard.

Last updated: November 30, 2025

Menu