Installation Guides

Install the Nivon Chatbot

The Integration section generates installation code for each supported platform, along with the published key, Chatbot ID, and domain restrictions that control where the widget loads.

Nivon provides installation code for HTML, React, Next.js, WordPress, and Google Tag Manager. Astro sites and website builders such as Webflow, Shopify, and Squarespace use the same HTML script, added to the layout or to the builder's custom code settings. Wix has an official Nivon app and Framer has an official Nivon plugin, so on those you can connect your chatbot without pasting code. The Integration screen also provides settings for the Published key, Chatbot ID, and Allowed domains.

Before you install

Make sure the chatbot is configured and ready to receive conversations.

You will need:

  • Access to the Nivon chatbot you want to install
  • Access to the website or project where you want to add Nivon
  • The installation code from the chatbot's Integration section. On Wix or Framer, you can use the official Nivon app or plugin instead.

Open Integration

Image
  1. Sign in to Nivon.
  2. Open the chatbot you want to install.
  3. Select Integration.
  4. Choose the installation option that matches your website.
  5. Copy the code provided by Nivon.

The Integration screen provides different code for each supported platform.

Install the widget

Each platform below uses the same script with a different loading method. Always copy the code from the Integration screen rather than the examples here, so the correct chatbot values are included.

HTML

Use the HTML option for websites that use standard HTML.

Nivon provides a script similar to this:

html
<script
  src="https://assets.nivon.ai/agent/widget.min.js"
  data-publish-key="YOUR_PUBLISHED_KEY"
  data-chatbot-id="YOUR_CHATBOT_ID"
  defer
></script>

Replace the placeholder values only when necessary. The Integration screen already provides the values for your chatbot.

Image

Add the script to the HTML page where the Nivon widget should be available.

React

Use the React option for React applications.

Image

Nivon provides the integration code directly in the Integration screen. Copy the generated script and add it to the appropriate part of your React application.

The generated code includes the Nivon script URL, the published key, and the Chatbot ID for the selected chatbot.

Next.js

Use the Next.js option for Next.js applications.

Nivon's example uses next/script to load the widget:

tsx
import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script
          src="https://assets.nivon.ai/agent/widget.min.js"
          data-publish-key="YOUR_PUBLISHED_KEY"
          data-chatbot-id="YOUR_CHATBOT_ID"
          strategy="lazyOnload"
        />
      </body>
    </html>
  );
}

Use the code generated on your Nivon Integration screen to ensure the correct chatbot details are included.

WordPress

Use the WordPress option for WordPress websites.

Nivon provides a PHP example that adds the widget through the wp_footer hook:

html
function add_nivon_chatbot() {
  echo '<script
    src="https://assets.nivon.ai/agent/widget.min.js"
    data-publish-key="YOUR_PUBLISHED_KEY"
    data-chatbot-id="YOUR_CHATBOT_ID"
    defer
  ></script>';
}
add_action('wp_footer', 'add_nivon_chatbot');

Add the code using the method appropriate for your WordPress setup.

Google Tag Manager

Use Google Tag Manager (GTM) if your website already loads tags through a GTM container and you would rather not edit the site code.

In Nivon, open your agent, go to the Integration tab, and under Add the code manually select Tag Manager. Copy the code shown there.

Image

Then, in Google Tag Manager:

  1. Open your container and select Tags, then New.
  2. Under Tag Configuration, choose Custom HTML.
  3. Paste that code into the HTML field.
  4. Under Triggering, choose All Pages. Use Initialization - All Pages instead if you want the widget to load as early as possible.
  5. Name the tag, for example "Nivon chatbot", and select Save.
  6. Select Preview, open your website in Tag Assistant, and check that the Nivon tag fires and the chat widget appears.
  7. Select Submit, then Publish, to make the change live.

The widget loads after the GTM container loads, so it can appear a moment later than it does when the script is added directly to your site's HTML. If the widget does not appear, check that the published container runs on that page and review the Allowed domains setting.

Astro

Use the HTML option for Astro sites. Paste the script into the layout your pages share, usually src/layouts/Layout.astro, just before the closing body tag. Add is:inline so Astro outputs the tag as written instead of bundling it:

src/layouts/Layout.astro
<body>
  <slot />
  <script
    is:inline
    src="https://assets.nivon.ai/agent/widget.min.js"
    data-publish-key="YOUR_PUBLISHED_KEY"
    data-chatbot-id="YOUR_CHATBOT_ID"
    defer
  ></script>
