WordPress Chatbot Plugin

Use the official ChattyBox WordPress plugin when you want a no-code installation that loads the hosted widget without editing theme files. This guide covers the operational setup. The WordPress AI chatbot page explains content and crawl strategy, while the WordPress plugin landing page covers the product at a glance.

Before Installing

Complete the Getting Started flow first: connect your public WordPress URL, review indexed pages, and verify representative answers in Test Chat. Then create a browser-safe public key in Public Keys and copy it from the project Embed tab.

Install the Plugin

The plugin has no Composer, npm, or build-step dependency.

1. Download the ChattyBox WordPress plugin ZIP, or clone the public repository.
2. In WordPress, open Plugins > Add New > Upload Plugin, upload the ZIP, and activate ChattyBox AI Chatbot. For a manual server install, copy the plugin directory into wp-content/plugins/ first.
3. Open Settings > ChattyBox.
4. Paste the public widget API key from the project Embed tab.
5. Enable the chatbot and save the settings.

The plugin stores the public widget key and display settings in WordPress options. Never paste a ChattyBox management credential into the plugin.

Configure Loading

The production defaults are:

• Widget script: https://chattybox.ai/widget.js
• API endpoint: configured automatically by the plugin
• Locale: detected from the page language and visitor browser

The plugin loads the widget on public frontend requests. It intentionally skips wp-admin, feeds, REST requests, and AJAX requests, so administrative and non-page responses do not receive the script.

Exclude Additional Routes

Use the chattybox_load_widget filter from a site-specific plugin or child theme when a public route should not show the widget:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Keep the default plugin behavior enabled first, then add only the route exclusions your site needs. Test both an excluded route and a normal public page after changing the filter.

Manual Script Fallback

Use the plugin as the default path. If your WordPress team already manages scripts through a theme, child theme, script plugin, or Google Tag Manager, you can load the hosted widget manually instead:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Do not enable the plugin and add the same widget snippet at the same time. Choose one loader so visitors do not receive duplicate launchers.

Verify the Installation

After configuring the plugin:

• Open a public WordPress page in an incognito window.
• Confirm the launcher appears once.
• Ask a real visitor question.
• Verify the answer includes source citations back to public WordPress pages.
• Check the browser console for missing data-api-key, data-api-url, or key errors.
• Test a checkout, account, or private route if you configured an exclusion.

Continue with the launch checklist before announcing the chatbot. Use Analytics and Content Gaps to improve the WordPress content after real questions arrive.