Add your mate to a Wix site

Wix has no plugin runtime, so AI Assistant reaches a Wix site through the universal embed — and which plan your site is on decides whether that embed can run at all. A Wix Premium site unlocks Settings → Custom Code: one paste, every page, every visitor. A free wixsite.com site does not run third-party scripts: Wix ships every free site with its own renderer flag shouldLoadAllExternalScripts: false, so an Embed HTML element, a Custom Element and a Velo-injected tag all stay inert there no matter how they are added. That is Wix's policy, not a limit of the embed.

Before you start

• A Wix site on a Premium plan, published. (A free wixsite.com site can still use the hosted chat page below, but not the on-page widget.)
• Your workspace open in the Console.
• The one script tag from your Console connection settings.

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, link to your hosted chat page instead — https://<your-workspace-slug>.busymate.ai/chat — from a button or the site menu. It is the same assistant, the same knowledge and the same Inbox; it opens as its own page rather than as a bubble on yours. Upgrading the site to Premium later turns the paste above on 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

• The widget never appears on a free site — this is expected and not fixable from your side. Confirm it the same way we did: open the published page, run performance.getEntriesByType('resource').filter(r => r.name.includes('busymate')) in the console (empty on a free site, however the embed was added) and search the page source for shouldLoadAllExternalScripts — a free site reports false. Premium's Custom Code loads 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.