Troubleshooting10 min readUpdated May 5, 2026
Common issues
Resolve common setup issues with widget install, realtime inbox, billing, AI, channels, and migrations.
Widget is not showing
- Confirm script is present on the page.
- Confirm organization ID is correct.
- Check browser console for blocked scripts, CSP, or network errors.
- Test in a private window to avoid stale local state.
Realtime feels delayed
- Confirm websocket connection is active.
- Check whether UI waits for API refetch instead of applying realtime events.
- Verify organization ID and selected conversation subscriptions match active workspace.
- Use API refetch as reconciliation, not as the primary visible update path.
AI answer is not grounded
- Review the knowledge source that should answer the question.
- Check source status, indexed storage units, and last indexed time.
- Ask a direct test question matching the source text.
- Do not add broad prompts that allow generic company-specific claims.
AI action did not run
- Confirm action is active and domain is allowlisted.
- Confirm all required parameters are present.
- Check secrets, rendered URL, request preview, and latest log failure reason.
- For write actions, confirm required confirmation or approval happened.
Billing access looks wrong
- Refresh after switching organizations.
- Confirm frontend plan details and server-side plan guards use the same plan source.
- Remember: Agent Copilot, AI Actions, email, WhatsApp, voice, and analytics are not Starter features.
Migration failed
- Do not remove migration files already referenced by Drizzle journal.
- Run migrations from the project command.
- Check that referenced SQL functions exist in baseline migration.
- Use a fresh database only when you intentionally want a clean production reset.