# PrimeWebKit — full reference

## What it is

PrimeWebKit is a multi-tenant AI chatbot SaaS. Accounts crawl a website, upload documents,
or write Q&A pairs to build a chatbot's knowledge base. Visitor questions are answered via
retrieval-augmented generation (relevant chunks retrieved, then passed to Google Gemini for
generation), with streaming responses over Server-Sent Events. Chatbots embed via a script
tag (floating widget) or a full-page chat interface at /chat?id={botId}.

## Pricing

- Free: $0/month — Try PrimeWebKit with no commitment. Includes: Create 1 chatbot, Embed it into your website.
- Starter: $59/month — For small businesses launching their first bot. Includes: 1 chatbot support, Lead capture, Read all conversations, Email support.
- Pro: $99/month — For growing teams that need the full toolkit. Includes: 3 chatbots, Multi-model AI support, Lead capture & conversation reading, Advanced priority support.
- Agency: custom pricing — For agencies managing multiple clients with custom needs. Includes: Unlimited chatbots, Unlimited messages, Multi-model AI support, White-label branding, Custom domain, Dedicated priority support.

## Core API (all versioned under /api/v1, JSON envelope: {status, success, message, data, errors, pagination})

Authentication: POST /auth/register, /auth/login, /auth/google (Google Identity Services
credential), /auth/refresh, /auth/logout. Bearer JWT access tokens (short-lived) plus an
opaque, server-revocable refresh token.

Chatbots: GET/POST /bots, GET/PUT/DELETE /bots/{uuid}, knowledge sources (text, Q&A,
website crawl, document upload) under /bots/{uuid}/knowledge-sources, widget config under
/bots/{uuid}/widget, conversations and leads under /bots/{uuid}/conversations and
/bots/{uuid}/leads, analytics under /bots/{uuid}/analytics.

Webhooks: GET /webhooks/events for supported event types (bot.created, bot.deleted,
chat.started, chat.completed, lead.created, subscription.created, subscription.updated,
user.created, knowledge.uploaded). GET/POST /webhooks, PUT /webhooks/{uuid} to toggle,
DELETE to remove, GET /webhooks/{uuid}/logs for delivery history. The signing secret is
returned exactly once, at creation.

Public widget (unauthenticated, used by the embedded script): GET
/widget/{botUuid}/config, POST /widget/{botUuid}/messages (and /messages/stream for SSE),
POST /widget/{botUuid}/leads to capture a lead, POST
/widget/{botUuid}/conversations/{id}/rate for visitor feedback.

Billing & teams: GET /subscriptions/plans, /subscriptions/current, /subscriptions/invoices;
POST /teams/{uuid}/invite; GET/POST /api-keys with rotation via POST /api-keys/{uuid}/rotate.

## Frequently asked questions

Q: How does PrimeWebKit train a chatbot on my content?
A: You crawl your website, upload documents (PDF, DOCX, TXT, MD, CSV), or write Q&A pairs. We chunk and embed that content, then retrieve the most relevant pieces for each visitor question — retrieval-augmented generation, so answers stay grounded in your actual content.

Q: Which AI model powers the chatbot?
A: PrimeWebKit uses Google Gemini for both chat generation and embeddings, with streaming responses.

Q: Can I use my own domain and remove PrimeWebKit branding?
A: Yes — white-label options are available on paid plans, including custom colors and removing our branding.

Q: How do webhooks work?
A: Register an endpoint URL and choose which events to receive — new leads, completed chats, subscription changes, and more. Each delivery is signed so you can verify it came from PrimeWebKit.

Q: Is there a free plan?
A: Yes, a free plan is available. Paid plans add volume, more bots, and white-label features.

Q: Can I invite my team?
A: Yes — invite teammates with owner, manager, or member roles to collaborate on shared chatbots.

## Blog

