SmartAlex Documentation - AI Voice Assistant Platform

Once you’ve configured a widget in Widget Studio, installing it is one script tag. Your data-tenant-id value is shown in the widget code panel inside SmartAlex, or ask your AI assistant for it through the MCP tool.

Basic install

Add the widget script to your site and place it just before the closing </body> tag:

<!-- SmartAlex Widget -->
<script
  src="https://api.getsmartalex.com/storage/v1/object/public/widget-assets/smartalex-widget.js"
  data-tenant-id="YOUR_TENANT_ID"
  async>
</script>

That’s the whole install. The widget reads your published configuration (variant, colours, agent) at load time, so you can restyle it in Widget Studio later without touching your site again.

Platform guides

WordPress

Theme editor:

Go to Appearance → Theme Editor.
Select footer.php.
Paste the widget code before </body>.
Click Update File.

Or with a headers-and-footers plugin:

Install and activate a plugin like “Insert Headers and Footers”.
Go to Settings → Insert Headers and Footers.
Paste the code into the “Scripts in Footer” section.

Shopify

Go to Online Store → Themes.
Click Actions → Edit code.
Open theme.liquid.
Paste the widget code before </body>.
Click Save.

Wix

Open your Wix Editor.
Click Add → Embed Code → Custom Embeds.
Select Embed a Widget.
Paste the widget code.
Position the widget and publish.

Squarespace

Go to Settings → Advanced → Code Injection.
Paste the widget code in the Footer section.
Click Save.

React / Next.js

Add the script from your root layout or app component:

import { useEffect } from 'react';

export default function Layout({ children }) {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = 'https://api.getsmartalex.com/storage/v1/object/public/widget-assets/smartalex-widget.js';
    script.setAttribute('data-tenant-id', 'YOUR_TENANT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      document.body.removeChild(script);
    };
  }, []);

  return <>{children}</>;
}

Troubleshooting

Widget not appearing

Calls not connecting

Verify the widget’s agent is active.
Check that microphone permissions are granted in the browser.
Test in an incognito window to rule out extensions.
Try a different browser.

Back to Widget Studio

Configure the variant, appearance, and behaviour before you install.

Widgets Integrations

​Basic install

​Platform guides

​Troubleshooting

Back to Widget Studio

Basic install

Platform guides

Troubleshooting