ChatbotAssistant
Log in Sign up

Chatbot Integration with WordPress

This guide will walk you through the process of integrating our chatbot with your WordPress site. After completing all steps, your customers will be able to communicate with the chatbot directly on your website.

Important prerequisites: To perform the integration, you need to have a WordPress site with administrator privileges and the ability to install and activate plugins.

Choose your starting point

Widget configuration

I don't have a configured chatbot widget yet

Integration with WordPress

I already have a configured widget and want to add it to my WordPress site
0

Integration process overview

Chatbot integration with WordPress is a simple process consisting of several main stages:

  1. Chatbot widget configuration - creating and configuring the chatbot on our platform.
  2. WordPress plugin installation - downloading and installing the dedicated AI Chat Widget plugin.
  3. Getting the embed code - copying the code from our platform.
  4. Plugin configuration - pasting the code and configuring display settings.
  5. Integration testing - checking the proper functioning of the chatbot on WordPress site.
Implementation time: The entire integration process usually takes 10 to 15 minutes, depending on your experience with WordPress platform. The guide below will walk you through all stages step by step.
Tip: Before starting the integration process, make sure you have access to:
  • WordPress admin panel with plugin installation privileges
  • Account on our AI Chatbot platform with active subscription
  • Configured chatbot widget
1

Chatbot widget configuration

The first step of integration is to create and configure the chatbot widget on our platform. This widget will then be embedded on your WordPress site.

Introduction Next step

If you don't have a configured chatbot widget yet, follow the instructions below. If you already have a configured widget, you can go directly to step 2.

Detailed widget configuration guide: Full chatbot widget configuration guide is available on page Widget configuration guide. We recommend opening this guide in a new tab and following it to configure the widget before continuing with WordPress integration.

After configuring the chatbot widget according to the guide, return to this page to continue the WordPress integration process.

2

Going to WordPress admin panel

After configuring the chatbot widget, the next step is to go to the WordPress admin panel, where we will install the dedicated plugin.

Previous step Next step

Detailed instructions:

  1. Open a web browser and go to your WordPress admin panel address. Usually it is https://yourdomain.com/wp-admin/ or https://yourdomain.com/wp-login.php.
  2. Log in to the admin panel using your credentials (username and password).
  3. After logging in, you will be redirected to the WordPress Dashboard, which is the main admin panel.
Administrator privileges: To install a plugin, you need an account with administrator privileges. If you log in as a user with privileges lower than administrator (e.g. editor, author), you may not have access to plugin installation. In such case, ask the site administrator for help.
3

AI Chat Widget plugin installation

In this step, we will install the dedicated AI Chat Widget plugin, which will enable chatbot integration with your WordPress site.

Previous step Next step

Detailed instructions:

  1. In the WordPress sidebar find the option Plugins and click on it.
  2. In the Plugins section, click the button Add New located at the top of the page.
  3. Click the button Upload Plugin located at the top of the screen on the left side.
  4. Download the AI Chat Widget plugin by clicking the button below:
Download AI Chat Widget Plugin
  1. After downloading the ZIP file, return to the WordPress panel and click the button Choose File.
  2. Select the downloaded AI Chat Widget plugin ZIP file.
  3. Click the button Install Now.
  4. After installation is complete, click the button Activate Plugin.
Plugin installation in WordPress
Plugin installation screen in WordPress
Security tip: Always download plugins from trusted sources. Our AI Chat Widget plugin is safe and regularly updated to ensure compatibility with the latest WordPress versions.

Solving common installation problems:

Error: "Maximum file size exceeded"

This error occurs when the plugin file size exceeds the limit set on the server.

Solution:

  1. Contact the server administrator and ask to increase the upload_max_filesize limit in the php.ini file.
  2. Alternatively, you can install the plugin manually via FTP:
    • Extract the downloaded ZIP file on your computer
    • Connect to the server via FTP
    • Go to the wp-content/plugins/ directory
    • Upload the extracted plugin folder
    • Return to WordPress panel and activate the plugin in the Plugins section
Error: "Cannot create directory"

This error occurs when WordPress does not have sufficient write permissions in the plugins directory.

Solution:

  1. Contact the server administrator and ask to grant appropriate permissions to the wp-content/plugins/ directory.
  2. Typical permissions for the plugins directory are 755 (rwxr-xr-x).
  3. Alternatively, install the plugin manually via FTP as described above.
