Iframe Embed

Add the chat to platforms that only accept an iframe, with no script tag

Starter, Standard, Pro & Enterprise

Översikt

Some site builders and intranets do not let you paste a script tag. They give you an embed block that accepts only an iframe. Google Sites, Notion, SharePoint and several page builders work this way.

For those, Asyntai serves a standalone chat page you can point an iframe at. No script tag is needed anywhere on your site.

Obs! The iframe page requires a paid plan. On the Free plan the frame shows an upgrade message instead of the chat, so use the script installation while you are on Free.

Konfiguration

Paste this into your platform's embed or HTML block, replacing YOUR_WIDGET_ID with your own:

<iframe src="https://asyntai.com/app-chat/YOUR_WIDGET_ID/"
        width="100%" height="650"
        style="border:none;"></iframe>

Your widget ID looks like asyntai_943f87a3857c. You will find it in the Setup section of your dashboard, in the install snippet.

Obs! Keep the trailing slash after your widget ID. Without it the address will not resolve.

Which method should I use?

Script tag, floating bubble The normal installation. Use it whenever your platform lets you paste a script tag.

Embedded Chat, inline on the page Also a script tag, but the chat sits inside your page content instead of floating.

Iframe, this page Only when your platform refuses script tags. It is the most limited of the three.

Storlek

The chat fills whatever space the iframe gives it, so set the size on the iframe itself. About 650px tall is comfortable on desktop. Below roughly 400px of height the message area becomes cramped.

<iframe src="https://asyntai.com/app-chat/YOUR_WIDGET_ID/"
        width="100%" height="700"
        style="border:none; min-width:320px; border-radius:12px;"></iframe>

Limits of the iframe method

An iframe is a separate page inside your page, so the chat cannot see the page around it. Compared with the script installation:

The chat cannot read the page it sits on, so it cannot answer questions about what the visitor is currently viewing.

It stays where you put it. There is no floating bubble and it does not follow the visitor to other pages.

The conversation does not carry over between pages, because each iframe loads on its own.

Requires a paid plan (Starter and above). Messages count the same way as any other installation.

If your platform allows a script tag at all, use the normal installation instead. It works on every plan and is a better experience in each of the ways above.

Felsökning

The iframe shows a 404 page

Check the address. It must be /app-chat/ followed by your widget ID and a trailing slash. Addresses containing /embedded/ are not valid and will show a 404 inside the frame.

The frame is blank

Give the iframe a height. A frame with no height set collapses to nothing, so the chat loads but you cannot see it.

The chat says it does not know anything

The iframe is working and the knowledge base is empty. Add your website or a document in the dashboard, wait for indexing to finish, then reload.

Tips: Open the iframe address directly in a browser tab first. If the chat works there, the address is right and anything still wrong is in how your platform renders the embed.

Dokumentation