Install the Convo AI Chat Widget on WordPress

Copy the Convo AI embed code from the dashboard and add it to your WordPress site header with a code-snippet plugin or your theme. Works with any WordPress theme.

2 min read

The Convo AI widget is one script tag. Add it to the <head> of your WordPress site and the chat bubble appears on every page.

Step 1: Get your embed code#

  1. Sign in to Convo AI.
  2. Open Engage → Chat Widgets.
  3. Set your Widget Name and Website Domain, then save the widget. Saving creates the widget's API key.
  4. In the Embed Code card ("Add this code to your website"), click copy.

The code looks like this. Always copy yours from the dashboard, because it contains your own API key and server address:

<!-- ConvoAI Chat Widget SDK -->
<script src="YOUR_SDK_URL/convoai-chat.js" data-api-key="YOUR_API_KEY" data-base-url="YOUR_BASE_URL" async></script>

Step 2: Add the code to WordPress#

Pick one of these methods. You only need one.

This keeps the code in place when you change or update your theme.

  1. In WordPress, go to Plugins → Add New.
  2. Install and activate a plugin that adds code to the site header, such as WPCode or Insert Headers and Footers.
  3. Open the plugin's header settings, paste the embed code into the Header box and save.

Option B: Your theme's header file#

Use this only with a child theme, because a theme update replaces header.php.

  1. Go to Appearance → Theme File Editor and open header.php of your child theme.
  2. Paste the embed code just before the closing </head> tag.
  3. Click Update File.

Option C: Your theme's custom code setting#

Many themes and page builders have a field for header scripts (often under the theme options or Customize). Paste the embed code there and save.

Step 3: Check the widget#

  1. Open your site in a private browser window.
  2. The chat bubble appears in the position set in Engage → Chat Widgets.
  3. Send a test message. It shows up in the Convo AI Inbox.

If you use a caching or optimisation plugin, clear its cache after adding the code. If the bubble does not appear, see Troubleshooting.

Customise the widget#

Change these in Engage → Chat Widgets, with no WordPress edits:

Tab Settings
Appearance Primary and secondary colour, widget position, light, dark or auto colour scheme, widget size
Messages Greeting message, offline message, suggested questions, auto-open and its delay
Identity Ask for name, email and phone: off, optional or required
Hours Business hours and timezone
Advanced Show agent typing, widget active on or off

Next step#

Selling with WooCommerce? Connect your store so conversations can use order and customer data.

Was this page helpful?