Plugin was installed but is not visible

Sometimes a plugin may be installed but does not appear on the plugin list.

Solution:

  1. Refresh the page with the plugin list.
  2. Check if the plugin is not hidden on subsequent pages of the list (if you have many plugins).
  3. Use the search function on the plugins page to find "AI Chat Widget".
  4. If the plugin is still not visible, try clearing the browser cache or logging in to the WordPress panel again.
4

Getting the embed code

After installing the plugin, we need to copy the chatbot embed code from our platform, which we will then paste into the WordPress plugin configuration.

Previous step Next step

Detailed instructions:

  1. Open a new tab in the browser and log in to your account on the AI Chatbot platform.
  2. Go to the section Dashboard in the navigation panel.
  3. Find the previously configured chatbot widget and click Options and then Embed Code.
  4. A window will appear with the JavaScript code for embedding the chatbot.
  5. Click the button Copy or select all the code and copy it to the clipboard (Ctrl+C or Cmd+C).
Window with chatbot embed code
Window with chatbot embed code
5

Plugin configuration in WordPress

Now we will return to the WordPress panel to configure the AI Chat Widget plugin and paste the copied embed code.

Previous step Next step

Detailed instructions:

  1. Return to the WordPress admin panel.
  2. In the sidebar menu find the newly added option AI Chat Widget and click on it. If you don't see this option, you can find the plugin by going to the Plugins section, then to Installed Plugins and searching for the plugin by name "AI Chat Widget". For the plugin to be visible in the sidebar menu, you need to click the Activate button.
  3. You will be redirected to the AI Chat Widget plugin configuration page.
  4. On the plugin configuration page find the section Chatbot embed code.
  5. Click the button Edit code and paste the previously copied embed code (Ctrl+V or Cmd+V). Confirm the entered script by clicking the Apply Changes button.
  6. Click the button Save Changes at the bottom of the page to save the changes.
AI Chat Widget plugin configuration page
AI Chat Widget plugin configuration page
Note: Make sure the code has been pasted in its entirety and without any additional characters. Any code modifications may cause the chatbot to not work properly.
6

Selecting pages to display chatbot

In this step, we will configure on which pages and subpages of your WordPress site the chatbot should be displayed.

Previous step Next step

Detailed instructions:

  1. On the AI Chat Widget plugin configuration page, scroll down to the section Display settings.
  2. Here you will find options to select pages where the chatbot should be displayed:
    • On all pages - the chatbot will be displayed on every page and subpage of your site
    • Only on homepage - the chatbot will be displayed only on the homepage
    • On selected pages - the chatbot will be displayed on all checked pages
  3. Select the appropriate option according to your preferences.
  4. If you selected the option On selected pages, a list of your site pages will appear. Check the appropriate pages according to your preferences.
  5. After making your selection, click the button Save Changes, to confirm the configuration.
Strategic chatbot placement: Consider strategically on which pages the chatbot will be most useful. For example, contact pages, product pages, and FAQ pages are typical places where users often need help. At the same time, on some pages (e.g. privacy policy, terms of use) the chatbot may not be necessary.
Tip: You can always change these settings later. It's worth starting by placing the chatbot on key pages and monitoring user interactions. Based on collected data, you can later optimize the chatbot placement.
7

Integration testing

After configuring all necessary elements, it's time to test the integration and make sure the chatbot works as expected on your WordPress site.

Previous step Next step

Detailed testing instructions:

  1. Chatbot visibility test:
    • Open your WordPress site in a new browser tab
    • Go to one of the pages where you configured chatbot display
    • Check if the chatbot icon is visible in the right place (usually in the bottom right corner)
    • If you don't see the icon, refresh the page (sometimes this is necessary after the first installation)
  2. Chatbot interaction test:
    • Click on the chatbot icon to open it
    • Make sure the chatbot opens correctly and displays a welcome message
    • Send a test message, e.g. "Hello" or "Good morning"
    • Check if the chatbot responds to the message
  3. Test on different pages:
    • Go to other pages of your site to check if the chatbot appears according to configuration
    • Check both pages where the chatbot should be visible and those where it should not appear
  4. Test on different devices:
    • Check how the chatbot looks and works on a mobile device (you can use browser developer tools to simulate a mobile device)
    • Make sure the chatbot is useful and does not interfere with using the site on a small screen
