Skip to main content
The manual method is the universal way to install homie AI. It works on any site that lets you edit HTML: paste the embed script before the closing </body> tag on every page and the chat bubble loads for your shoppers.
Before you start, make sure you have:
  • An assistant created on the platform
  • Your embed script copied from the assistant’s Publish area
  • The ability to edit your site’s HTML

​
Add the embed script

1

Copy your embed script

Open your assistant on the platform, go to its Publish area, and copy the script. It already contains your chatbotId.
Platform Publish area showing the copyable script snippet
2

Paste it before the closing body tag

Add the script just before the closing </body> tag on every page of your site:
Replace YOUR-CHATBOT-ID with your own chatbotId from the platform. Copying the script directly from the Publish area does this for you.
3

Save and verify

Save your file and reload the page in your browser.

​
Optional attributes

The script accepts optional attributes to pass extra context to your assistant:
For programmatic configuration, methods, and events, see the Client API.
With the embed script, you do not need to pass the current page URL manually. The embed sends it to the chat automatically — even when the page changes later.
Reload your site. The homie chat bubble appears in the bottom-right corner. Open it and send a test message.

​
Direct iframe embed

When you intentionally want to render the chat as a dedicated iframe — for example on in-store terminals, kiosks, or inside a controlled app shell — you can skip the embed script and use the chat URL directly:
With a direct iframe, context is appended as regular query parameters:
With a direct iframe URL, currentUrl is only the initial context. If the host page changes later, you need to update the iframe URL yourself. The embed script handles this automatically.

​
Troubleshooting

  • Widget not showing? Check that your chatbotId matches the one on the platform, that the script sits before the closing </body> tag, and that your content security policy allows the embed script from cdn.yourhomie.ai and the chat to load from chat.yourhomie.ai.
  • Script or iframe not loading? Open the browser console and look for network or error messages, and verify the domain in the URL.
  • currentUrl not recognized? Check that the URL is passed in encoded form.
  • Still stuck? See the Client API troubleshooting guide.

​
Next steps

Client API

Configure the widget and call methods from your site.

Troubleshooting

Resolve common installation and runtime issues.