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)
  • 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).