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)
-
Go to Settings → Custom Code in your Wix dashboard.
-
Add Code Snippet, paste:
html<script src="https://busymate.ai/embed/v1.js" data-assistant="<your-workspace-slug>" data-label="Ask us" async></script> -
Set it to load on All pages, placement Body — end. Save, then Publish.
-
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:
claude mcp add --transport http busymate-ai https://busymate.ai/mcpTroubleshooting
- A pasted script tag never appears on a free site — expected, and not fixable from your side: a free site reports
shouldLoadAllExternalScripts: falsein its page source and never fetches the loader (check withperformance.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 —
getIdentitymust be defined and resolved before the embed script tag runs; test it withwindow.BusymateAI.getIdentity()in the browser console.
Verify
- Open your published site in a private window: the chat bubble appears and answers from your own pages, with citations.
- 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.
- 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
getIdentitybridge for Wix Members. - Set up human handoff — staff the Inbox before visitors start asking to talk to someone.
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
asyncand 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-memberstowindow.BusymateAI.getIdentityin your site's Velo code — see Recognize signed-in customers.