# NuovaBot — Full LLM Context

> NuovaBot is a multi-tenant SaaS platform that lets businesses create AI chatbots trained on their own knowledge base. It is designed for non-technical users: upload your documents, configure your chatbot's persona and behavior, then deploy in minutes via an embeddable widget, a hosted chat page, or a REST API. Powered by Anthropic Claude (Haiku default, Sonnet on higher plans).

## What NuovaBot Does

NuovaBot enables any business to build a custom AI support chatbot without writing code. The core workflow is:

1. **Upload documents** — PDF, DOCX, TXT, Markdown, CSV (up to 10 MB each). NuovaBot automatically chunks, embeds, and indexes them using OpenAI text-embedding-3-small and pgvector.
2. **Configure the chatbot** — Set a persona, tone, welcome message, fallback message, and custom instructions. Choose whether the bot answers only from documents, uses general knowledge, or a mix.
3. **Deploy anywhere** — Copy a script tag to embed a floating chat bubble, share a hosted URL, or integrate via REST API (SSE streaming responses).

## Plans and Pricing

| Plan     | Price     | Chatbots | Messages/mo | Documents  | Storage | Key Features |
|----------|-----------|----------|-------------|------------|---------|--------------|
| Free     | $0/mo     | 1        | 25          | 5          | 5 MB    | Widget, hosted page |
| Starter  | $29/mo    | 2        | 1,000       | 25/chatbot | 50 MB   | API access, actions (ticket/booking) |
| Pro      | $79/mo    | 5        | 4,000       | 100/chatbot| 500 MB  | Claude Sonnet, remove branding, full analytics |
| Business | $199/mo   | 10       | 10,000      | Unlimited  | 2 GB    | 2,000 Sonnet msgs included, full analytics + export |

Annual billing saves 17%. Overage pricing available on paid plans (pay-per-message beyond monthly limit).

## Features

### Knowledge Base
- Supported formats: PDF, DOCX, TXT, Markdown (.md), CSV
- Automatic chunking, embedding (OpenAI text-embedding-3-small), and vector indexing (pgvector)
- Per-chatbot document limits by plan
- Document processing is asynchronous (typically under 30 seconds)

### AI Chat Engine
- Powered by Anthropic Claude (claude-haiku-4-5 default, claude-sonnet-5-5 on Pro/Business)
- Retrieval-Augmented Generation (RAG): semantic search over embedded document chunks
- Prompt caching for cost efficiency
- Knowledge mode control: Documents Only / General Knowledge / Specific Topics
- Streaming responses via Server-Sent Events (SSE)
- Configurable persona, tone, welcome message, fallback message

### Deployment Options
1. **JavaScript Widget** — embed a floating chat bubble on any website with one script tag. Renders in Shadow DOM (no style conflicts). Lazy-loads after page is interactive.
2. **Hosted Chat Page** — a public URL at nuovabot.com/chat/[chatbot-id]. Share in emails, support pages, or anywhere a direct link is better than an embedded widget.
3. **REST API** — POST /api/v1/chat with SSE streaming. Supports conversation continuity via conversationId. Authenticate with X-API-Key header.

### Chatbot Actions (Starter plan and above)
The chatbot can take actions on behalf of customers:
- **Ticket creation** — creates a support ticket when a customer reports an issue, assigns a reference number, sends email notification to staff
- **Meeting booking** — shares a booking link, collects customer details and emails staff, or sends a webhook
- **Live agent handoff** — detects when a customer wants to speak to a human, fires a webhook compatible with Crisp, Intercom, and custom endpoints

### Appearance Customization
- Custom primary color (hex)
- Custom font (from a curated selection of Google Fonts)
- Branding removal ("Powered by NuovaBot" footer) — Pro plan and above
- EU AI Act Article 50(1) disclosure ("AI assistant" label + notice that the visitor is chatting with an AI) — shown on every plan, not removable
- Changes apply live without re-deploying the widget

### Analytics (Starter plan and above)
- Total conversations, total messages, average response time, active chatbots
- Message usage history (chart, last 7/30/90/365 days)
- Per-chatbot breakdown
- Recent conversation viewer
- CSV export (Pro/Business)

### Security & Compliance
- Full data isolation per organization (multi-tenant architecture)
- API keys hashed with SHA-256, never stored plaintext
- Supabase Auth (JWT) for dashboard access
- GDPR compliant — Data Processing Agreement (DPA) available
- EU-hosted infrastructure

## SSE Response Format

When using the REST API or widget, responses are streamed as Server-Sent Events:

