Skip to content
AI Assistant

Guides

Add your mate to a Wix site

Add the embed via Custom Code on Premium or an Embed HTML element on the free plan, let it learn your pages, and recognize signed-in Members.

On this page

The released AI Assistant connection for Wix uses Settings → Custom Code on a Wix Premium site with a connected domain. Copy the embed script from your Console and publish it on your site. A site-widget app has been demonstrated on a free Wix site, but that demonstration is not a public installation path. For free-site app access, contact us.

Before you start

  • A published Wix Premium site with a connected domain.
  • Your workspace open in the Console.
  • The one script tag from your Console connection settings (Custom Code route only).

1. Add the embed (Wix Premium)

  1. Go to Settings → Custom Code in your Wix dashboard.

  2. Add Code Snippet, paste:

    html
    <script src="https://busymate.ai/embed/v1.js" data-assistant="<your-workspace-slug>" data-label="Ask us" async></script>
  3. Set it to load on All pages, placement Body — end. Save, then Publish.

  4. Open the published page (not the Editor preview) in a private window and confirm the chat bubble appears.

On a free Wix site, contact us about site-widget app access. Do not assume a public app installation is available because the demo works.

2. Teach it your content

Point a website source at your own Wix URL — the same crawler every connection uses, reading your published pages and citing back to the page an answer came from.

3. Recognize signed-in visitors

Wix's Members Area is a client-side feature (Velo's wix-members API), so identity has to be bridged from your site's own code rather than a server-side plugin: define window.BusymateAI.getIdentity (see Recognize signed-in customers for the exact shape) inside a Velo page/site code file, before the embed script runs, reading the signed-in member from wix-members client-side.

Manage from any MCP client

Every step above is available from any MCP client on your own account:

bash
claude mcp add --transport http busymate-ai https://busymate.ai/mcp

Troubleshooting

  • A pasted script tag never appears on a free site — expected, and not fixable from your side: a free site reports shouldLoadAllExternalScripts: false in its page source and never fetches the loader (check with performance.getEntriesByType('resource').filter(r => r.name.includes('busymate.ai')) on the published page — empty, however the tag was added). Use Custom Code on Premium. For free-site app access, contact us.
  • It works in the Editor preview but not on the published page — always verify on the actual published URL; the Editor's preview runtime can differ from what a real visitor's browser does with a lazy-loaded element.
  • A signed-in member is still treated as a guest — getIdentity must be defined and resolved before the embed script tag runs; test it with window.BusymateAI.getIdentity() in the browser console.

Verify

  1. Open your published site in a private window: the chat bubble appears and answers from your own pages, with citations.
  2. If you wired identity, sign in as a Wix Member and ask something only a signed-in visitor should see — the reply recognizes that visitor.
  3. Ask it to hand off to a person — the conversation reaches your Inbox.

Next

Questions

Do I need Wix Premium?

Yes, for the released Custom Code connection. For site-widget app access on a free site, contact us; the working demo does not establish general availability.

Why does the widget sometimes take a moment to appear?

The loader is async and the widget mounts after the page settles, so give a published page a second before deciding it isn't there. If it never appears on a free site, check you added it as the app's site widget rather than as a pasted script — see above.

Can I recognize a signed-in Wix Member?

Yes, by bridging wix-members to window.BusymateAI.getIdentity in your site's Velo code — see Recognize signed-in customers.