Resources

Troubleshooting

Common problems and the fix in one place.

The widget doesn't appear

Open the browser console — search for [duggsupport].
Check Network — is duggai.com/embed.js returning 200?
If 401: the widget key is wrong or revoked. Regenerate from the dashboard.
If 403: your origin isn't in the allowed domains list. Add it under Widget appearance → Allowed domains.
If the script loads but the bubble doesn't render, check that nothing on your page has display: none applied to high-z-index containers.

The bot replies in the wrong language

The agent auto-detects user language and replies in kind. If it's detecting wrong, setdata-locale on the script tag — it nudges the agent toward that locale by default. Users typing in another language still get answered in their language.

The agent ignores my docs

Confirm the source is indexed: Knowledge → Sources shows last sync time.
If it's stuck on "crawling," check the docs site is publicly accessible. The crawler doesn't handle auth-walled docs by default.
If a specific page is missing, paste the URL into the per-source Recrawl field — forces a single-page recrawl.
If the agent still doesn't cite the source, open a conversation in the dashboard — the "Considered chunks" panel shows what was retrieved. If your doc isn't there, retrieval failed (vocabulary mismatch is the usual culprit).

Confidence scores look wrong

New accounts often see scores skew low. The model calibrates over time as users react. After a few hundred conversations, scores stabilize. If you're seeing many high- confidence replies that turn out wrong, that's a sign your sources have stale content — re-index.

Discord bot is silent

Confirm the bot has permissions to read messages in the channel.
Check the channel is a watched channel under Channels → Discord.
If autonomy is set to "@-mention only," the bot won't reply unless tagged.
For threaded replies, check the bot has "Manage threads" permission.

Linear / GitHub sync is stuck

Re-authorize the integration. OAuth tokens for trackers expire periodically.
If issues are created but status doesn't sync back, the webhook is the issue. From Integrations, click Re-test webhook.

I'm hitting the resolution cap on Free

Either upgrade to Starter for 250 included resolutions, or lower the bot's autonomy so fewer conversations resolve and more escalate to your team. See Resolutions & escalations and Pricing.

Use the "Considered chunks" panel

For most "the bot is wrong" issues, the answer is in the dashboard's Considered chunks panel. It shows exactly what the agent retrieved. If the right source isn't there, your knowledge base needs work; if it's there but ignored, your confidence threshold is too lax.

Still stuck

Email support@duggai.com with the conversation ID and a screenshot. Same-business-day reply.