Why this matters
Quick fixes for the issues users hit most, collected in one place.
- 1
Connection tests
- Shopify 401 → token mis-copied; reveal a new one (reinstall the app) and re-paste.
- Shopify 404 → use the .myshopify.com domain, not your custom domain.
- Google 'app not verified' → click Advanced → Continue; it's your own app.
- Google token expired after 7 days → publish your OAuth consent screen from Testing to Production, then redo the playground step.
- GA4 403 → enable the Analytics Data API and check your account has Viewer access to the property.
- Ahrefs 403 → API needs Enterprise; use CSV exports instead.
- 2
AI assistant connections
- Connector is present but Not connected → choose Connect/Authenticate and finish the ZYLX browser approval.
- Tools error 'unauthorized' → open Agent Servers. If authorization is unhealthy, disconnect and complete OAuth again; never paste a bearer credential into support chat.
- New business missing → Agent Servers → Manage businesses → explicitly add it. New workspaces do not widen existing connections.
- Wrong or ambiguous business → ask the assistant to list authorized businesses, then use the exact name or workspace id.
- Refresh requires reconnect → reconnect before the displayed access-token expiry; a healthy rotating connection should refresh without repeating consent.
- 3
Audits & recommendations
- 'Connect Shopify first' → run a successful Shopify test on the Integrations page.
- 'Connect an AI provider' when generating in the dashboard → add an Anthropic or OpenAI key, or skip and use Claude Desktop instead (it brings its own AI).
- Audit scores feel harsh → that's intentional: findings are ranked by ROI so you always know what to fix first.