How to Add an AI Support Assistant to Your Docs with Kapa AI

Kapa AI indexes your documentation and support threads, then answers user questions in a chat widget with links back to the source pages. It is aimed at developer tools and SaaS products where the docs are long and support tickets repeat.

The pitch is simple: users ask in plain language, Kapa cites the exact doc section instead of hallucinating an answer.

What sources can Kapa AI index?

Kapa connects to a handful of source types and re-crawls them on a schedule you set.

• Public documentation sites by URL crawl
• Notion workspaces
• Zendesk and Intercom help centres
• Slack community archives, if you grant access

A typical docs crawl of 500 pages finishes indexing in under an hour. Expect to re-index after every major docs release, since stale answers are worse than no answers.

How do you embed the assistant?

Two options. Drop a script tag before the closing body element to get a floating bubble on your own docs, or use the hosted Q&A page Kapa generates for you. The widget version needs a single project ID.

<script src="https://widget.kapa.ai/kapa-widget.js" data-project-id="YOUR_ID"></script>

Styling is limited to colour, position, and the welcome message. If your design system demands more, plan for a custom build against their API.

Is Kapa AI free?

There is a free demo tier for evaluation, but production use is paid and priced per monthly answer rather than per seat. That structure rewards products with low volume and punishes viral ones, because a spike in questions is a spike in cost. Get a quote before you ship the widget to a large audience.

Where does Kapa AI struggle?

It answers only what is in the indexed corpus. Ask about a feature you shipped yesterday and it will either say it does not know or pull a nearby, wrong section. Multi-hop questions, like “which of the three plans includes SSO and how do I enable it”, often need two prompts. And if your docs are contradictory, Kapa surfaces both versions without flagging the conflict.

The right fit is a product with well-maintained docs and a support inbox full of the same twenty questions. The wrong fit is a product whose docs live in engineers’ heads.

Key Takeaways

• Kapa AI answers from your indexed docs and links to the source.
• Supported sources include URL crawls, Notion, Zendesk, and Intercom.
• The widget embeds with a single script tag and a project ID.
• Pricing is per answer, so high-traffic sites should model cost before launch.
• It cannot answer beyond its corpus and struggles with multi-step questions.