ioZen Docs

Embedding Your Intake Bot

Add your ioZen intake bot to any website. Choose from inline embeds, popups, floating widgets, or a direct shareable link.

Your intake bot is ready. Now put it where your visitors are. ioZen offers three embed types and a direct link so you can capture demand on any platform.

Embed Types

TypeBest ForHow It Works
InlineReplacing an existing form sectionRenders directly inside your page at a specific location
PopupCall-to-action buttons, bannersOpens in a centered modal overlay when triggered
WidgetAlways-available accessFloating button in the corner that expands into a chat panel
Direct LinkSocial media, email, QR codesStandalone page at app.iozen.ai/i/your-bot-slug

Finding Your Embed Code

  1. Open your intake bot in ioZen and click Share
  2. Under Share Method, pick Inline Embed, Popup Modal or Floating Widget
  3. Copy the code. It already carries your bot's slug and any size you set

Each embed type is a ready-to-paste snippet. No build tools or npm packages required. The snippets below are the same code Share gives you, with YOUR_BOT_SLUG in place of your slug.

Inline Embed

Renders the intake bot inside a container on your page. Place the container where you want the bot; the script goes right after it or at the end of the page.

<!-- ioZen Inline Embed -->
<div 
  data-iozen-inline="YOUR_BOT_SLUG"
  style="width: 100%; height: 100%; min-height: 600px; display: flex; flex-direction: column;"
></div>
<script 
  src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
  data-bot="YOUR_BOT_SLUG"
  data-type="inline"
  async
></script>

The bot fills the container. Edit the container's style (width, height) to fit your layout.

Opens the intake bot in a centered modal when the visitor clicks the button.

<!-- ioZen Popup Modal -->
<button data-iozen-popup="YOUR_BOT_SLUG">
  Chat with us
</button>
<script 
  src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
  data-bot="YOUR_BOT_SLUG"
  data-type="popup"
  async
></script>

Any element with data-iozen-popup="YOUR_BOT_SLUG" becomes a trigger. You can have several triggers on the same page.

Widget Embed

A floating button (bottom-right by default) that expands into a chat panel.

<!-- ioZen Floating Widget -->
<script 
  src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
  data-bot="YOUR_BOT_SLUG"
  async
></script>

No additional HTML needed: the widget creates its own button and panel.

No code required. Share the URL directly:

https://app.iozen.ai/i/YOUR_BOT_SLUG

Works in emails, social media posts, SMS, printed QR codes: anywhere you can share a link. See the Direct Link & QR guide for details.

Platform Guides

Step-by-step instructions for popular website platforms:

Customization

All embed types inherit your intake bot's design settings (colors, fonts, branding). To customize the appearance, update the Design tab in your intake bot settings. Changes apply everywhere the bot is embedded.

Troubleshooting

IssueSolution
Bot doesn't appearCheck that the data-bot slug matches your bot's share URL
Bot appears but is cut offEnsure the inline container has enough height, or use popup/widget mode
Multiple bots on one pagePaste each bot's own snippet. A container's data-iozen-inline must match its script's data-bot
Content Security Policy errorsAdd app.iozen.ai to your CSP script-src and frame-src directives

Need help? Email us at hello@iozen.ai.

On this page