AskHandle

Setup & Channels

How to install Web Messenger on a Squarespace website

Updated May 16, 2026

AskHandle Web Messenger lets website visitors start a conversation with your AI agent directly from your Squarespace website.

To install it, you only need to copy the Web Messenger installation code from AskHandle and paste it into the Footer field inside Squarespace Code Injection. This places the messenger before the closing </body> tag, which is the correct place for the AskHandle widget code.

Before you start

Make sure you have:

  • A published AskHandle AI agent
  • Access to your Squarespace website admin area
  • A Squarespace plan that supports Code Injection

Note: Squarespace Code Injection is available on supported paid plans. If you do not see the Code Injection option, your current Squarespace plan may not include it.

Step 1: Publish your AI agent in AskHandle

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

  1. Log in to your AskHandle account.
  2. Open the AI agent you want to add to your website.
  3. Make sure the agent is published and live.

If the agent is not live yet, publish it first. The Web Messenger installation code is meant for the live version of your AI agent.

Step 2: Open Manage Live Agent

Once 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 and its connected channels.

Step 3: Open Web Messenger

Inside Manage Live Agent:

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

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

Step 4: Copy the installation code

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

  1. Click Copy Code.
  2. Keep this code ready. You will paste it into Squarespace in the next step.

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 exact code may be different. Always copy the code directly from your own AskHandle account.

Step 5: Open Code Injection in Squarespace

Now go to your Squarespace website admin area.

  1. Log in to Squarespace.
  2. Open the website where you want to install Web Messenger.
  3. In the main menu, click Website.
  4. Click Website Tools.
  5. Click Code Injection.

Depending on your Squarespace version, you may also find Code Injection under Settings or Advanced.

Step 6: Paste the code into the Footer field

In the Squarespace Code Injection page:

  1. Find the Footer field.
  2. Paste your AskHandle Web Messenger installation code into the Footer field.
  3. Click Save.

Do not paste the code into the Header field. The Web Messenger code should be added to the Footer field because Squarespace injects footer code before the closing </body> tag.

Step 7: Check your website

After saving your changes:

  1. Open your live Squarespace website in a new browser tab.
  2. Refresh the page.
  3. Look for the AskHandle Web Messenger chat icon on your website.
  4. Click the chat icon and send a test message.

If the messenger appears and your AI agent replies, the installation is complete.

Troubleshooting

I do not see Code Injection in Squarespace

Your Squarespace plan may not support Code Injection. Check your Squarespace plan or ask your website admin to help.

I pasted the code, but the messenger does not appear

Try these steps:

  1. Confirm that your AskHandle AI agent is published and live.
  2. Make sure the code was pasted into the Footer field, not the Header field.
  3. Click Save again in Squarespace.
  4. Open your website in a private or incognito browser window.
  5. Clear your browser cache and refresh the page.

The messenger appears on some pages but not others

If you pasted the code into the site-wide Footer field in Code Injection, it should appear across your website. If it only appears on one page, you may have added the code to a single page instead of the site-wide Code Injection area.

My website is managed by someone else

Send your website manager the installation code from AskHandle and ask them to paste it into the Squarespace Code Injection > Footer field.

You can send them this note:

Please add this AskHandle Web Messenger installation code to the Squarespace Code Injection Footer field. It should be placed before the closing </body> tag and saved site-wide.

What happens after installation?

Once installed, your AskHandle Web Messenger will appear on your Squarespace website. Visitors can use it to ask questions, get help, and interact with your AI agent without leaving your site.

This makes it easier for customers to get answers quickly and helps your business support more visitors automatically.

← Back to Help Center