Chatbot

HelpGuides includes a built-in AI chatbot that answers visitor questions using your knowledge base content. It sits on your website as a floating button and can hand off to a human agent when it can't help.

Chatbot settings are at Editor → Chatbot Settings. This page is only available to company admins and super admins.

Essential settings

Chatbot Name

The name appears in the chat widget header. Use something recognisable — your product name, brand name, or a friendly agent name like "Acme Support" or "Help Assistant".

Support Email

Set a support email address so that when the bot can't answer a question, visitors are offered a Contact Us form. Submissions go directly to this address.

This is the most important field to fill in before going live. Without it, visitors who hit a dead end have no way to reach a human.

Welcome Message

The heading shown when a visitor opens the chat widget. Keep it short and inviting.

Examples: How can I help? · Hi there! 👋 · Ask us anything.

Welcome Subtext

A one-line description shown below the welcome message. Use it to set expectations.

Examples: Search our guides or ask a question. · Answers powered by our knowledge base.

Embedding on your website

Once your settings are saved, embed the widget using one of two methods.

Option 1 — Direct HTML

Paste the script tag into your site's <head> section — in your index.html, layout template, or theme header settings:

<script
  src="https://helpguides.app/embed/chatbot.js"
  data-company-id="YOUR_COMPANY_ID">
</script>

Your exact snippet (with your company ID pre-filled) is shown in the Embed on Your Website section at the bottom of the Chatbot Settings page.

Option 2 — Google Tag Manager

Because GTM injects scripts dynamically, document.currentScript is unavailable. Instead, use a config object before loading the widget script.

In GTM, create a new Custom HTML tag.
Paste the snippet below (copied from Chatbot Settings):

<script>
window.HelpGuidesChatbot = {
  companyId: "YOUR_COMPANY_ID",
  baseUrl: "https://helpguides.app"
};
</script>
<script src="https://helpguides.app/embed/chatbot.js"></script>

Set the trigger to All Pages and publish.

The widget loads asynchronously and won't affect your site's page speed. Its appearance — name, color, and icon — updates automatically whenever you save changes in Chatbot Settings.

What's not covered here

Icon selection, accent color, and the live preview are covered in Customising Your Chatbot.