How to install the web messenger on your website

The AskHandle web messenger lets website visitors chat with your AI agent directly from your website. Once installed, your AI agent can answer questions, guide visitors, collect information, and help customers even when your team is not available.

Installing the web messenger is simple. You only need to copy the installation code from AskHandle and paste it into your website before the closing </body> tag.

Before you start

Before you can install the web messenger, your AI agent must be live.

This means you need to publish your AI agent first. If your agent is still in draft mode, the web messenger installation code may not be ready to use yet.

Step 1: Publish your AI agent

Go to your AskHandle portal and make sure your AI agent is published.

Once published, your agent is live and ready to be connected to your website.

Step 2: Open Manage Live Agent

After your AI agent is live, click Manage Live Agent at the top of your AskHandle portal.

This opens the area where you can manage the live version of your AI agent, including where and how it appears to customers.

Step 3: Go to Web Messenger

Inside Manage Live Agent, look at the top-left side of the page.

Click Web Messenger.

This section contains the installation code you need to add the web messenger to your website.

Step 4: Copy the installation code

In the Web Messenger section, you will see the installation code on the left side of the page.

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 may include a different widget ID. Always copy the code from your own AskHandle portal.

Step 5: Paste the code into your website

Paste the installation code into your website before the closing </body> tag.

The closing body tag usually looks like this:

html

1</body>

Your code should be placed right above it, like this:

html

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

Step 6: Save and publish your website changes

After you paste the code, save your website changes.

If your website builder has a Publish, Update, or Save changes button, make sure to click it so the web messenger appears on the live website.

Step 7: Test the web messenger

Open your website in a browser and check that the web messenger appears.

If you do not see it right away, try refreshing the page or opening the website in a private or incognito browser window.

Then send a test message to confirm your AI agent responds correctly.

Where should I paste the code?

The code should be added before the closing </body> tag of your website.

Many website builders have a place for adding custom code, scripts, or footer code. The exact location depends on the platform you use, such as WordPress, Shopify, Wix, Squarespace, Webflow, or a custom-built website.

If you are not sure where to add the code, send the installation code to your website developer or the person who manages your website and ask them to paste it before the closing </body> tag.

Why install the web messenger?

Installing the AskHandle web messenger helps your business:

Answer common customer questions automatically
Guide visitors to the right product, service, or next step
Capture leads from your website
Help customers outside normal business hours
Reduce repetitive support work for your team

Once the web messenger is installed, your AI agent becomes available directly on your website so visitors can get help without needing to call, email, or wait for a response.

Troubleshooting

I do not see the installation code

Make sure your AI agent is published and live. Then click Manage Live Agent and open Web Messenger again.

I pasted the code, but the web messenger does not appear

Check that the code was pasted before the closing </body> tag and that your website changes were published.

You can also try refreshing your browser, clearing your cache, or opening your website in an incognito window.

I am not comfortable editing website code

That is completely okay. Copy the installation code and send it to your website developer or website administrator. Ask them to add it before the closing </body> tag on your website.