Troubleshooting

The Widget doesn’t show up

• Ensure the agent is published.
• Verify the agent ID matches the dashboard.
• Check the browser console for initialization errors.

Identity fails

• JWT exp - iat must be ≤ 10 minutes.
• Tokens must be signed with HS256.
• sub is required and must be a stable user ID.

Navigation events don’t work

• Register setNavigationHandler after createWidget resolves.
• Ensure your router (Next.js, React Router) is available in the client.