How to connect knowledge base templates help to a chat wi…

The website widget is the surface your visitors interact with. It displays a chat bubble on your site. The knowledge base – your help articles, templates, FAQs, and any other support content – is the source of truth the widget draws from.

The connection happens in Chatref: you feed your content into the platform’s knowledge-base feature, and the widget pulls answers from it on the fly. There is no technical integration to wire up between the widget and your existing help center. You simply tell Chatref where your knowledge lives, and it handles retrieval. Whether you use dedicated Knowledge Base Software or a collection of internal docs, the same flow applies – add your sources once, and they become the foundation of every widget response.

All training content stays within your Chatref account. When a visitor asks a question, the widget retrieves only the most relevant passage from your knowledge base and presents it in a conversational answer. No search box, no list of links – just a direct reply.

1. Create a Chatref account.
   Go to app.chatref.ai and sign up. Every new account receives $50 in free credit – no credit card required.

2. Create an agent.
   Each agent represents a chatbot you’ll deploy. Give it a name that matches the purpose (for example, “Support Agent”).

3. Add your knowledge base content.
   Navigate to the agent’s training section. Upload your templates, help articles, and guides using any of these methods:

   • Upload PDFs, Word documents, or plain text files containing your knowledge base templates.
   • Paste raw text directly.
   • Add individual URLs to your live help center articles.
   • Submit a sitemap URL to import entire sections at once.

   For templates, the simplest approach is to upload the document that defines the template, or to paste the template’s explanatory text. Chatref indexes this content so the widget can surface it when relevant questions come in.

4. Test in the playground.
   Before embedding, use the live playground to ask questions like “How do I fill out the import template?” or “What’s the template for user permissions?” Confirm the answers are accurate and cite the correct source. Iterate on your content if the phrasing doesn’t yet cover real user questions.

5. Embed the widget.
   From the agent’s “Embed” tab, copy the provided snippet. Paste it into the HTML of every page where you want the chat bubble to appear, just before the closing </body> tag. The snippet looks similar to:

   <script src="https://widget.chatref.ai/embed.js" data-agent-id="your-agent-id" async></script>
   

   No further script configuration is needed.

6. Allow your domain.
   In the same Embed tab, add the domains where the widget will be active (e.g., yourdomain.com). This prevents others from using your agent on unauthorized sites.

Once the snippet loads on your pages, the connection is live. The widget will answer questions using the knowledge base content you added — no further steps required.

After you embed the widget, a chat bubble appears in the corner of your site. When a visitor clicks it, the chat window opens. The widget uses your branding – colors and logo – automatically if you’ve customized those settings.

A typical interaction might look like this: a user types “How do I use the onboarding template?” In response, the widget delivers a short, direct answer drawn from your uploaded help content, such as:

Go to Settings → Templates → Onboarding and click “Apply.” This copies the standard structure to your workspace. You can then fill in your company details.

Below the answer, a small citation points to the source document (e.g., “From ‘Template Guide’”). There are no dead-end links – the answer itself resolves the question. If the user needs clarification, they can continue the conversation, and the widget will retrieve from your knowledge base again.

Widget not appearing on the site

• Confirm the snippet is placed exactly once, before </body>, on the correct domain.
• In the Chatref Embed tab, check that the domain is listed and matches the one visitors use (including www vs. non-www).
• Clear your browser cache or test in an incognito window; some ad blockers may hide the widget inadvertently.

Widget answers don’t mention your templates

• The agent may not have ingested your template content. Revisit the training section and ensure the documents or URLs were successfully added. Check for indexing errors – try re-uploading the file or re-submitting the sitemap.
• If the content is present, the phrasing of visitor questions may not match how the templates are described. Add a few sample questions alongside your content (for example, a FAQ entry like “How do I access the import template?”) to improve match quality.
• Large files or poorly formatted PDFs can cause partial indexing. Split a long document into separate, focused files (one per template or topic) and add them individually.

Answers feel generic or incomplete

• Generic answers often mean the training content lacks the specifics visitors ask for. Expand your templates’ supporting docs to include step-by-step instructions, common use cases, and screenshots. The more targeted the content, the more precise the widget’s answers.
• After updating your knowledge base, the widget picks up changes automatically once the sources re-index – typically within a few minutes. You can verify in the playground immediately.

New templates added later aren’t reflected

• Add the new document or URL to the agent’s training sources. The system will re-index and include the fresh content. No manual refresh is required; the widget starts using the updated knowledge base automatically.

What causes knowledge base templates problems for Knowledge Base Software?

Template problems often arise from outdated or incomplete articles, poor formatting that confuses retrieval, or content that doesn’t address the real questions customers ask. Inconsistent naming across templates, missing context, or large wall-of-text pages can also lead to poor answer quality when the content is used by any tool that relies on search or AI retrieval. For Knowledge Base Software specifically, issues multiply when templates aren’t kept in sync with product changes or when they’re written for internal audiences rather than end users.

How do I improve knowledge base templates for Knowledge Base Software?

Improve templates by adding direct answers to actual customer queries, breaking long pages into focused, standalone articles, and including clear action steps. Test each template against common support tickets to ensure it resolves the question. When using a tool like Chatref, feed those improved templates as distinct training sources; the focused content yields more accurate widget responses, and you can refine iteratively based on what questions the widget receives in production.