Documentation

How to set up and run your AI chat widget.

Getting started

Agent AI Chat lets you add an AI-powered chat widget to your website that answers visitor questions using your own business content — grounded, so it won't make things up about your business.

  1. Create an account at /auth/register with your email and a password.
  2. On first sign-in you'll be asked for a workspace name — this creates your tenant.
  3. You'll land on your dashboard. From here: add content, configure the widget, and copy your embed code.

Content & FAQs

Go to Content & FAQs in the sidebar. Add question/answer pairs covering what your visitors actually ask — hours, pricing, policies, how something works. The widget only answers from what you add here; it does not browse your website or guess.

Write answers the way you'd say them to a customer, not as internal notes. The AI paraphrases your FAQs to answer differently-worded questions, but it stays grounded in the content — it won't invent details you haven't provided.
  • You can add, edit, and delete FAQs at any time — changes apply to new conversations immediately.
  • If a visitor asks something outside your FAQs, the widget declines rather than guessing, and can offer to hand off to your team.

Widget & embedding

Go to Widget Config to set the widget's color, position (bottom-left or bottom-right), trigger button text, and first message.

Once configured, copy the embed snippet shown at the bottom of that page and paste it before the closing </body> tag of your site:

<script src="https://agent-ai-chat.vercel.app/widget.js" data-tenant-key="YOUR_PUBLIC_KEY" async></script>

That's it — no other setup needed. The widget loads asynchronously and won't block your page. Each account has its own public key, so the snippet only ever talks to your own content.

Test the widget on a real page after embedding: open your site, click the chat bubble, ask a question covered by your FAQs, and confirm the answer is accurate.

Billing

Go to Billing in the sidebar to see your plan status and upgrade to Pro. Checkout and subscription management are handled by Lemon Squeezy — click "Manage subscription" to change plans, update your payment method, or cancel at any time through their secure customer portal. We don't store your card details.

If a payment fails, you'll get a grace period before your account is suspended — update your payment method via the customer portal to avoid interruption.

Troubleshooting

The widget isn't appearing on my site

  • Confirm the script tag is pasted correctly, with your actual public key (not the placeholder).
  • Check your browser console for errors — an ad blocker or strict Content-Security-Policy can block third-party scripts.
  • Make sure the script tag isn't inside a conditionally-rendered part of your page that never loads.

The widget gives a wrong or "I don't know" answer

Check whether the topic is actually covered in your Content & FAQs. The widget is intentionally conservative — it declines rather than guessing when your content doesn't cover a question. Add or clarify the relevant FAQ and the widget picks it up immediately.

Reviewing past conversations

Go to Conversations in the sidebar to see every session, filter by active/closed, and open a transcript. You can add a staff reply from there too — note that it's saved to the transcript as an internal record but isn't yet delivered live to the visitor's browser.

Still stuck?

Email hello@zihadhosan.dev and we'll help directly.