Install ChatNox on your website

Get started with ChatNox

Installing ChatNox is simple. You only need to add a small JavaScript snippet to your website. Once installed, the ChatNox chat bubble will appear automatically on the pages where the snippet is present.

After installation, visitors can open the chat widget, send messages to your business, and communicate with your team directly from your website.

Your site key

Your site key uniquely identifies your business or website to ChatNox. The widget uses this key to determine which ChatNox account should receive visitor conversations.

Your site key is designed to be used in frontend website code, so it is safe for it to be visible to website visitors. It does not provide access to your ChatNox dashboard or your team account.

Embed code

Add the following snippet to every page where you want the ChatNox widget to appear.

The recommended location is immediately before the closing </body> tag of your website.

<script>
  window.ChatNoxConfig = {
    siteKey: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    apiBase: "https://chatnox.xyz/api"
  };
</script>
<script src="https://chatnox.xyz/widget/widget.js"></script>

Important: Do not modify the siteKey or apiBase values unless you are instructed to do so by ChatNox.

Setup steps

Follow these steps to install the widget on your website.

1. Copy the embed code

   Copy the complete ChatNox JavaScript snippet from the code block above. Make sure you copy both script elements.

2. Open your website

   Open the HTML source of your website, or access your website builder's custom code, footer scripts, or equivalent section.

3. Paste the snippet

   Paste the complete snippet immediately before the closing </body> tag.

4. Save and publish

   Save your changes and publish or deploy your website so the updated code becomes available to your visitors.

5. Open your live website

   Visit your website in a browser. The ChatNox chat bubble should appear automatically.

6. Send a test message

   Open the widget and send yourself a test message. Then sign in to your ChatNox dashboard and check your Inbox to confirm that the conversation was received.

Check that everything is working

After publishing your website, use the following checklist to confirm that ChatNox has been installed correctly.

• The ChatNox chat bubble is visible on your website.
• The widget opens when clicked.
• A visitor can enter a message.
• The test message appears in your ChatNox Inbox.
• Your team can reply to the conversation.
• The visitor receives the reply in the widget.

Chat bubble is not appearing?

If the widget does not appear after installation, check the following items first.

• Check the script location. Make sure the complete snippet was added to the page and is located before the closing </body> tag.
• Check the site key. Confirm that the site key in your website code matches the site key shown in your ChatNox dashboard.
• Check that the website was published. If you use a website builder, saving the code may not be enough. Make sure the latest version of your website has been published.
• Clear your browser cache. Cached website files can sometimes prevent newly added scripts from appearing immediately.
• Check browser extensions. Privacy, security, or ad-blocking extensions can sometimes block third-party scripts.
• Check your browser console. If you are comfortable with developer tools, check the browser console for JavaScript errors related to the ChatNox widget.

Using a website builder?

You do not necessarily need direct access to your website's HTML. Many website builders provide a custom code, footer code, tracking code, or custom JavaScript section where you can add the ChatNox snippet.

Look for an option such as Custom Code, Footer Scripts, Custom JavaScript, or Code Injection.

The ChatNox snippet should generally be added to the section that loads code across all pages of your website.

Customization & AI

Once the widget is live, you can make it match your site and let it answer visitors automatically, even when your team is offline. Widget appearance is available on every plan; the AI Bot is available on the ChatNox Max and Prime plans.