Back to articles

The Widget Answer agent & the embeddable widget

AI & AgentsJune 18, 2026

The Widget Answer agent & embeddable widget

The embeddable widget puts your support knowledge base on any page of your website. When a visitor asks a question, the Widget Answer agent answers from your published articles — with citations — and falls back to opening a ticket when it can't.

Installing the widget

Drop one line into your site, before the closing </body> tag:

html
<script src="https://helmdesk.dev/widget.js" data-project="your-project-slug"></script>

The widget uses your project slug (not an API key), so it's safe to ship in client-side HTML. It submits to the public ticket endpoint with CORS, so it works across origins.

How answers work

  • A visitor types a question in the widget.
  • The agent runs a semantic search over your published articles.
  • If it finds relevant content, it composes a short answer and cites the articles it used, so visitors can read more.
  • If it can't answer confidently, it shows related articles and offers to contact support — it never invents an answer and never silently submits a ticket on the visitor's behalf.
  • Branding

    The widget automatically uses your project's brand color. Set it in your project settings and the widget header, accents, and buttons match your site.

    Plan requirement

    The Widget Answer agent uses AI and is available on paid plans. The widget itself (top articles and ticket submission) works on any plan.

    Was this article helpful?