Quincer Docs
/
Home Support Start free

Account

Troubleshooting

Most issues fall into one of a handful of buckets. Start with the matching symptom below. If nothing helps, email support@quincer.com with the URL where the widget lives and a screenshot of the browser console.

Widget isn't showing on my site

  1. Is the script tag actually on the page? View page source and search for chatbot-widget.js. If it's absent, the snippet didn't paste cleanly — re-paste from Widget → Deploy.
  2. Is the API key present? The window.ChatWidgetConfig.apiKey value should start with cw_live_.
  3. Check the browser console. Errors from chatbot-widget.js usually name the problem (bad key, CORS, config fetch failed).
  4. Cache-Control. The widget file is cached at the CDN for 5 minutes. If you just rotated keys, wait a few minutes or hard-refresh.

“CORS policy: no Access-Control-Allow-Origin”

This almost always means the domain you're loading the widget on doesn't match what Quincer has on record for the widget. Open Widget → Settings → Allowed domains and add the origin (e.g. https://my-store.com).

Wildcards are supported: *.my-store.com matches any subdomain. Leaving the list empty allows any domain (not recommended for production keys).

“401 Unauthorized” in the console

  1. Confirm the key in your snippet matches an active key under Widget → Deploy → API Keys.
  2. If you deleted a key, any site using it will stop working immediately. Generate a new one and re-paste the snippet.
  3. Widget keys (cw_live_) and API keys (qn_live_) are not interchangeable. The widget only accepts cw_live_.

Shopify: Theme Editor opens but Quincer Chat block isn't listed

  1. Make sure the Quincer Chat app is actually installed. Shopify Admin → Apps → look for Quincer Chat.
  2. If it's there, reload the theme editor and look for the block under App embeds (not under Add section).
  3. If you're using a legacy (vintage) theme, app embeds aren't supported — use the manual script-tag install against theme.liquid instead.

Widget appears, but conversations don't arrive in the dashboard

Almost always a key mismatch: the widget is pointing at a different workspace than the dashboard you're viewing. Verify the first 10 characters of the API key on both sides match.

Meetings aren't being booked

  1. Is a calendar connected? Open Integrations. If Calendly / Google Calendar / Microsoft 365 all show Disconnected, the agent has no way to offer times.
  2. Is the BANT threshold right? A Hot score of 70 is a high bar — try setting it to 60 for the first week and observe.
  3. Is a Calendly event type picked? Under Integrations → Calendly → Settings, make sure a default event type is selected per persona.
  4. Rep on OOO? If the routed rep is outside business hours or on OOO, Quincer skips them. Add a fallback teammate to the territory.

HubSpot contacts aren't syncing

  1. Integrations → HubSpot → Test. If the test fails, click Reconnect to refresh the OAuth token.
  2. Check HubSpot's audit log for permission errors — if Quincer's scopes were reduced, some tools will fail silently.
  3. Check Integrations → HubSpot → Logs in Quincer for the exact API error.

Knowledge base says wrong things

  1. Open Knowledge → Chunks and search for the visitor's question. Look at the top-ranked chunks.
  2. If the right content isn't being retrieved, add a matching Q&A pair with the phrasing the visitor actually used.
  3. If wrong content is ranked high, delete or disable that source — it's likely outdated.
  4. See Debugging retrieval.

Agent gives off-brand answers

Tighten the persona's Role and Tone fields. Be specific (“never use the word ‘leverage’”) instead of generic (“be professional”). Add high-risk topics to the Boundaries list so the agent escalates instead of improvising.

Email follow-ups aren't sending

  1. Confirm Gmail or Microsoft 365 is connected (Integrations tab).
  2. Confirm Playbook → Email follow-up is set to Auto-send (not Drafts).
  3. Check your Gmail Sent folder — if the send succeeded, the email is with the visitor and may be in spam.

Dashboard looks broken / stuck on loading

  1. Hard refresh (Cmd+Shift+R or Ctrl+F5).
  2. Sign out and back in.
  3. Check status.quincer.com for ongoing incidents.

Still stuck?

Email support@quincer.com with: