WidgIq An AI chat assistant,for any website.
WidgIq is an embeddable chatbot widget — drop one <script> tag into your site and your visitors get an intelligent AI assistant that actually knows your product, your pages, and your content. Every conversation is logged to your dashboard, giving you request analytics, full question history, and a weekly AI analysis of what your visitors are actually looking for.
How It Works
Create a project
Add your website to the WidgIq dashboard. Firecrawl crawls your pages and builds a knowledge base from your content. You can update your knowledge base anytime — crawl specific pages, refresh existing ones, run a full re-crawl, or delete a page's content whenever you want.
Grab your API key
Each project gets a unique API key. This is what connects the widget on your site to your knowledge base in the cloud.
Embed the script
Paste one <script> tag into your site with your API key. Once deployed on your verified domain, the widget appears and responds instantly — it won't respond on localhost since we validate origin for security.
Customize the widget
Choose a theme type, color scheme, position, layout and other options to match your site. You can customize anytime from the dashboard — no development site needed, changes apply instantly.
Your visitors get answers
When someone asks a question, the RAG system retrieves the most relevant content from your site and streams a precise, grounded answer back in real time.
Your Restricted Pages Are Always Safe
Our crawler only accesses pages that are publicly available on your website — the same pages any visitor could open in their browser without logging in.
Pages behind authentication — such as your dashboard, admin panel, user account pages, or any route that requires signing in — are never crawled. This is intentional.
Why this is a feature, not a limitation:
Your restricted pages contain sensitive user data, internal workflows, and private information that should never be part of a public-facing AI chatbot's knowledge base. By only crawling public content, your private pages stay completely secure — no risk of exposing confidential data through AI responses.
What this means for you:
Your knowledge base will contain exactly what your visitors need — your product docs, landing pages, pricing, blog posts, and support content — without any risk of leaking what's behind your login wall.
Ensuring Complete Page Discovery
When you connect your website, our crawler automatically discovers pages through sitemaps and link extraction. However, if your website uses dynamic routes (e.g. /blog/[slug], /services/[id], /docs/[category]/[page]), some pages may not be discovered automatically.
Why does this happen?
Modern websites built with frameworks like Next.js, React, or Vue often generate page URLs dynamically using JavaScript. These links may not be visible to crawlers until the page is fully rendered — and even then, deeply nested routes can sometimes be missed.
What you can do:
The simplest and most reliable fix is to add a sitemap.xml to your website. A sitemap explicitly lists every page you want indexed, ensuring nothing is missed — regardless of how your routes are structured. Most website frameworks support this natively or via a plugin.
If adding a sitemap is not possible right now, don't worry. After crawling, you can:
Try WidgIq Before Setup
Add the script tagwithout a data-api-key to preview the default compact chatbot widget on your website.
This is a test mode and will not give you any response. It is only for previewing the widget.
Get Started
Securing Your API Key
Your WidgIq API key is a publishable key — it's designed to be embedded in your website's HTML and is visible to anyone who inspects your site. That's normal and safe, because we have multiple layers of protection in place:
Every request is validated against your registered website domain — requests from unauthorized domains are automatically rejected
Per-user rate limiting prevents abuse and bot attacks
Your credit system ensures any damage is strictly limited
That said, we still recommend following these best practices:
Store your API key in a .env (or .env.local) file
Add .env* to your .gitignore file
Commit a .env.example file with placeholder values so your team knows what to set
Must read it for customizing the widget
All available attributes at a glance.requiredattributes must be present.conditionalmeans required only when noted.optionalattributes have sensible defaults.
Widget theme type. Currently supports "assistant" & "compact".
Name shown in the launcher button and input field.
JSON array of quick-reply chips. Required when theme-type="assistant".
Currently supports "modern", Default: "modern".
"auto" | "light" | "dark". Default: "auto".
First message the assistant sends when the chat opens.
Hex color for accent elements, e.g. "#8611a0". Default: Shadcn UI primary color.
Hex color for the notification dot on the launcher button. Required when theme-type='assistant'. And if you don't want to show the dot, set it to 'none'.
URL to a logo image, or "agent" for the default icon. check below for more agent avatar. Default: "agentAvatar-1".
Font family string, e.g. "Syne, sans-serif, Inter, etc".
Base font size (number, no px), Default: "15".
Chat panel corner radius like "rounded" or "sharp" default="rounded".
Logo image border radius like "circular", "rounded" or "sharp" default="circular".
Launcher button border radius like "circular", "rounded" or "sharp" default="circular".
Icon name for user messages, Default: userAvatar-1. check below for more avatar
Icon name for send button, Default: sendIcon-2. check below for more send icon
JSON array of paths where widget should appear. Overrides exclude-page. Default: widget appears on all pages.
JSON array of paths where widget should be hidden, e.g. '["/admin"]'. Default: widget appears on all pages.
(Icons)
What's makes it different
Deep customization
Colors, fonts, border radius, intro message, starter questions, page visibility — control everything via simple data attributes.
Extremely lightweight
A single JS file. No npm install, no build step, no framework required. If your site can load a script tag, it can run WidgIq.
Streaming responses
Responses stream token by token — no waiting for the full answer to load. Feels instant, keeps users engaged, just like ChatGPT.
Excellent RAG circuit
Backed by a serious retrieval-augmented generation system. Your assistant answers from your actual content — not hallucinations.
Beyond the widget — your dashboard
WidgIq isn't just a chatbot you embed and forget. Every conversation your visitors have feeds into a dashboard that gives you real visibility into what your audience actually wants.
Key Features
Request analytics
See daily and total request counts at a glance — track engagement as your widget usage grows.
Questions history
See which questions come up most frequently — know exactly what your audience is curious about.
Weekly AI analysis
Every week, WidgIq automatically analyzes your visitors' questions and surfaces actionable insights
Credits & usage
Track your credit consumption and remaining balance directly from the dashboard.
