Publish the widget on your site

The IperChat widget works on any site — WordPress, Shopify, Squarespace, static sites, SPAs. The standard integration is a single <script> tag pasted before the closing </body>.

The snippet

Copy it from the ops panel, “Documentation” section (side menu → Agents group): the Tenant ID is filled in automatically in the data-tenant-id field. The “Copy snippet” button above the code copies it to your clipboard.

<script
  src="https://widget.iperchat.ai/iperchat.iife.js"
  data-iperchat-auto-init
  data-tenant-id="YOUR_TENANT_ID"
  data-position="bottom-right"
></script>

Four attributes:

• src — the bundle URL (always the same).
• data-iperchat-auto-init — starts the widget on page load. If you want to control it from JavaScript, remove this attribute and call window.IperChat.init({...}) whenever you prefer.
• data-tenant-id — identifies your space. You’ll find it in “My Tenant” in the panel (the small string under the page title), or already filled in the snippet under “Documentation”.
• data-position — bottom-right (default), bottom-left or inline.

Integration modes

The same tenant powers several experiences. Choose via the data-position attribute or by loading a different bundle.

Floating widget

The default. Discreet button in the corner, click to open the chat. This is what you get with the snippet above.

Inline on the page

Set data-position="inline" and the script looks for a <div id="iperchat"> container on the page. The chat renders embedded in that section, not floating.

<div id="iperchat" style="height: 600px; max-width: 800px;"></div>

<script
  src="https://widget.iperchat.ai/iperchat.iife.js"
  data-iperchat-auto-init
  data-tenant-id="YOUR_TENANT_ID"
  data-position="inline"
></script>

Useful for “Contact us” pages, animated FAQs, support hubs.

Standalone page (Enterprise plan)

Enterprise plan only: full-screen chatbot page served from your custom domain (e.g. assistant.yoursite.com), with no visible reference to IperChat. A fully white-label experience for brands that don’t want to share the chat.iperchat.ai host.

Activated by contacting info@iperchat.ai: we’ll configure DNS and the SSL certificate together with your team.

Post-integration checks

”Unauthorized domain” error

For security, the backend compares the calling domain with the list of authorized domains on your tenant. If there’s no match, the agent doesn’t respond.

To authorize the domain:

1. Open “My Tenant” in the ops panel.
2. Under Settings you’ll find the Allowed domains field — a comma-separated list.
3. Add the exact domain (e.g. www.yoursite.com) to the end of the list and click Save.

Cache, CDN, defer JS

Three common things that can hide the widget:

• Caching plugins (W3 Total Cache, WP Rocket, etc.) — purge the cache after saving the snippet.
• CDN (Cloudflare, Bunny) — purge the cache there too.
• Defer JS / aggressive minification — exclude iperchat.iife.js from defer/inline rules.

None of this is specific to IperChat: it applies to any third-party script.