Kernconcepten

Het begrijpen van deze bouwstenen maakt elke andere functie in FRENZY.BOT gemakkelijker te gebruiken. Deze pagina legt in begrijpelijk Nederlands uit hoe het systeem werkt.

Hoe FRENZY.BOT werkt

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Uw Data    │ ──→ │  Indexering  │ ──→ │   Qdrant    │
│Bestanden,URL│     │ (Embeddings) │     │ (Vector DB) │
│    FAQs     │     └──────────────┘     └──────┬──────┘
└─────────────┘                                 │
                                                │ ophalen
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Gebruikers-│ ──→ │  FRENZY.BOT  │ ──→ │  AI-model   │
│   vraag     │     │ (RAG Engine) │ ←── │(via OpenRouter)│
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │   Antwoord  │
                    │ + Lead Data │
                    │ + Analytics │
                    └─────────────┘

U uploadt uw data — bestanden, website-URL's en FAQ-paren gaan naar de Knowledge Base.
Het systeem indexeert het — inhoud wordt omgezet in numerieke embeddings en opgeslagen in Qdrant (vector database), zodat er gezocht kan worden op betekenis in plaats van alleen op trefwoorden.
Een gebruiker stelt een vraag — via de widget, WhatsApp, Telegram of een ander verbonden kanaal.
FRENZY.BOT haalt relevante inhoud op — het systeem vindt de meest relevante stukken uit uw kennisbank met behulp van semantisch zoeken.
Het AI-model genereert een antwoord — de opgehaalde inhoud + de vraag van de gebruiker worden naar het AI-model (Claude, GPT, Gemini, etc.) gestuurd via OpenRouter.
Alles wordt bijgehouden — het gesprek, de reactietijd, het tokenverbruik en eventueel vastgelegde leadgegevens worden opgeslagen voor rapportage.

Bot

Uw bot is de AI-assistent die u bouwt. Elke bot heeft zijn eigen:

Knowledge base — De documenten, URL's en FAQ's waarvan hij leert.
Instellingen — AI-model, system prompt, temperatuur, branding, widget-configuratie.
Gesprekken — Chatgeschiedenis met gebruikers.
Leads — Contacten vastgelegd tijdens gesprekken.
Analytics — Gebruiksstatistieken en funnel-gegevens.
Widget — Een eigen insluitcode met unieke data-bot-id.

In een multi-bot setup kunt u meerdere bots draaien vanuit één enkele installatie — elk volledig gescheiden van de anderen.

Beheerlocatie: Instellingen, Knowledge Base, Insluiten (Embed) en het werkruimte-dropdownmenu in de header.

Knowledge Base (Kennisbank)

De knowledge base is de bibliotheek die uw bot raadpleegt voordat hij een vraag beantwoordt. Dit is wat uw bot specifiek maakt voor uw bedrijf in plaats van een generieke AI.

Drie databronnen:

Bron	Best voor	Indexeringssnelheid
Bestanden (PDF, DOCX, TXT, CSV, etc.)	Interne documenten, beleid, productspecificaties	Minuten
URL's (elke publieke webpagina)	Website content, helpartikelen, blogposts	Minuten
FAQ's (handmatige V&A-paren)	Kritieke antwoorden die u exact wilt beheren	Direct

Kernprincipe: Als een onderwerp niet in de kennisbank staat, kan de bot generiek antwoorden of weigeren te antwoorden. Hoe meer relevante inhoud u toevoegt, hoe beter de bot presteert.

Voor de volledige gids, zie Knowledge Base.

Kanalen (Channels)

Kanalen zijn de plaatsen waar uw gebruikers communiceren met de bot.

Kanaal	Type	Setup
Website widget	Primair	Embed-script op uw site
WhatsApp	Messaging	WAHA Docker + QR-code koppeling
Telegram	Messaging	Bot token van @BotFather
Discord	Community	Bot token van Developer Portal
Instagram	Social	Page Access Token
Messenger	Social	Facebook-pagina integratie
Slack	Werkplek	App token
Webhook	Custom	Elk HTTP-eindpunt

Elk kanaal kan zijn eigen antwoordstijl hebben — de AI past zijn toon en antwoordlengte aan het platform aan (bijv. korter op WhatsApp, gedetailleerder op de website-widget).

Voor details, zie Kanalen.

Sessies & gesprekken

Een sessie is één volledig gesprek tussen een gebruiker en uw bot. Elke sessie houdt het volgende bij:

Berichten — Elke vraag en elk antwoord in het gesprek.
Tokens — Hoeveel AI-tokens er zijn verbruikt (beïnvloedt de kosten).
Duur — Hoe lang het gesprek duurde.
Bron — Van welk kanaal het gesprek afkomstig was.
Lead-gegevens — Eventuele contactinformatie die tijdens de chat is vastgelegd.

Sessies vormen de basis voor analyses, kwaliteitsbeoordeling en lead-capture. Bekijk ze in Gesprekken.

Leads & integraties

Een lead is een contactpersoon die tijdens een chat is vastgelegd — naam, e-mail, telefoon, bedrijf en eventuele aangepaste velden die u heeft geconfigureerd.

Leads stromen door een pijplijn:

Nieuw → Gecontacteerd → Gekwalificeerd → Geconverteerd (of Verloren)

Integraties sturen leads automatisch door naar uw externe tools:

E-mail — SMTP-notificaties naar uw team.
Webhook — JSON-payloads naar uw eigen eindpunten.
Google Sheets — Rijen toevoegen voor een lichtgewicht CRM.
MailChimp — Contacten toevoegen aan e-mailmarketinglijsten.

Voor details, zie Leadbeheer en Integraties.

Modules

Modules zijn optionele functies die u kunt in- of uitschakelen zonder het kernsysteem te beïnvloeden:

Module	Wat het doet
Live Web Access (Tavily)	Laat de bot het live web doorzoeken wanneer interne data niet volstaat
Human Handoff	Scaleren van gesprekken naar menselijke agenten
Text-to-Speech	Zette AI-antwoorden om in audio
Afspraak Boeken	In-chat planning via Calendly
Lead Formulier	Legt contactinformatie vast halverwege het gesprek
WhatsApp	Geautomatiseerde berichten via WAHA

Bekijk en beheer modules in Modules.

Snelle zelfcontrole

Gebruik deze checklist om te controleren of uw bot volledig operationeel is:

[ ] Knowledge base gevuld — Ten minste één bestand, URL of FAQ toegevoegd met de status Live.
[ ] OpenRouter verbonden — AI Engine toont een verbonden provider en geselecteerd model.
[ ] Widget geïmplementeerd — Embed-script staat op uw website en de chatbubbel verschijnt.
[ ] Integraties ingeschakeld — Leads worden doorgestuurd naar uw CRM, e-mail of webhook.

Als alle vier de punten waar zijn, is uw systeem volledig functioneel en klaar voor live verkeer.