Troubleshooting and FAQ
Config returns 403
Section titled “Config returns 403”The page origin is not allowed for that client ID. Check the staging or production ID and embed origin, then send the exact scheme, host, and port to your Tiketo contact. Opening a config URL directly has no page Origin and is rejected.
Run the curl origin check before debugging the widget. It distinguishes an allowed 200 from a denied 403.
The bubble does not appear
Section titled “The bubble does not appear”- Check that the loader request returns
200and is not blocked by CSP or an extension. - Check the
[tiketoChat] Initialization skippedwarning and config status. - Make sure
initreceives a string likeTC-XXXXXXXX, not the removed{ client, env }form. - Make sure the snippet runs once, outside a route component that mounts repeatedly.
My action is not called
Section titled “My action is not called”Confirm the name supplied by Tiketo, the action ID in config, and support for that contract in your pinned loader. Unknown or disabled actions are ignored. Check the console for payload warnings, then review the registration timing and failure behavior.
A component shows plain fallback text
Section titled “A component shows plain fallback text”The payload may be invalid, the component may be disabled, the pinned loader may be too old, or its renderer may be missing. Compare the supplied name and payload with the generated catalog. The component guide explains renderer timing and fallback behavior.
The console reports CSP violations
Section titled “The console reports CSP violations”Compare your policy with the CSP baseline. In connect-src, allow the selected embed origin over HTTPS and WSS. Keep inline runtime styles enabled for the widget.
How do I switch accounts safely?
Section titled “How do I switch accounts safely?”Use the complete logout and account-change example. The reset reference lists its guarantees, failure handling, and relaunch behavior.
I mistyped a command
Section titled “I mistyped a command”Unknown commands are ignored and produce a [tiketoChat] Unknown command … ignored. console warning. They do not make a config request.
Can I register my own action name?
Section titled “Can I register my own action name?”No. Registration supplies the browser implementation for a contract that Tiketo has already configured and enabled. Your Tiketo contact provides the action and component names and schemas.