Installation Guide

Get Aqoiy running on your platform in under 10 minutes.

WordPress / WooCommerce

Full plugin integration — installs in two clicks and connects automatically.

1Download the plugin

Grab the latest Aqoiy AI Customer Support plugin ZIP file.

Get from WordPress.org →

2Install in WordPress

  1. Go to WordPress Admin → Plugins → Add New
  2. Click Upload Plugin
  3. Choose the downloaded ZIP file
  4. Click Install Now then Activate

3Connect to Aqoiy

  1. Go to AI Chatbot → Settings in your sidebar
  2. Click Create Account or Sign In
  3. Follow the setup wizard
  4. Your AI agent is live! 🎉
Need help? Contact us at support@aqoiy.com

Shopify

Add the Aqoiy embed widget to your Shopify theme in 3 steps.

1Create your Aqoiy account

Sign up free and select Shopify as your platform.

Get Started Free →

2Get your embed code

After registration, copy your embed code from the dashboard. It looks like this:

<script>
  window.AqoiyConfig = { storeId: 'YOUR_STORE_ID', apiKey: 'YOUR_API_KEY' };
</script>
<script src="https://aqoiy.com/widget.js" async></script>

3Add to Shopify

  1. Go to Online Store → Themes
  2. Click Edit code on your active theme
  3. Open layout/theme.liquid
  4. Paste your code just before the </body> tag
  5. Click Save
Need help? Contact us at support@aqoiy.com

Wix

Add the Aqoiy widget to any Wix site via Custom Code.

1Create your Aqoiy account

Sign up free and select Wix as your platform.

Get Started Free →

2Get your embed code

Copy your snippet from the Aqoiy dashboard.

<script>
  window.AqoiyConfig = { storeId: 'YOUR_STORE_ID', apiKey: 'YOUR_API_KEY' };
</script>
<script src="https://aqoiy.com/widget.js" async></script>

3Add to Wix

  1. Go to Settings → Custom Code
  2. Click + Add Custom Code
  3. Paste your embed code
  4. Set Add Code to Pages: All pages
  5. Set Place Code in: Body — end
  6. Click Apply
Need help? Contact us at support@aqoiy.com

Squarespace

Drop the Aqoiy widget into Squarespace with Code Injection.

1Create your Aqoiy account

Sign up free and select Squarespace as your platform.

Get Started Free →

2Add to Squarespace

  1. Go to Settings → Advanced → Code Injection
  2. Paste your embed code in the Footer section
  3. Click Save
<script>
  window.AqoiyConfig = { storeId: 'YOUR_STORE_ID', apiKey: 'YOUR_API_KEY' };
</script>
<script src="https://aqoiy.com/widget.js" async></script>
Need help? Contact us at support@aqoiy.com

BigCommerce

Install via the BigCommerce Script Manager.

1Create your Aqoiy account

Sign up free and select BigCommerce as your platform.

Get Started Free →

2Add to BigCommerce

  1. Go to Storefront → Script Manager
  2. Click Create a Script
  3. Name: Aqoiy Chat Widget
  4. Location: Footer
  5. Paste your embed code
  6. Click Save
<script>
  window.AqoiyConfig = { storeId: 'YOUR_STORE_ID', apiKey: 'YOUR_API_KEY' };
</script>
<script src="https://aqoiy.com/widget.js" async></script>
Need help? Contact us at support@aqoiy.com

React / Next.js

Mount the widget once at the app root with a simple useEffect.

1Create your Aqoiy account

Sign up free and select React / Next.js as your platform.

Get Started Free →

2Add to your app

Drop this into your _app.tsx (Pages Router) or root layout.tsx (App Router):

useEffect(() => {
  window.AqoiyConfig = {
    storeId: 'YOUR_STORE_ID',
    apiKey:  'YOUR_API_KEY'
  };
  const script = document.createElement('script');
  script.src = 'https://aqoiy.com/widget.js';
  script.async = true;
  document.body.appendChild(script);
  return () => {
    document.body.removeChild(script);
  };
}, []);

For Next.js App Router, wrap this in a client component ('use client') since it uses browser APIs.

Need help? Contact us at support@aqoiy.com

HTML / Any website

Two script tags. That's the entire installation.

1Create your Aqoiy account

Sign up free and select HTML / Static site as your platform.

Get Started Free →

2Add to your website

Paste this snippet just before the closing </body> tag on every page where the widget should appear:

<script>
  window.AqoiyConfig = {
    storeId: 'YOUR_STORE_ID',
    apiKey:  'YOUR_API_KEY'
  };
</script>
<script src="https://aqoiy.com/widget.js" async></script>

Works with any static site generator — Hugo, Jekyll, Astro, plain HTML, or anything that lets you edit the page template.

Need help? Contact us at support@aqoiy.com