```
event: token
data: {"text": "Hello! I can help"}

event: token
data: {"text": " you with that."}

event: done
data: {"conversationId": "...", "messageId": "..."}

event: tool_start
data: {"toolCallId": "...", "toolName": "create_ticket"}

event: tool_result
data: {"toolCallId": "...", "toolName": "create_ticket", "success": true, "result": "TK-0042"}

event: error
data: {"message": "Rate limit exceeded"}
```

## Rate Limits

| Plan     | Messages/min | Messages/day | Messages/month |
|----------|-------------|--------------|----------------|
| Free     | 3           | 25           | 25             |
| Starter  | 10          | 200          | 1,000          |
| Pro      | 20          | 500          | 4,000          |
| Business | 50          | 1,000        | 10,000         |

Rate limits are enforced per organization using a Redis sliding window. HTTP 429 returned when exceeded.

## Authentication

- **API Key** (widget & server-side): X-API-Key header. Generated per chatbot. SHA-256 hashed at rest.
- **Bearer JWT** (dashboard): Supabase session tokens via Authorization header. Handled automatically by the dashboard.

## Use Cases

### E-Commerce
- Answer product questions 24/7 (sizing, specs, shipping, returns) without hiring more support staff
- Reduce cart abandonment by giving instant answers during the buying decision
- Train on product catalog, FAQ, return policy, shipping information
- Escalate complex issues to human agents via live handoff

### SaaS Companies
- Deflect support tickets by answering common how-to questions from product docs
- Onboard new users faster by training the chatbot on tutorials and documentation
- Collect issue details and create tickets automatically
- Free up support team for complex, high-value interactions

### Digital Agencies
- Offer white-label chatbots as a value-add service for clients
- Create separate chatbots for each client — full multi-tenancy
- Remove NuovaBot branding on Pro plan and above
- Charge clients recurring fees for a service you manage in minutes

### Consultancies
- Scale your expertise: let clients ask questions about your methodology 24/7
- Train the chatbot on your frameworks, case studies, and FAQs
- Capture leads by collecting names and emails when users ask to speak with an expert

## Frequently Asked Questions

**What is NuovaBot?**
NuovaBot is a SaaS platform that lets businesses create AI chatbots trained on their own documents. You upload your content, configure the chatbot's behavior, and deploy it anywhere — no coding required.

**How does NuovaBot differ from ChatGPT?**
ChatGPT answers from general training data. NuovaBot answers specifically from the documents you upload. Your chatbot knows your products, your policies, and your company — not generic AI knowledge.

**What AI model powers NuovaBot?**
NuovaBot uses Anthropic's Claude. Free and Starter plans use Claude Haiku (fast, efficient). Pro and Business plans include Claude Sonnet (more capable, better reasoning).

**How long does setup take?**
Most businesses have their first chatbot live in under 10 minutes. Create an account, upload your documents, and paste the widget script tag on your site.

**Is NuovaBot GDPR compliant?**
Yes. Each organization's data is fully isolated. We do not use your data to train AI models. A Data Processing Agreement (DPA) is available. Infrastructure is hosted in the EU.

**Can I remove "Powered by NuovaBot" branding?**
Yes, on the Pro plan ($79/mo) and above.

**What file types can I upload?**
PDF, DOCX, TXT, Markdown (.md), and CSV. Maximum 10 MB per file.

**How is NuovaBot different from Intercom?**
Intercom is a full customer engagement platform starting at $74/seat/month. NuovaBot is an AI-first chatbot builder starting at $29/month (no per-seat pricing). NuovaBot's chatbot is specifically trained on your documents; Intercom's AI is a general-purpose layer on top of a ticketing system.

**How is NuovaBot different from Tidio?**
Tidio offers a generic ChatGPT-powered chatbot. NuovaBot trains specifically on your uploaded documents, so responses come from your actual content — not general AI knowledge. NuovaBot also has a more powerful API and actions system.

**Does the chatbot support multiple languages?**
The chatbot responds in whatever language the user writes in — it is not limited to English or Dutch. The NuovaBot dashboard is available in English and Dutch.

**What happens when the chatbot cannot answer a question?**
You can configure a custom fallback message. The chatbot can also be configured to create a support ticket automatically when it cannot answer, escalating to your team.

## Contact

- **Website**: https://nuovabot.com
- **Support**: support@nuovabot.com
- **Sales**: sales@nuovabot.com
- **Privacy Policy**: https://nuovabot.com/privacy
- **Terms of Service**: https://nuovabot.com/terms
- **DPA**: https://nuovabot.com/dpa