Publish

Publish an AI agent as a chat widget or an embedded conversation.

Open copy menu

You can publish an AI agent as a floating chat widget or as a conversation placed in the page content. Always copy the code for this agent from the Editor’s Install menu. It already contains the correct public identifier, so you do not need to edit it manually.

Embed method · Choose this when · Note
Embed method	Choose this when	Note
Website chat widget	You want a floating launcher across the site	Supports Widget API commands, analytics consent, and signed-in user identification
Embedded chat	You want the chat window to be a fixed part of one page	Does not show a floating launcher or support host-page Widget API commands
WordPress	Your site runs on WordPress	The official plugin installs the widget without copying code

Before installation

Test the most common customer questions in the Editor preview.
Save your changes and publish the agent. A draft or paused agent will not respond on your site.
Open Settings → Security. If domain restrictions are enabled, add every origin separately, for example https://example.com and https://www.example.com. *.example.com does not include the apex domain example.com.

Open the agent’s Editor.
Select Install → Website chat widget.
Copy the complete <script> snippet.
Add it once to the shared site template, just before the closing </body> tag.
Publish the site change.

Most publishing systems provide a site-wide Footer or Custom Code field. On WordPress, you can also use the official Aihio Chatbot plugin .

Astro sites

Create a component such as src/components/AihioWidget.astro and paste the code copied from the Editor into it. Change only the opening <script> tag to <script is:inline> so Astro does not bundle or move the public bootstrap.

Import the component into the shared layout and render it once before the closing </body> tag:

---
import AihioWidget from '../components/AihioWidget.astro';
---

<html lang="en">
  <body>
    <slot />
    <AihioWidget />
  </body>
</html>

Never add the chatbot secret to an Astro component or a PUBLIC_ environment variable. The embed’s chatbotId is a public identifier; the identity verification secret belongs only on your server.

Chat remains available without analytics consent. Pass behavioral analytics permission to the widget only after the visitor accepts it in your consent manager:

AihioWidget('consent', {
  analytics: hasAnalyticsConsent,
});

Replace hasAnalyticsConsent with the boolean from your consent manager and call the command whenever the choice changes. Unknown or rejected consent maps to false. Browser Do Not Track also disables widget analytics when the host passes true.

Identify a signed-in visitor

Create a short-lived HS256 JWT on your server and pass only the finished token to the browser:

AihioWidget('identify', {
  token: serverSignedIdentityToken,
});

Call AihioWidget('resetUser') on sign-out so the next person using the same device cannot see the previous visitor’s conversation history. See the identity verification guide for server examples, supported claims, and the safe rollout order. Never sign the token in the browser or expose the secret in embed code.

Embed the conversation in page content

Select Install → Embedded chat.
Copy the complete <iframe> element.
Add it where the conversation should appear.
Adjust the surrounding region’s height. The default code uses a minimum height of 600 pixels.

An iframe works well on a contact or support page. Choose the script embed when you need the floating launcher, the identify command, analytics consent, or other Widget API commands.

Verify the installation

Open the published page in a private browser window.
Confirm that the chat widget or embedded conversation appears and answers a test message.
Test both mobile and desktop widths.
Test accepted and rejected analytics consent if you pass consent to the widget.
If you identify visitors, confirm in Settings → Security that Aihio has received a valid token before enabling enforcement.

If the conversation does not appear

The browser reports a domain error: add the exact origin shown in the address bar to the allowed domains. Add preview and production domains separately.
The browser console reports a CSP error: allow https://app.aihio.ai for scripts and connections or for the iframe. Allow the inline bootstrap with a nonce or hash; do not weaken the whole site with unsafe-inline only for the widget.
A loading request fails: use the browser Network panel to confirm that aihio-loader.js and the chatbot configuration request return successful responses.
The code works on only some pages: move the script to the shared layout and ensure it is added only once.
The iframe is too short: set a height on its containing element or adjust the iframe’s min-height value.

To remove the installation, delete the <script> or <iframe> element you added and publish the site again.

Pause or reactivate

Open the agent status menu in the top bar and select Pause to stop answering temporarily. Confirm the status changes to Paused and test the effect on your website.

To resume, select Reactivate and verify with a test message that the agent answers again. If activation is blocked, check for a ready knowledge source and review the visible error.

Pausing does not remove the website installation code. Remove the code separately if you do not want the conversation interface to load at all. Changing status also does not restore earlier instructions or a previous configuration.