- Why retrieval-augmented chatbots reduce support tickets more than scripted ones (2026-06-02): Scripted decision-tree bots break the moment a customer phrases a question differently. Here's why grounding answers in your actual content changes that. — https://chat.primewebkit.com/blog/reduce-support-tickets-with-rag-chatbots
- Capturing leads from chat without turning the conversation into a form (2026-05-14): The best-converting chatbots ask for contact details after they've already been useful, not before. — https://chat.primewebkit.com/blog/chatbot-lead-capture-without-annoying-visitors
- Webhooks vs. polling: how to actually wire up chatbot events (2026-04-22): If your integration checks the API every few minutes for new leads, you're doing more work for a worse result. Here's the alternative. — https://chat.primewebkit.com/blog/webhooks-vs-polling-for-chatbot-integrations
- What actually belongs in your chatbot's knowledge base (and what doesn't) (2026-07-08): More content isn't automatically better. A knowledge base full of noise retrieves noise — here's how to decide what to feed it. — https://chat.primewebkit.com/blog/what-to-put-in-your-chatbots-knowledge-base
- A practical checklist for embedding a chatbot without breaking your site (2026-07-29): The install itself is one script tag. Here's everything worth checking before you call it done. — https://chat.primewebkit.com/blog/embed-checklist-before-going-live
- Free vs. paid chatbot: what actually changes (2026-03-18): A free plan should be enough to genuinely evaluate the product. Here's where the real differences start. — https://chat.primewebkit.com/blog/free-vs-paid-chatbot-differences
- Adding a chatbot to a small business website: a practical guide (2026-02-19): You don't need a developer, a big budget, or months of setup. Here's the realistic path. — https://chat.primewebkit.com/blog/chatbot-for-small-business-website
- AI chatbot for home remodeling and contractors (2026-02-26): Remodeling leads are won or lost in the hours after someone finds your site. Here's how a chatbot closes that gap. — https://chat.primewebkit.com/blog/ai-chatbot-for-home-remodeling-contractors
- AI chatbot for doctors and medical practices (2026-03-11): Patients ask the same handful of questions constantly. A chatbot handles the ones that don't require clinical judgment. — https://chat.primewebkit.com/blog/ai-chatbot-for-doctors-medical-practices
- AI chatbot for real estate agents and agencies (2026-04-15): Property questions come in at all hours, from people who are ready to move fast. Speed is the whole game. — https://chat.primewebkit.com/blog/ai-chatbot-for-real-estate-agents
- AI chatbot for restaurants (2026-04-29): Hours, menu questions, reservations, allergens — the questions are predictable. Let the bot handle them. — https://chat.primewebkit.com/blog/ai-chatbot-for-restaurants
- AI chatbot for law firms (2026-05-06): A chatbot for a law firm has one job above all others: qualify and capture, never advise. — https://chat.primewebkit.com/blog/ai-chatbot-for-law-firms
- AI chatbot for ecommerce stores (2026-05-20): Pre-purchase questions are where sales are won or abandoned. Answer them instantly instead of losing the tab. — https://chat.primewebkit.com/blog/ai-chatbot-for-ecommerce-stores
- AI chatbot for dentists and dental practices (2026-06-10): New patient questions are almost always the same ones. Handle them without tying up the front desk. — https://chat.primewebkit.com/blog/ai-chatbot-for-dentists
- AI chatbot for gyms and fitness studios (2026-06-24): Membership questions, class schedules, trial offers — a chatbot handles the front desk's most repeated conversation. — https://chat.primewebkit.com/blog/ai-chatbot-for-gyms-fitness-studios
- AI chatbot for businesses in London (2026-01-14): London's service market is dense and competitive — the business that answers first usually wins the enquiry. — https://chat.primewebkit.com/blog/chatbot-for-business-in-london
- AI chatbot for businesses in Manchester (2026-01-21): Manchester's fast-growing digital and creative sector expects the same speed from every business it deals with. — https://chat.primewebkit.com/blog/chatbot-for-business-in-manchester
- AI chatbot for businesses in Birmingham (2026-01-28): Birmingham's trades and manufacturing-heavy business base has some of the most repetitive, chatbot-friendly questions anywhere. — https://chat.primewebkit.com/blog/chatbot-for-business-in-birmingham
- AI chatbot for businesses in Glasgow (2026-02-04): Scotland's largest city has its own market dynamics, and a chatbot trained specifically on them outperforms a generic UK-wide script. — https://chat.primewebkit.com/blog/chatbot-for-business-in-glasgow
- AI chatbot for businesses in Leeds (2026-02-11): Leeds' financial and legal services sector has some of the most detail-sensitive customer questions in the country. — https://chat.primewebkit.com/blog/chatbot-for-business-in-leeds
- AI chatbot for businesses in Edinburgh (2026-02-18): Edinburgh's tourism-driven demand swings sharply through the year — a chatbot handles the volume without extra seasonal hiring. — https://chat.primewebkit.com/blog/chatbot-for-business-in-edinburgh
- AI chatbot for businesses in New York (2026-02-25): New York runs on speed and volume. A chatbot is one of the few ways a small business matches both. — https://chat.primewebkit.com/blog/chatbot-for-business-in-new-york
- AI chatbot for businesses in Los Angeles (2026-03-04): LA's sprawl means "nearby" means something different in every neighbourhood. A chatbot handles that nuance well. — https://chat.primewebkit.com/blog/chatbot-for-business-in-los-angeles
- AI chatbot for businesses in Chicago (2026-03-11): Chicago's weather drives seasonal demand spikes that a chatbot handles without seasonal hiring. — https://chat.primewebkit.com/blog/chatbot-for-business-in-chicago
- AI chatbot for businesses in Miami (2026-03-18): Miami's bilingual customer base and tourism-driven economy both favour a chatbot that's always available. — https://chat.primewebkit.com/blog/chatbot-for-business-in-miami
- AI chatbot for businesses in Austin (2026-03-25): Austin's rapid growth means more new residents comparing local businesses with no prior loyalty to any of them. — https://chat.primewebkit.com/blog/chatbot-for-business-in-austin
- AI chatbot for businesses in Seattle (2026-04-08): Seattle's tech-savvy customer base expects a digital-first experience — and its weather drives a lot of that research indoors. — https://chat.primewebkit.com/blog/chatbot-for-business-in-seattle
- Best AI Chatbots for Small Business Websites (2026) (2026-10-25): A balanced shortlist for small teams, with a practical way to compare answer quality, setup effort, lead handling, and real monthly cost. — https://chat.primewebkit.com/blog/best-ai-chatbot-for-small-business-websites
- Best Free AI Chatbots for Websites: What Free Plans Really Include (2026-10-25): Compare free chatbot options by testing their limits, visitor experience, and upgrade triggers instead of relying on the word “free.” — https://chat.primewebkit.com/blog/best-free-ai-chatbot-for-website
- Best AI Chatbots for WordPress Websites (2026-10-25): Compare WordPress chatbot options by installation path, content quality, plugin compatibility, and ongoing maintenance. — https://chat.primewebkit.com/blog/best-ai-chatbot-for-wordpress
- Best AI Chatbots for Lead Generation (2026-10-25): A fair framework for comparing lead-capture chatbots, including timing, qualification, consent, integrations, and follow-up. — https://chat.primewebkit.com/blog/best-ai-chatbot-for-lead-generation
- Chatbot Pricing Models Explained: Per Message, Per Resolution, or Flat Fee (2026-10-25): Understand chatbot pricing models and compare what a per-message, per-resolution, or flat monthly fee actually includes. — https://chat.primewebkit.com/blog/chatbot-pricing-models-explained
- Chatbot Agency vs DIY: What Does Each Approach Really Cost? (2026-10-25): Compare hiring an agency with building a chatbot yourself, including implementation, maintenance, ownership, and hidden costs. — https://chat.primewebkit.com/blog/chatbot-agency-vs-diy-cost
- Is an AI Chatbot Worth It for a Small Business? (2026-10-25): A practical break-even framework for deciding whether a website chatbot can save time or create useful leads for a small team. — https://chat.primewebkit.com/blog/is-an-ai-chatbot-worth-it-for-small-business
- Chatbot Not Showing on Your Website? A Step-by-Step Troubleshooting Guide (2026-10-25): Diagnose a missing chatbot widget by checking the embed, browser console, content security policy, caching, and device-specific behavior. — https://chat.primewebkit.com/blog/chatbot-not-showing-on-website-fixes
- Where Should You Put a Chatbot on Your Website? (2026-10-25): Choose chatbot placement based on visitor intent, page purpose, accessibility, and how staff will respond to conversations. — https://chat.primewebkit.com/blog/best-place-to-put-chatbot-on-website
- Does a Chatbot Slow Down Your Website? How to Measure Its Impact (2026-10-25): Measure the performance cost of a chatbot widget and reduce avoidable impact without relying on unsupported speed claims. — https://chat.primewebkit.com/blog/chatbot-website-speed-impact
- How to Train a Chatbot on PDF Documents (2026-10-25): Prepare PDFs for a chatbot by checking text quality, structure, freshness, permissions, and answers against the original document. — https://chat.primewebkit.com/blog/train-chatbot-on-pdf
- How to Train a Chatbot on Your Website Content (2026-10-25): Build a website knowledge base that stays accurate by selecting trusted pages, handling duplicates, testing coverage, and maintaining updates. — https://chat.primewebkit.com/blog/train-chatbot-on-website-content
- How to Stop an AI Chatbot from Hallucinating Wrong Answers (2026-10-25): Reduce unsupported chatbot answers with trusted sources, explicit uncertainty rules, realistic tests, monitoring, and human escalation. — https://chat.primewebkit.com/blog/stop-ai-chatbot-hallucinating-wrong-answers
- Chatbot System Prompt Examples for Website Support (2026-10-25): Adapt practical chatbot system prompt examples for scope, source-grounded answers, lead capture, and human escalation. — https://chat.primewebkit.com/blog/chatbot-system-prompt-examples
- How to Use a Multilingual Chatbot on Your Website (2026-10-25): Plan multilingual chatbot content, language coverage, terminology review, and safe escalation for international visitors. — https://chat.primewebkit.com/blog/multilingual-website-chatbot
- Chatbot Lead Capture Questions: Examples That Qualify Without Interrogating (2026-10-25): Use concise, respectful chatbot questions to understand a visitor's need, collect only useful details, and set up a clear follow-up. — https://chat.primewebkit.com/blog/chatbot-lead-capture-questions-examples
- How to Send Chatbot Leads to a CRM with Zapier or Webhooks (2026-10-25): Plan a reliable lead handoff from chatbot to CRM, including field mapping, consent, duplicate handling, retries, and monitoring. — https://chat.primewebkit.com/blog/send-chatbot-leads-to-crm-zapier-webhooks
- Chatbot vs Contact Form: Which Converts Better for Your Website? (2026-10-25): Choose between a chatbot and a contact form based on visitor intent, question complexity, staffing, accessibility, and follow-up. — https://chat.primewebkit.com/blog/chatbot-vs-contact-form

## Security

JWT authentication with account lockout after repeated failed logins, parameterized SQL
throughout, SSRF protection (with redirect-hop re-validation) on website crawling and
outgoing webhooks, rate limiting with a stricter cost-aware limit on AI-generating
endpoints, prompt-injection screening on retrieved knowledge-base content, and CORS with
credentialed responses only for explicit origin matches. Full detail: https://chat.primewebkit.com/security.

## Contact

General: hello@primewebkit.com
Security disclosures: security@primewebkit.com