Fix Website Embed Connection Failed

A Website Embed connection error usually means the bubble loaded, but TROPIKAL did not accept the connected website binding for this page.

The most common causes are:

• The Website Embed binding is inactive or stale.
• The page has an older legacy snippet.
• The website is missing from the allowed website list.
• The connected site cannot reach TROPIKAL Connect.

Do not paste install codes, tokens, cookies, or private credentials into support messages.

Fix an inactive or stale binding

If the bubble says the Website Embed connection is inactive, stale, or unavailable:

1. Open the workflow in TROPIKAL.
2. Open When this runs.
3. Choose Channel, then Public Embed.
4. Confirm the selected connected website and allowed website list.
5. Refresh or recreate the Website Embed binding.
6. Confirm the website uses the current TROPIKAL Connect snippet.
7. Publish the website and reload the live page.
8. Open the bubble and send a short test message.

For connected TROPIKAL websites, the snippet is tokenless:

<script async src="/tropikal-connect/embed/chat-widget.js"></script>

Fix a website that is not allowed

If the bubble says the channel is not allowed for this website:

1. Open the workflow in TROPIKAL.
2. Open Trigger > Channel > Website Embed.
3. Add the live website where the bubble appears.
4. Save the Website Embed settings.
5. Publish or refresh the website.
6. Test the bubble from the same live page visitors will use.

Add only websites where this workflow should run. Do not broaden the allowed list just to make a test pass.

Fix legacy or missing configuration

If the browser console mentions a missing persona, channel token, or embed token, replace the old snippet with the current TROPIKAL Connect snippet.

The current snippet has one required part:

Required part	Meaning
/tropikal-connect/embed/chat-widget.js	Same-origin loader served by the connected website.

Do not add browser tokens, publish tokens, permanent Ops keys, or legacy persona attributes to public pages.

After updating the site

Run a quick live check:

Test	Expected result
Reload the website	One bubble appears.
Open the bubble	The connection error is gone.
Ask a known question	The reply uses approved knowledge.
Close and reopen	The bubble closes and opens cleanly.
Check mobile	The chat fits the screen.

If the error continues, contact support with the website URL, workflow name, visible error message, and approximate time of the test. Do not include the install code.

Next: review the full Website Embed setup guide.