Skip to content

Fix Website Embed Connection Failed

A Website Embed connection error usually means the bubble loaded, but Tropikal did not accept the install code for this website.

The most common causes are:

  • The install code was rotated or revoked.
  • The page has an older snippet.
  • The website is missing from the allowed website list.
  • The snippet is incomplete and does not include both the persona and Website Embed token.

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

Fix an invalid or revoked token

If the bubble says Invalid or revoked embed channel token:

  1. Open the workflow in Tropikal.
  2. Open the Trigger node.
  3. Choose Channel, then Website Embed.
  4. Create or rotate the install code.
  5. Copy the full install snippet shown by the dashboard.
  6. Replace the old snippet on your website.
  7. Publish the website and reload the live page.
  8. Open the bubble and send a short test message.

The full install code is shown only when it is created or rotated. If you cannot see the full code anymore, rotate it and update the website with the new snippet.

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 missing configuration

If the bubble says the persona slug and embed token are required, replace the snippet with the current Website Embed install code from the dashboard.

A current snippet includes:

Required partMeaning
PersonaWhich persona should answer inside the workflow.
Website Embed tokenThe private install code that allows this website to start the chat.

Do not assemble the snippet by hand unless Tropikal support asks you to. Copy the full snippet from the dashboard so the required parts stay together.

After updating the site

Run a quick live check:

TestExpected result
Reload the websiteOne bubble appears.
Open the bubbleThe connection error is gone.
Ask a known questionThe reply uses approved knowledge.
Close and reopenThe bubble closes and opens cleanly.
Check mobileThe 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.