AskHandle

Setup & Channels

How to install Web Messenger on WordPress

Updated May 16, 2026

AskHandle Web Messenger lets visitors chat with your AI agent directly from your WordPress website. Once installed, the messenger appears on your site so customers can ask questions, get help, and move forward without waiting for a manual reply.

This guide shows you how to add the Web Messenger installation code to a WordPress website.

Before you start

Make sure you have:

  • Access to your AskHandle account
  • Access to your WordPress admin dashboard
  • Permission to install plugins or add custom code to your WordPress website
  • A published AskHandle AI agent

Your Web Messenger installation code is only available after your AI agent is live. If your agent is still in draft mode, publish it first.

Step 1: Publish your AI agent in AskHandle

Before you install Web Messenger, your AI agent needs to be live.

  1. Log in to AskHandle.
  2. Open the AI agent you want to add to your website.
  3. Review the agent to make sure it is ready for customers.
  4. Publish the agent.

Once the agent is published, you can access the live agent settings.

Step 2: Open Manage Live Agent

After your AI agent is live:

  1. Go to the top of your AskHandle portal.
  2. Click Manage Live Agent.

This opens the area where you manage the live version of your AI agent.

Step 3: Open Web Messenger

Inside Manage Live Agent:

  1. Look at the top-left side of the page.
  2. Click Web Messenger.

This section contains the code you need to install the messenger on your website.

Step 4: Copy your installation code

In the Web Messenger section, you will see an Installation Code box.

  1. Find the installation code on the left side of the page.
  2. Click Copy Code.

The code will look similar to this:

html
1<script src="https://agent.askhandle.com/widget.js"></script>
2<script>
3  AIAgentWidget.init({ widgetId: 'your-widget-id' });
4</script>

Your actual code will include your own widget ID. Do not change the code unless AskHandle support asks you to.

Step 5: Install a header and footer code plugin in WordPress

WordPress does not always include a built-in place to paste custom website scripts. For most business users, the easiest option is to use a trusted header and footer code plugin.

A common option is a plugin such as WPCode – Insert Headers and Footers. You may also use another trusted plugin if your website already has one installed.

To install a plugin:

  1. Log in to your WordPress admin dashboard.
  2. In the left menu, go to Plugins.
  3. Click Add New Plugin.
  4. Search for a header and footer code plugin, such as WPCode.
  5. Click Install Now.
  6. Click Activate.

If your website is hosted on WordPress.com and you do not see the option to install plugins, your plan may not support plugin installation. In that case, contact your website administrator, web developer, or WordPress.com support.

Step 6: Paste the AskHandle code before the closing body tag

After the plugin is active:

  1. Open the plugin settings in WordPress.
  2. Look for an area named Footer, Body, Before closing body tag, or Scripts in Footer.
  3. Paste the AskHandle installation code into that footer/body section.
  4. Save your changes.

The important part is that the AskHandle code should be added before the closing </body> tag. In many WordPress plugins, this is the same as adding the code to the footer scripts area.

Step 7: Publish or update your website

After saving the code:

  1. Clear your website cache if your WordPress site uses a caching plugin.
  2. Open your website in a new browser tab.
  3. Refresh the page.
  4. Look for the AskHandle Web Messenger on your website.

If the messenger appears, the installation is complete.

Step 8: Test the messenger

Before sending customers to your website, test the messenger yourself.

Try asking a few common customer questions, such as:

  • What services do you offer?
  • What are your hours?
  • How can I contact your team?
  • How do I book or request help?

This helps confirm that the messenger is installed correctly and that your AI agent is answering the way you expect.

Troubleshooting

I do not see the Web Messenger on my website

Try these steps:

  1. Make sure your AI agent is published in AskHandle.
  2. Confirm that you copied the full installation code.
  3. Make sure the code was pasted into the footer/body area, not inside a regular page content block.
  4. Save the plugin settings again.
  5. Clear your WordPress cache.
  6. Refresh your website in a private or incognito browser window.

I pasted the code, but nothing changed

Some WordPress websites use caching, optimization, or security plugins that delay or block new scripts from loading.

Try clearing your cache from:

  • Your WordPress caching plugin
  • Your hosting provider dashboard
  • Your browser
  • Your CDN, if you use one

Then reload your website.

I cannot install plugins in WordPress

You may not have the right WordPress permissions, or your WordPress.com plan may not allow plugin installation.

Ask your website owner, administrator, or developer to install the code for you. Send them the AskHandle installation code and ask them to place it before the closing </body> tag on every page of the website.

The messenger appears on some pages but not others

Make sure the code was added site-wide, not only to one page or one template. The Web Messenger should be added globally so visitors can access it from any page on your website.

Best practices

  • Install the code site-wide so customers can reach your AI agent from every page.
  • Do not paste the code multiple times. One installation is enough.
  • Do not edit the widget ID or script URL.
  • Test the messenger after installing it.
  • Recheck the installation after changing WordPress themes or major website plugins.

Why install Web Messenger on WordPress?

Adding AskHandle Web Messenger to your WordPress website helps your business respond faster to website visitors. Instead of making customers search through pages or wait for a reply, your AI agent can answer questions directly on the site.

This can help your business:

  • Answer questions automatically
  • Guide visitors to the right service or next step
  • Reduce repeated support messages
  • Capture more interest from website visitors
  • Give customers help outside normal business hours
← Back to Help Center