How to Add a Chatbot to a Website Using HTML

Before you start

This guide uses PrimeWebKit's standard website widget: one external script that loads the chatbot configured in your account. It does not install a native HTMLplugin or automatically connect your site's private data. The platform-specific steps below explain where the snippet belongs and what to verify before making a live change.

• A published PrimeWebKit bot and its complete script from the Widget tab.
• Access to the HTML file or shared template used to generate the pages you want to update.
• A way to deploy the changed files to the same public site origin visitors use.
• The public hostname allowed in the bot's domain settings if domain restrictions are enabled.

Installation steps

1. 1. Find the shared HTML document template

   Editor or file path: Your site's source or hosting editor → shared page layout/template that contains </body>

   Use the repository or hosting tool that owns your site's HTML. The exact filename depends on how the site is built, so locate the shared document template rather than adding the snippet to one generated page at random. If every page is maintained separately, add it only to the pages where the widget should be available.

2. 2. Paste the script before the closing body tag

   Editor or file path: Shared HTML template → immediately before </body>

   Add the full script copied from the bot's Widget tab just before the closing body tag. Keep the data-bot-id value as supplied. Place the script once in the template, not in both the shared layout and an individual page. The async attribute allows the external widget script to load without blocking parsing of the page.

3. 3. Deploy and test the public page

   Editor or file path: Your site's normal build and deploy process → open the deployed URL

   Build or upload the changed site using its established deployment process. Open a deployed page in a private browser window, confirm the chat launcher appears, and send a test question that the bot's knowledge sources can answer. Test another page that shares the template to confirm placement is global.

Widget snippet

Copy the snippet from the selected bot's Widget tab whenever possible. The example below shows the format for your reference; replace the example identifier only with the bot ID from your own copied snippet.

<script     src="https://api.primewebkit.com/widget.js" data-bot-id="YOUR_BOT_ID" async></script>

Use the exact snippet copied from the Widget tab. YOUR_BOT_ID is explanatory placeholder text, not a working identifier.

Platform-specific notes

If the site uses a static-site generator, CMS, or framework, edit its source template rather than a generated output file that will be overwritten on the next build. Preserve existing script ordering and consent controls.

If the widget is not intended on every page, use the relevant page template instead of the global layout. Either way, ensure the script is included once per rendered document and only on domains where it is allowed to run.

Before publishing, review any site-wide consent banner, security policy, and domain restrictions already in place. Add the widget only to the pages and hostnames where it is intended to run, and avoid copying account secrets or private customer data into the page source.

Verify the chatbot is working

Test a published page, not just an editor preview. Confirm the launcher is visible, opens when activated, and accepts a question. Ask something answered by the bot's current knowledge sources, then check that an unrelated or unsupported question is handled within the limits of the bot's instructions.

Repeat the check on another page that shares the layout and on each hostname visitors use, such as a staging host and the production domain. If the bot is restricted to allowed domains, include the exact hostname for each environment before testing. Inspect the browser console and Network panel if the script or API request fails; record the specific error rather than changing unrelated settings.

Common problems

Frequently asked questions