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:
- Open the workflow in Tropikal.
- Open the Trigger node.
- Choose Channel, then Website Embed.
- Create or rotate the install code.
- Copy the full install snippet shown by the dashboard.
- Replace the old snippet on your website.
- Publish the website and reload the live page.
- 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:
- Open the workflow in Tropikal.
- Open Trigger > Channel > Website Embed.
- Add the live website where the bubble appears.
- Save the Website Embed settings.
- Publish or refresh the website.
- 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 part | Meaning |
|---|---|
| Persona | Which persona should answer inside the workflow. |
| Website Embed token | The 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:
| 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.