</body>

Build and deploy as usual. If your site uses Astro's view transitions, see the Astro integration guide for a note on keeping the widget on screen between pages.

Install on a website builder

On Wix and Framer, use the official Nivon app or plugin described below. On Webflow, Shopify, and Squarespace, you install the chatbot with the HTML script. The steps are nearly the same on each:

  1. In Nivon, open the Integration tab, select HTML under Add the code manually, and copy the code.
  2. Paste it into the builder's site-wide custom code area, in the field that loads before the closing body tag (often called Footer or Body end).
  3. Save, then publish the site if the builder asks you to.
  4. If you've added Allowed domains, add the site's domain, plus any staging or builder subdomain you test on.

Most builders don't run custom code inside their editor or preview, so check the widget on the live site. Custom code also tends to need a paid plan. Each full guide lists the exact menus and plan limits.

Webflow

Go to Site settings > Custom code, paste the code into Footer code, click Save changes, then publish. Custom code needs a paid Site plan or Workspace plan. Full Webflow guide

Framer

Install the official Nivon plugin, Nivon - AI support Chatbot, from the Framer Marketplace and open it in your project. Click Login, check that the code in the Nivon tab matches the code in Framer, and click Approve. Back in Framer, pick your workspace and chatbot, click Connect Chatbot, then publish. The widget won't show on the canvas or in Preview. If you prefer, you can still paste the HTML code into Site Settings > General > Custom Code. Full Framer guide

Shopify

Go to Online Store > Themes, choose Edit code from the theme's menu, open layout/theme.liquid, paste the code just above the closing body tag, and save. The widget shows on storefront pages, not on checkout. Full Shopify guide

Wix

Install the official Nivon app, Nivon - AI Support Chatbot, from the Wix App Market and open it in your Wix dashboard. Click Log in to connect, check that the code in the Nivon tab matches the code in Wix, and click Approve. Back in Wix, pick your workspace and chatbot. The HTML code also works if you prefer it: add it under Settings > Custom Code, which needs a published site with a connected domain. Full Wix guide

Squarespace

Open Code Injection, paste the code into the Footer field, and save. Code Injection is included in the Core, Plus, and Advanced plans, but not Basic. Full Squarespace guide

Integration settings

Three values control which chatbot loads and where. All three are managed in the Integration section.

Published key

The Published key identifies the published integration for your Nivon chatbot.

The generated installation code automatically includes the published key.

Image

You can open the Published key section in Integration to:

  • View the current key
  • Copy the key
  • Regenerate the key

Use the value provided by Nivon when adding the integration code.

Chatbot ID

The Chatbot ID identifies the Nivon chatbot that the website should load.

It is included in the generated installation code.

Use the code from the chatbot you want to install. Do not replace the Chatbot ID with that of another Nivon chatbot.

Allowed domains

Allowed domains control where the Nivon widget can load.

When no domain has been added, the widget can load on any domain. Once an allowed domain is added, Nivon restricts the widget to the domains specified.

This is useful when the chatbot should only work on approved websites.

To add an allowed domain:

Image
  1. Open Integration.
  2. Find Allowed domains.
  3. Select Add domain.
  4. Enter the domain, for example example.com.
  5. Select Add domain.

Add each domain where the widget should be allowed to load.

Verify the installation

After adding the code or connecting the app:

  1. Open the website where Nivon was installed.
  2. Check that the chat widget appears.
  3. Open the widget.
  4. Send a test message.
  5. Confirm that the correct chatbot responds.

If the widget does not appear, first check that the generated code was added correctly and review the Allowed domains setting.

Common setup issues

The widget does not appear

Check that:

  • The Nivon script was added to the website, or a chatbot is selected in the Wix app or Framer plugin.
  • The code belongs to the correct chatbot.
  • The website uses the complete code provided by Nivon.
  • The domain is allowed when domain restrictions are enabled.

The wrong chatbot appears

Check the Chatbot ID in the installation code and compare it with the chatbot you intended to install. If you used the Wix app or Framer plugin, open it and switch to the right chatbot.

The widget works on one website but not another

Check the allowed domains. When domain restrictions are configured, the widget only loads on the domains you have added.

Updating your installation

You generally do not need to replace the installation code when changing normal chatbot settings such as the model, tone, appearance, or knowledge.

Those settings are managed in Nivon.

Use the Integration section to view the current installation code, published key, Chatbot ID, or allowed domains.

Last updated: November 13, 2026