FAQ

Widget not showing

• Check your AI model configuration — the widget stays hidden until a model is configured and verified in Dashboard → AI Model (see below)
• Verify the <script> tag is added before </body>
• Check browser console for errors
• If using data-exclude, check if current route is excluded

Why do I need my own model API key?

Webnav.ai runs AI conversations on a model you bring yourself (BYOK — Bring Your Own Key). In Dashboard → AI Model you can connect:

• OpenAI-compatible endpoints — OpenAI, DeepSeek, Qwen, Moonshot, OpenRouter, self-hosted vLLM, etc.
• Anthropic Claude (native API)
• Google Gemini (native API)

Your key is encrypted at rest (AES-256-GCM) and only used to call the model service you specify. When you save the configuration, we run a connectivity test — the widget appears on your site once the test passes. If your chosen model does not support tool calling, basic Q&A still works but AI Actions (orders / tracking / refunds) is disabled automatically.

Can the chat window open automatically for visitors?

Yes — Pro and above can enable Welcome Message in Dashboard → Settings. The chat window auto-opens 3 seconds after a visitor arrives (once per visit, desktop only) and shows your configured greeting text and optional image (e.g. a support QR code). See the Welcome Message section in Widget Attributes for details.

Why does it take a moment on first load?

AI needs to learn your website content on first use (usually 1-2 minutes). The widget shows learning progress. After that, it loads from cache instantly.

Will it affect my website performance?

No. The widget uses Shadow DOM for complete isolation — it won't affect your page styles or performance. The script loads asynchronously and doesn't block page rendering.

AI answers are inaccurate

Answer quality depends on your website content richness. Ensure your site content is clear and comprehensive for better AI responses.

Browser support

All modern browsers: Chrome, Firefox, Safari, Edge. IE is not supported.

Is conversation data secure?

• Widget code is fully open source — audit every line
• Shadow DOM isolation — widget cannot access your page data
• Chat history stored only in user's browser, never on server
• No third-party tracking scripts

See Security for details.

How to refresh AI knowledge?

After updating your website content, contact us to clear the cache and trigger AI re-learning.

Contact

• Email: taiyisave@gmail.com
• Website: www.webnav.ai