Fixing Common Problems
Symptom-by-symptom fixes — widget not showing, wrong answers, failed crawls, payments, uploads, voice, leads, and what every status means.
Most problems with NovixAgent AI turn out to be one of a handful of things: a workspace that isn't paid, a snippet that didn't save, a content gap the agent has no answer for, or a switch that's off in one of the two or three places it has to be on. This page lists the symptoms as you'd describe them, with the checks that resolve each one.
Each section stands on its own — read only the one that matches. Where another guide covers the depth, the complete short answer is here and the link takes you on.
A note on names. The first entry in the dashboard sidebar is Workspaces. Some screens and emails say Websites, and the
/websitesaddress opens Workspaces — it's the same place.
The widget doesn't appear on my site
Work down this list in order; the first three cover most cases.
- Check the workspace is paid. Open Dashboard → Workspaces and read the status chip on the card. The widget loads only for a site showing Paid — a subscription whose auto-renewal you've cancelled stays Paid until the period ends. With another status, such as Unpaid, Payment failed, Canceled or Suspended, the widget doesn't load — fix billing first, then reload your site.
- Check the snippet is really on the page. View the page source in your browser and search for
novixagent. If it isn't there, the snippet wasn't saved — re-paste it following Installing the Widget. - Check
data-user-idis untouched. It must be your Website ID as the dashboard shows it. An empty ID logsdata-user-id is requiredin the browser console; a wrong one is refused without a console message. In both cases the bubble doesn't appear. - Read the browser console. Press F12 and look for red errors mentioning
novixagent-ai. Errors readingRefused to load,Refused to frameorRefused to connectare a Content Security Policy block — the three directives you need to add are listed in Installing the Widget. - Rule out your cache. Open your site in a private or incognito window. If the bubble appears there and not in your normal window, it's browser cache, not the widget.
- Purge your CDN. Behind Cloudflare or another CDN, purge the cache so the updated HTML — the one carrying your snippet — is actually served to visitors.
The widget loads but the agent has stopped replying
The most common cause is your monthly message quota. Check Dashboard → Analytics → Overview → Plan Usage — the status chip reads Limit Exceeded when you've run out, and the line under the heading shows the date the allowance resets.
The widget doesn't disappear when that happens. It switches to contact-only mode: AI replies pause, opening the chat shows your lead form straight away (if you have one) so a visitor can still leave their details, and the launcher label is temporarily replaced with a short contact prompt. Live chat with a human operator keeps working, because human replies do not count against the AI quota.
It restores itself once the quota has room again. That happens when:
- The allowance resets. The quota refills on your billing-cycle anniversary, not on the 1st of the calendar month.
- You upgrade the plan. The higher message limit applies immediately — you don't wait for the next cycle. Messages you've already sent this month still count, so you get the new plan's allowance minus what you'd already spent, and your reset date doesn't move.
- You add a message pack under Workspaces → (your workspace) → Extra Limits — that adds headroom right away.
- Support restarts your count. The new period then starts at that moment.
During a free trial, upgrading or adding a message pack doesn't give the quota room back: the trial limit applies until the trial ends or you start the paid plan (see Trials).
Full detail: What happens when you run out.
If your usage is nowhere near the limit and the agent still isn't answering, it isn't quota. Check the browser console for errors and email support@novixagent.ai with your Website ID.
The agent gives wrong, vague or "I don't know" answers
Your agent is instructed to answer only from content you've connected, and to say so when it finds no answer there. So a bad answer most often points to a content gap, not a broken model. Fix it in this order:
- Read the actual gaps first. Dashboard → Analytics → Messages → Questions without an answer is the list of questions your agent found no matching content for. Work from that rather than guessing. (Which plans have that tab: Website Analytics.)
- Type the missing fact. Dashboard → Knowledge Base → "Anything we missed" is the fastest fix — it's processed as soon as you save it, and a typed note carries more weight than a crawled page when both are about equally relevant. Ideal for prices, opening hours, lead times, and what you explicitly don't do.
- Upload a document for longer material — a policy, a manual, a spec sheet. PDF, DOCX and TXT are accepted.
- Fix the page on your site, which gets picked up on the next scheduled re-crawl.
- Switch to a more specific AI Template (a sales-focused persona instead of a generic FAQ one), or write a custom prompt if your plan includes it. See AI Templates.
- If your content is full of jargon, upload a short glossary file so the agent can map a visitor's wording onto yours.
See Adding Content for how the three content sources work together.
A crawl failed or only picked up part of my site
Open the workspace card in Dashboard → Workspaces. The knowledge-base panel on it is what reports the state of the last run, in plain words rather than a status code:
| What the panel says | What it means for you |
|---|---|
| Knowledge base — waiting | No crawl has run yet. It starts on its own once the workspace is paid. |
| Reading your content | Crawling right now. Large sites take longer. |
| Indexing knowledge | Pages are in; they're being turned into the searchable knowledge base. |
| Finalizing assistant | Last step before the agent is fully trained on the new content. |
| Knowledge base ready | Finished. It also shows when the last crawl ran. If a later update fails, the panel stays on this title and adds "Answering from what it already knows · last update failed". |
| Knowledge update failed | The run didn't complete. Usually the panel adds "A retry will happen automatically." — you don't need to trigger one. If it says instead that your site's robots.txt could not be read, no retry gets past that until your server returns the file — see The crawler and your robots.txt. |
There is no per-page failure report on your dashboard, so if you need to know which pages were skipped, email support@novixagent.ai with your Website ID and we'll look at the run for you.
The usual causes of a failed or incomplete crawl are:
- The site needs a login, or is IP-restricted. The crawler reads public pages only; it doesn't sign in. Upload the gated material as files instead.
robots.txtdisallows the crawler. AllowNovixAgent-AI-Crawlerand the pages come back on their own, within your plan's page limit. How soon, what the card shows and how to write the rule are in the next section.- Your plan's page limit was reached. A large site stops at the cap, which is why some pages are missing while others are there. Upgrading raises the ceiling and starts a fresh crawl to the new limit, unless your last crawl already read that many pages; the per-plan page and depth figures are in Adding Content.
- The site was down or unreachable when the crawl ran. The next scheduled crawl reads it again; if you'd rather not wait, email support@novixagent.ai with your Website ID and we'll start one.
Your previously indexed content keeps serving answers while a failed run is retried.
The crawler and your robots.txt
The crawler introduces itself as NovixAgent-AI-Crawler and follows your site's robots.txt, reading it afresh at the start of every crawl.
When the file refuses some pages, the workspace card says so, in a line such as "12 pages excluded: your robots.txt disallows NovixAgent-AI-Crawler." An excluded page isn't merely skipped — it also drops out of the agent's knowledge and stays out until the rule is lifted.
When a change takes effect. A path you disallow leaves the agent on the next crawl that runs. If no other crawl is due, the change itself starts one: we notice it at your site's first scheduled crawl once our copy of the file is more than a day old, and re-read it then — so allow about a day plus your plan's crawl interval. Lifting a rule brings the pages back the same way, within your plan's page limit. A robots.txt that is only temporarily unreachable removes nothing and starts nothing.
To allow us by name, add a group that names us, with the paths it may read:
User-agent: NovixAgent-AI-Crawler
Allow: /
A group for * with Disallow: / still refuses us unless a group names us — that is the robots.txt standard (RFC 9309), not a choice of ours.
If your robots.txt is unreadable. When your server answers the request for it with an error, or doesn't answer, we fall back to the last copy we read successfully — if we still hold one; we keep a copy for up to 30 days after reading it. (An answer that the file doesn't exist or isn't available is different: it simply means no rules.) With no copy to fall back on, the crawl stops before fetching any page, and the knowledge-base panel says "Your site's robots.txt could not be read, so the crawl stopped before fetching any page." What your assistant already knows is kept. Once your server returns the file, the next crawl runs normally; if you'd rather not wait for a scheduled one, email support@novixagent.ai with your Website ID and we'll start it.
A different line on a finished crawl, "… pages not fetched: the robots.txt of the site hosting them could not be read.", is about pages on another host that your site points to — a separate domain or subdomain — whose own robots.txt didn't answer. Your own site isn't the cause.
If we don't crawl that host
Separately from robots.txt, there is a short list of hosts we have promised not to fetch — normally because the person who owns one asked us to stop, or because we were required to. If a workspace points at such a host, the crawl is not started: nothing is requested, nothing is fetched, and your knowledge base keeps what it holds.
The dashboard says so — "We do not crawl this host." — and adds that retrying won't change it. On a crawl that ran across several hosts you may instead see a line counting the pages that were skipped for this reason.
This is a decision of ours, not a fault of your site and not an outage; a change on your server or in your settings won't lift it. If it is your own domain and you believe it should not be on that list, email support@novixagent.ai with the host and your Website ID.
Stripe Checkout won't open
- Turn off the pop-up blocker for the dashboard domain — Checkout sometimes opens in a new page and a blocker silently swallows it.
- Refresh the page and click Pay again. A stale page can hold an expired session.
- Try a different browser, or disable extensions that interfere with redirects (privacy blockers and script blockers are the usual culprits).
My card was declined
Payments run through Stripe, so a decline comes from your bank rather than from us. In order of likelihood:
- Re-check the details — number, expiry, CVC, and the billing postcode if your bank checks it.
- Check funds and international payments. Many cards block cross-border charges by default.
- Complete the 3-D Secure step if your bank shows one. Closing that window counts as a decline.
- Some banks block a first-time online charge to a new merchant. This is common and doesn't mean your card is invalid — call your bank to approve it, or use a different card.
If the charge is still refused after these checks, email support@novixagent.ai with your Website ID and the time of the attempt.
My payment is still being processed
After checkout, the plan controls on the workspace card show Processing… until Stripe confirms the payment, and changes to that workspace — its details, knowledge-base uploads and notes, and billing — are refused until then. It clears on its own as soon as the payment settles.
- Refresh after a minute. Stripe confirmations are usually near-instant but can lag at peak times.
- Beyond 20 minutes is too long. A first payment that has not activated is re-checked automatically, so if the notice is still there after 20 minutes, email support@novixagent.ai with your Website ID and roughly when you paid, and we'll unstick it. There is no need to pay again: a second checkout for the same workspace is refused while the first is processing.
A file I uploaded was rejected, is stuck learning, or shows an error
Three different symptoms, three different causes:
- Rejected at upload. One of three things. The format isn't supported — only PDF, DOCX and TXT are accepted. Or the single file is too big: one upload has to clear both 25 MB, a fixed ceiling that does not rise with your plan, and your plan's own file-size limit, whichever of the two is lower. Or the file would push you past your per-plan storage budget for that website, in which case delete older documents to free room or upgrade. The details are in Adding Content.
- Stuck on "Learning". Large files take a few minutes. A file still learning after about half an hour is marked Error with a note to delete it and upload it again; you can do that sooner if you'd rather not wait.
- Status "Error". The note under the file says why. The usual causes: the document is corrupt or password-protected; it is a scanned image with no text layer — there's no OCR, so a scan of a page contains no readable text for us (re-export it as a text PDF, or convert it to DOCX or TXT, and upload again); or it holds more pages or text than one upload may have (split it into smaller files).
The microphone doesn't work for visitors (voice input)
Voice input needs four things to line up. Typing keeps working whichever one is missing; depending on which it is, the microphone button is either not shown or shown with a short notice explaining why it isn't listening:
- Your plan includes speech-to-text — see which plans include it.
- The page is served over HTTPS. Browsers refuse microphone access on insecure pages, full stop.
- The visitor's browser supports it. Chrome and modern Safari do. On a browser without the speech feature the button simply isn't shown and text chat carries on as normal. Some Chromium-based browsers, such as Edge, Brave and Opera, offer the feature but often fail to recognise speech — there the button appears, and pressing it shows a notice instead of a transcript.
- The visitor granted permission when their browser asked. If they refused, the button stays and a notice says the microphone is blocked.
One more thing worth checking in your embed snippet: if it carries data-allow-microphone="false", that's the deliberate per-site opt-out: the widget is not given the microphone. There is no "true" form — if your snippet has one, it has no effect and can be deleted. See Installing the Widget.
The agent doesn't offer booking slots
Booking has to be connected, not merely available on your plan:
- Check the plan — see which plans include it. On a plan without it, the Calendar Booking tile in Dashboard → Integrations shows a lock naming the plan that includes it, instead of a status.
- Check the tile says Connected. A tile that is not connected yet, or shows Error, means the agent has no calendar to book against.
- Run "Test connection" in the Calendar Booking panel, once an event type is saved. It's a live probe that fetches real slots from the same connection the agent uses; if it fails, the panel explains what the provider is objecting to — fix that first.
- Check the event type. Cal.com and Calendly resolve availability against a specific event type; a hidden or inactive one yields no slots.
- On Calendly specifically: the Scheduling API is only on Calendly's paid tiers. A free or expired Calendly plan will connect, but Calendly refuses its bookings, and the connection test says a paid Calendly plan is needed.
See Calendar Booking.
A widget customization field is locked or read-only
That field is gated by a higher plan — the locked banner on it names the plan that unlocks it. This is a plan limit, not a fault.
Upgrade and the field unlocks immediately: you can edit and save it straight away, with no need to re-paste your embed snippet. See Billing & plans.
I can't edit my website's domain
Once a workspace has ever been paid for — a trial counts — and has a domain, that domain is locked permanently, and it stays locked after the subscription ends. The button on the card reads View details rather than Edit details; the dialog still opens so you can inspect the settings, but the domain and language fields are read-only and there is no Save.
Two cases where you can still set one:
- The workspace hasn't been paid for yet, trial included. The button reads Edit details and the domain is editable.
- The workspace has been paid for but has no domain yet — a channel-only workspace. The button reads Add website and you can add the domain it was missing.
The domain of a site that has ever been paid for never changes — not while it is subscribed, not after the subscription ends. Support doesn't change it either: the crawl, the knowledge base and the embeddings belong to that domain. A different domain — because you migrated, or because it was typed wrongly at signup — is a new site: add it as a new workspace and choose a plan for it.
A visitor left their details but no lead appeared
- Check lead capture is configured for that website in Dashboard → Integrations → Lead Capture, with the fields you actually want.
- Check your required fields. The agent will not submit a lead until every required field has a value, and it is instructed never to invent one — a required field the visitor didn't answer keeps the lead from being submitted. Make the fields you don't truly need optional.
- Check the primary form. If a site has more than one lead form, pick the primary one in the Lead Capture panel — otherwise submissions can land against a form you're not watching.
- Look in the right place. Every captured lead is saved to Dashboard → Leads first, regardless of whether delivery elsewhere succeeded. If it's in the list, capture worked and the problem is delivery.
- Check delivery. Expand the lead and read its Delivery card, which tells you whether the email went and whether the webhook was delivered. Failed webhook deliveries are listed under Test & history in the Webhooks panel in Integrations — click Refresh history to load them — and are retried automatically for about a day and a half before being abandoned. For Slack, Send test message in the Slack panel checks that posting to the channel works.
See Capturing Leads.
Visitors aren't offered a human
The "Talk to a human" option appears only when these four conditions hold at once; when it's missing, check them in order:
- Your plan includes Live Agent (see which plans include it). On a plan without it the master switch below is locked, so this one is fixed by changing plan, not in Settings.
- Live Agent is enabled for that workspace, in Dashboard → Live Chat → Settings. This is the owner's master switch.
- You are inside your configured working hours, in the timezone you set there. A weekday switched off is closed, so with the seven days off the option doesn't appear; to be reachable around the clock, switch each day on from 00:00 to 23:59.
- Someone is actually online. Flip the availability toggle in the Live Chat header. The header shows your current state, including the "Online — outside working hours" case, which looks like being available but isn't.
Presence is tied to an open dashboard: close the tab and you drop offline within a couple of minutes, so a ghost operator is shown to visitors for at most that long. See Live Agent.
Voice calls don't ring
Three switches have to agree, and they live in three different places:
- Your plan includes voice calls — see which plans include them; calls use the same operator seats as Live Agent.
- The per-site Voice calls switch is on, in Dashboard → Live Chat → Settings. It is off by default, so this is the one most often missed.
- The operator's own Calls switch is on, in the Live Chat header just left of the Online toggle, and that operator is online. An operator who has switched it off keeps taking text chats and simply stops being rung.
The visitor's call button also greys out with "Everyone is on another call right now" while every available operator is already on one, and lights up again when somebody hangs up.
A call connects but there is no sound
A blocked microphone does not produce this. If the browser has blocked the microphone for the dashboard, the call fails when you accept it, and the visitor is told the call couldn't be connected. If the connection between the two browsers drops, the call ends rather than staying open and silent. If a call stays connected with no sound, email support@novixagent.ai with your Website ID and the time of the call.
Two other honest limits worth knowing: switching networks mid-call (walking off Wi-Fi onto mobile data) ends the call, and on an iPhone locking the screen or leaving the browser mutes the microphone — that's iOS behaviour, which is why the widget asks the visitor to keep the screen open during a call.
An invited teammate can't see a section
Operator access is per website, per section, and deny-by-default — anything you didn't explicitly tick is hidden, and the data behind it is blocked rather than greyed out. A teammate invited with Everything in this account is the exception: one set of sections applies account-wide, so steps 1 and 2 about a particular website do not apply to them.
- Open Dashboard → Team → Operators & team invites (the owner's screen), click Edit on the member, tick the sections they need on that website, and Save access. Their current grants are pre-checked so you can see what they have before changing it.
- Check you granted it on the right website. Grants are independent per site — sharing three sites means ticking sections on each of the three.
- Some sections can never be granted to anyone, on any plan: Assistant and Channels are owner-only. So are plan and billing changes, creating or deleting websites, and the transcript settings of Live Agent. Switching Live Agent on and setting its working hours are not on a teammate's list either: they stay with the owner and with a partner working on your site (see Team & Operators). Live Chat, by contrast, is always included — it's what the operator role is for.
- Still stuck on the invite screen? Invites are valid for 72 hours, work once, and are bound to the exact email address you sent them to. Revoke it and send a fresh one.
See Team & Operators.
I can't change my plan — it says a change is already scheduled
Only one change can be booked at a time. If something is already scheduled for the end of your period, the plan picker is frozen and a second change is refused, because two booked changes would make the amounts hard to predict. Use Cancel scheduled change on the workspace card, then make the change you actually want.
Outside a free trial, these changes get scheduled for the end of the period, and therefore trigger this:
- downgrading to a cheaper plan,
- removing an add-on,
- switching from yearly to monthly billing.
These changes apply immediately and are not scheduled: upgrading, adding a feature or a message pack, and switching from monthly to yearly (immediate and prorated). While a change is already booked, these are refused too until you cancel it. Inside a free trial, changes apply at once and no schedule is created, so this does not arise. See Billing & plans.
Workspace statuses — what each one means
The status chip on a workspace card in Dashboard → Workspaces.
| Status | What it means for you |
|---|---|
| Paid | Active and fully working. The widget serves your site. It stays Paid after you cancel auto-renewal, until the end of the paid period. |
| Unpaid | No active subscription. The widget does not load — pick a plan to activate it. |
| Payment failed | A payment did not go through — a first payment, or a renewal Stripe is retrying. The widget is off until it's paid. Try again or use a different card — see Failed renewals. |
| Canceled | The period ended after cancellation. Your configuration and knowledge base are kept; re-subscribe to bring the widget back. |
| Suspended | The subscription is paused because the free trial ended with no payment method to charge. Open Manage subscription on the card to add one and settle it — see Trials. |
File statuses
The status shown against each item in Dashboard → Knowledge Base, for both uploaded documents and your typed note.
| Status | What it means for you |
|---|---|
| Learning | Being processed. Usually under a minute; a few minutes for a large file. |
| Learned | Indexed and ready — the agent is already answering from it. |
| Error | Processing failed. The note under the file says why — for example a corrupt or password-protected file, a scan with no text layer, or a file too large to read. |
Still stuck — how to ask for help
Email support@novixagent.ai from your account address, or ask in the chat, and include four things. They're what turns a round of guesswork into a single reply:
- What you tried, in the order you tried it.
- What you expected to happen.
- What actually happened, including the error message, copied word for word.
- Your Website ID. Find it in Dashboard → Workspaces, on the workspace card under Website Integration Code — it's the
data-user-idvalue in your embed snippet.
A screenshot of the browser console (F12) helps with widget problems, and the approximate time something happened helps with payment problems.