Skip to main content

​
Embedding & Configuration

At minimum, set chatbotId and domain on the script tag. Styling and behavior are managed from the Homie dashboard and pulled in automatically by the embed. 
<script
  src="https://chat.yourhomie.ai/embed.min.js"
  chatbotId="YOUR-CHATBOT-ID"
  domain="https://chat.yourhomie.ai"
  defer
></script>

​
Style Settings

Optionally managed via your Homie style settings (fetched by the script):
  • iconColor, iconRounded, iconImage, iconSize, iconImagePadding
  • iconBottomPadding, iconSidePadding, iconAlign (left | right)
  • shadowHostZIndex (set higher to keep the embedded chat above sticky menus/badges)
  • showHoverText, isPrivate, active

​
User Configuration

Advanced: Some customers provide window.homieUserConfig to pass user_id, user_hash, and user_metadata. The embed forwards these safely to the iFrame (Base64‑encoded metadata).