Skip to main content

​
Troubleshooting

  • window.homieBot is undefined → Ensure the script actually loads (Network tab) and use waitForHomie().
  • No response to sendMessage → Check if the site blocks iFrames, uses strict CSP, or delays third‑party scripts. Also, wait for document.readyState === "complete".
  • Chat opens but no replies → Verify API base access depending on the domain (api.yourhomie.ai, staging.api.yourhomie.ai, dev.api.yourhomie.ai).
  • Checkout specific → The embed preloads the iFrame automatically when a configured checkoutUrl matches. Verify exact URLs during testing.

​
FAQ

Can I force a new conversation?
Yes: sendMessage({ text: "...", newChat: true }). How are question events tracked?
If setId (and optionally questionId) are provided, the script sends a fire‑and‑forget tracking call to the public endpoint in the background. This does not affect the message injection itself. Can I query the state without opening the chat?
Yes, isOpen() returns the state and does not alter the UI.