Testing tip: It is recommended to test the chatbot in the browser's incognito mode or clear the browser cache before testing. This way you can be sure that the chatbot works correctly for new users.
8

Rate Limiting

Rate limiting is a mechanism that limits the number of messages a user can send to the chatbot in a specific time. This protects the system from excessive load and ensures fair use of resources.

Previous step Next step

How Rate Limiting works:

  • Limit per user: Each user has their own limit (not shared with others)
  • Time window: 60 seconds
  • Automatic reset: Counter resets every minute
  • Configurable limit: Each user can have a different limit set by the administrator

What this means for users:

When a user reaches their message limit within a minute, the chatbot will display a message informing them of the need to wait before sending another message. After a minute from the first message in the given time window, the counter automatically resets.

Rate limiting and service quality: Rate limiting does not affect the quality of user service during normal usage. Standard limits are set at a level that allows natural conversations while protecting against automated attacks or excessive system usage.

Increasing rate limiting limits:

If the standard rate limiting limits are not sufficient for your use case (e.g. for chatbots with very high traffic or specialized applications), you can request an increase.

How to increase limits: To increase rate limiting limits for your chatbot, contact ChatbotAssistant site administration. In the message describe your use case, expected traffic, and justification for higher limits.
9

Troubleshooting

Despite carefully completing all integration steps, sometimes problems with chatbot operation may occur. In this section we present solutions to the most common problems.

Previous step Return to table of contents

Common problems and their solutions:

Chatbot does not appear on the page

Possible causes:

  • The embed code was not correctly pasted or saved
  • Plugin is not active
  • Conflicts with other plugins or WordPress theme
  • Display settings exclude the current page
  • Browser cache or WordPress caching system problems

Solution:

  1. Make sure the AI Chat Widget plugin is active in the Plugins section
  2. Check if the embed code was pasted correctly in the plugin configuration
  3. Verify display settings and make sure the chatbot is configured to display on the page you are testing
  4. Clear browser cache and refresh the page
  5. If you use a caching plugin (e.g. WP Super Cache, W3 Total Cache), clear the page cache
  6. Temporarily disable other plugins to check if they are causing a conflict
Chatbot is visible but does not respond to messages

Possible causes:

  • Problems with connection to chatbot server
  • Errors in chatbot configuration on AI Chatbot platform
  • Expired access token or incorrect chatbot identifier
  • Browser blocks (e.g. script blocking, Same-Origin policy)

Solution:

  1. Open the browser developer console (F12 or Ctrl+Shift+I) to check for JavaScript errors
  2. Log in to AI Chatbot platform and make sure the chatbot is active and working properly in the test environment
  3. Generate new embed code on the platform and update it in the plugin configuration
  4. Disable browser extensions that may block scripts (e.g. adblocker, tracking blockers)
  5. Check if your site uses HTTPS - the chatbot may require a secure connection
Chatbot looks incorrect on the page

Possible causes:

  • Conflicts with WordPress theme styles
  • Responsive problems on mobile devices
  • Custom CSS modifications on the page
  • Incompatible JavaScript library versions

Solution:

  1. Check if the chatbot looks incorrect only on specific pages or on the entire site
  2. Use browser developer tools to identify CSS conflicts
  3. Contact the theme creator if you suspect the theme is causing problems
  4. Check the jQuery version used by your site - some older themes may use outdated versions
After WordPress update chatbot stopped working

Possible causes:

  • Plugin incompatibility with new WordPress version
  • Changes in script loading method in new WordPress version
  • Cache problems after update
  • Errors in WordPress update

Solution:

  1. Check if the AI Chat Widget plugin is up to date - it may require an update to the latest version
  2. Clear all buffers and cache after WordPress update
  3. Disable and re-enable the AI Chat Widget plugin
  4. Check if new errors appear in the browser developer console
  5. Download the latest version of the plugin from our site and install it again
  6. If the problem persists, contact our support team
Technical support: If you encounter problems that you cannot solve on your own, contact our technical support team. Prepare a detailed problem description, error screenshots, and information about your WordPress version and used theme to speed up the problem-solving process.