Add your mate to a Wix site

Wix reaches AI Assistant one of two ways, and your plan decides which one you need. A Wix Premium site unlocks Settings → Custom Code: one paste, every page, every visitor. A free wixsite.com site refuses scripts you paste in yourself — Wix ships every free site with the renderer flag shouldLoadAllExternalScripts: false, which leaves an Embed HTML element, a hand-added Custom Element and a Velo-injected tag all inert. What still runs there is a widget that belongs to an installed app: Wix whitelists an installed app's own components (widgetsToRenderOnFreeSites) and loads their scripts normally. So on a free site you add the assistant as the app's site widget, not as a script tag.

Before you start

• A published Wix site — the free plan is enough for the app's site widget; Premium for the one-paste Custom Code route.
• 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:

   htmlCopy

   <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, install the AI Assistant app instead of pasting anything: in your site dashboard open Manage apps → AI Assistant → Open in Editor, click Add to Site in the panel that opens, then Save and Publish. The widget lands on your homepage and the chat bubble appears for real visitors — verified on a free wixsite.com site, where busymate.ai/embed/v1.js loads and the bubble renders. Upgrading to Premium later adds the every-page Custom Code route with no other change.

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:

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')) on the published page — empty, however the tag was added). Use the app's site widget on a free plan, or Custom Code on Premium; both load unconditionally.
• 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

• Teach your assistant your own content — your Wix pages, crawled and cited.
• Recognize signed-in customers — the getIdentity bridge for Wix Members.
• Set up human handoff — staff the Inbox before visitors start asking to talk to someone.