Documentation

Get a grounded AI support agent onto your website in a few minutes — and keep it in sync with your content.

Quickstart

  1. Create an account. Head to Get started and sign up with your email — no key required.
  2. Add your site. In the dashboard, click New site, give it a name and enter your domain (e.g. example.com). You get a unique site key.
  3. Crawl. Hit Crawl now. Helpline reads your public pages into a private knowledge base.
  4. Embed.Copy your one-line snippet and paste it into your site's HTML, ideally before </body>.
<script src="https://support-chatbot-nine.vercel.app/widget.js" data-site="your-site" defer></script>

Replace your-site with the key shown in your dashboard.

The embed tag

The widget is a single self-contained script. It injects a chat bubble in the bottom-right corner and isolates its own styles via a shadow DOM, so it won't affect your page.

Attributes

<script src=".../widget.js" data-site="acme-1a2b" data-color="#1c6e46" data-greeting="Hi! Ask us anything." defer></script>

How crawling works

Helpline first looks for /sitemap.xml. If none exists, it follows links from your homepage on the same domain. Each page is fetched, reduced to visible text, and stored for your agent only.

Tip: a clean sitemap.xml gives the most complete crawl. Most site builders generate one automatically.

Adding your own answers

Crawled pages rarely cover everything. In the dashboard, each agent has a notes field (Markdown) for FAQs, policies, pricing and tone. These notes always take priority over crawled content — perfect for the questions support hears most.

Customizing the widget

Precision & safety

The agent is instructed to answer strictly from your knowledge base, to reply in the visitor's language, and to admit when something isn't covered rather than guess. Your model key lives on the server and is never exposed to visitors, and requests are rate-limited per visitor.

Troubleshooting

The bubble doesn't appear

Confirm the script is in the page HTML and that data-site matches your dashboard key exactly.

It says it has no information

Run a crawl in the dashboard, or add notes. Answers only come from indexed content.

Chat returns an error on my site

Make sure your domain is listed in the agent's allowed domains — the API only answers from those origins.

Answers feel outdated

Re-crawl after publishing changes; the knowledge base is a snapshot from the last crawl.


Ready? Create your agent →