Integration
How to connect knowledge base builder help to a chat widget
How to connect knowledge base builder help to a chat widget — answered from your own docs. How Knowledge Base Software teams use Chatref (website widget, knowle
To connect your knowledge base to a chat widget, upload your help center content to Chatref and embed the widget snippet on your site. The widget answers visitor questions using only your own docs, turning a static Knowledge Base Software into an interactive support agent that resolves questions instantly, right where users work.
What connects to what
Your knowledge base content sits on one side – guides, FAQs, setup walkthroughs, and policy docs you have built in your knowledge base software. On the other side sits the chat widget on your website or application. Chatref connects the two by ingesting that content and letting the widget answer questions from it. There is no separate tool or sync cron – you point Chatref at the source (files, URLs, or sitemaps), it learns the material, and the widget draws on that material when a user asks something.
The connection is not a simple search box that returns a list of links. The widget reads the question, finds the relevant passage from your own docs, and composes a direct answer in your brand voice. The user gets help without leaving the page, and your team deflects repeat questions before they ever reach the support queue.
How to set it up
You connect your knowledge base to the widget in two steps: add your content, then publish the widget.
1. Add your help center content Log into your Chatref dashboard and go to the content section for your agent. Upload files (PDF, Markdown, plain text), paste URLs to individual help articles, or submit your entire help center sitemap. Chatref processes everything and makes it queryable. There is no manual tagging, no model training to manage. The system pulls from the latest version of your content each time, so updates you publish in your knowledge base software are picked up when you re-sync.
For best results, upload content that directly answers the questions your users actually ask – setup steps, import instructions, permission rules, error-message explanations. Avoid dumping internal meeting notes or long forum threads; keep the content concise and task-oriented.
2. Drop in the widget snippet
Inside the agent settings, copy the embed code under “Website Widget.” Paste that snippet into the <head> or right before the closing </body> of every page where you want the chat to appear. You can origin-allowlist the domains where the widget is permitted to run to keep your agent secure. Once published, the widget loads on those pages and starts answering questions immediately – no additional configuration required.
If your knowledge base lives on a subdomain or inside a logged-in area, make sure the widget snippet is placed on those pages too. Visitors will see the chat launcher only where you embed it.
What users see
After setup, a chat bubble appears in the corner of your site or app, branded with your colors and logo. When a visitor clicks it, they can type any question – “How do I import contacts?”, “Why did my sync fail?”, “What permissions do I need to create a report?”. The widget answers immediately with a paragraph pulled from your knowledge base, often followed by a short source citation like “From our Import Guide.”
If the answer does not fully resolve the issue, the user can request a human handoff. The conversation, along with the full chat history, passes to your team in the Chatref shared inbox. Your support person picks up right where the AI left off – no need to re-ask the question. This means the widget handles the easy repeat questions around the clock, and your team only steps in when the answer requires judgment or a change on the account.
Because the widget answers from your own docs, the tone and accuracy match exactly what you have authored. There is no generic web-search filler, no hallucinated instructions. Users see your knowledge base brought to life as a helpful, interactive assistant.
Troubleshooting
Widget not appearing on the page
- Confirm the snippet is placed on the correct domain and the domain is allowlisted in your agent settings. A mismatch will block the widget silently.
- Check the browser console for errors. A common issue is a restrictive Content Security Policy that prevents loading external scripts – adjust the CSP to allow Chatref.
- Ensure you have published the agent after adding the snippet. In the dashboard, verify the agent status is set to “Live” and not “Paused” or “Draft”.
Answers are irrelevant or off-topic
- The widget can only answer from the content you have provided. If users ask about a feature you have not documented, the widget will say it cannot help. Add or update the relevant content and re-sync the sources.
- Avoid overly long articles. The system works best when each page or section maps to a single task. Break a sprawling “Help Center” page into separate shorter docs.
- Check the source citations under the answer (visible in the dashboard conversation log). If the wrong material is being used, the source document may need restructuring – try splitting out the specific topic.
Widget appears but answers are generic
- This can happen if no content is loaded or the content set is empty. Go back to the content tab and confirm there is at least one uploaded source that has finished processing.
- If you pasted a sitemap URL, verify the sitemap is accessible publicly and returns XML with working links. Some knowledge base platforms serve sitemaps behind login walls, which Chatref cannot reach.
Human handoff never triggers
- Handoff is an agent configuration. In the agent settings, check that the handoff toggle is on and that your team has at least one member assigned to the agent’s inbox. Without an active team member, handoff requests will not be routed.
Content changes not reflected in answers
- Chatref does not poll your sources in real time. After updating your knowledge base, go to the content tab in Chatref and click “Re-sync” next to the source. Reprocessed content takes a few seconds before the widget begins using it.
FAQ
What causes knowledge base builder problems for Knowledge Base Software?
Problems typically stem from three areas. First, content quality – if your knowledge base articles are thin, outdated, or written for internal staff rather than end users, the widget answers will be unhelpful. Second, the connection itself – misconfigured origin allowlisting or CSP blocks can prevent the widget from loading. Third, scope mismatch – the widget can only answer what you have taught it. If you never add content about a common customer stumbling block, the widget will have nothing to draw from.
How do I improve knowledge base builder for Knowledge Base Software?
Focus on making your knowledge base content clear, task-oriented, and well-structured. Write each help article to answer one specific question, and use descriptive titles that mirror how a user might phrase the question. Add visual examples where possible, but avoid burying the key instructions in long paragraphs. Inside Chatref, use the conversation insights to see which topics users ask about most. If a topic appears frequently but gets low-confidence answers, that is a signal to improve the underlying source material – add a dedicated guide with step-by-step instructions. Re-sync your sources after any content update so the widget stays current with your evolving documentation.
Related guides
Put this into practice
Chatref answers your customers from your own content, day and night. Add it to your site and go live in minutes – free to start.