Systeeminstellingen
Pad: /dashboard/settings · Rechten: Module Instellingen
Verfijn elk aspect van je FRENZY.BOT-instantie — AI-gedrag, branding, widget-configuratie, lead-vastlegging en systeembeheer. Elk tabblad beheert een ander deel van het systeem.
Wat deze pagina beantwoordt
- Hoe verbind of wijzig ik AI-modellen?
- Hoe controleer ik de kwaliteit en lengte van antwoorden?
- Hoe pas ik de branding en het gedrag van de widget aan?
- Hoe configureer ik lead-vastlegging en overdracht?
- Hoe beheer ik instellingen op systeemniveau?
AI Engine
Configureer je AI-provider en de selectie van modellen. Dit is het eerste dat moet worden ingesteld — zonder AI-provider kan de bot geen antwoorden genereren.
| Instelling | Wat het doet | Hoe te gebruiken |
|---|---|---|
| Verbind OpenRouter | Koppel je OpenRouter-account via beveiligde OAuth | Klik op de knop, autoriseer in de popup, klaar |
| API Key | Alternatief voor OAuth — plak direct een OpenRouter API-sleutel | Haal een sleutel op via openrouter.ai → API Keys |
| Model Selector | Kies welk AI-model de gesprekken afhandelt | Elke optie toont de provider, contextvenster en prijsklasse |
| Tavily API Key | Schakel live zoeken op het web in als de kennisbank geen antwoord heeft | Haal een sleutel op via tavily.com |
| Zero Data Retention | Voorkom dat AI-providers je data opslaan of gebruiken voor training | Schakel in voor privacygevoelige bedrijven |
Als de LLM-gezondheidsindicator rood is: Verbind OpenRouter opnieuw of controleer of je API-sleutel geldig is en over voldoende credits beschikt.
Voor de volledige gids voor modelvergelijking, zie AI Models & Providers.
Modelgedrag
Bepaal hoe de AI antwoorden genereert. Deze instellingen beïnvloeden elk gesprek via alle kanalen.
| Instelling | Wat het doet | Bereik | Aanbevolen |
|---|---|---|---|
| Temperatuur | Regelt creativiteit vs. precisie | 0.0–1.0 | 0.3–0.5 voor support; 0.7+ voor creatief |
| Top-P | Regelt de diversiteit aan antwoorden naast temperatuur | 0.0–1.0 | 0.9 (standaard werkt goed voor de meeste gevallen) |
| Max Tokens | Beperkt de maximale lengte van elk AI-antwoord | 64–8192 | 1024–2048 voor standaard supportgebruik |
| Global System Prompt | Instructies die elk AI-antwoord vormgeven | Vrije tekst | Beperk tot 3–5 duidelijke, beleidsgerichte zinnen |
Gids voor systeemprompts
De systeemprompt is de meest impactvolle instelling voor de kwaliteit van de antwoorden. Het definieert:
- Persoonlijkheid — "Je bent een behulpzame, professionele klantenservicemedewerker voor [Bedrijf]."
- Kaders — "Beantwoord alleen vragen over onze producten. Voor al het andere verwijs je beleefd door."
- Toon — "Wees vriendelijk maar beknopt. Vermijd jargon."
- Opmaak — "Gebruik opsommingstekens voor lijsten. Houd antwoorden onder de 3 paragrafen."
- Beperkingen — "Deel nooit publiekelijk prijzen. Verwijs vragen over prijzen door naar het salesteam."
Voorbeeld systeemprompt:
Je bent een professionele support assistent voor Acme Corp. Beantwoord vragen over onze producten uitsluitend op basis van de verstrekte kennisbank. Wees vriendelijk, beknopt en gebruik opsommingstekens bij het opsommen van functies. Als je het antwoord niet weet, zeg dit dan eerlijk en stel de gebruiker voor om contact op te nemen met support@acme.com.
Minder is meer
De beste systeemprompts zijn kort en bondig. Lange, wijdlopige instructies versnipperen de aandacht van het model, verspillen tokens en spreken zichzelf vaak tegen.
Branding
{
.light-only }
Pas de visuele identiteit van je bot aan.
| Instelling | Details |
|---|---|
| Primaire kleur | Hoofdkleur gebruikt in de widget en het dashboard |
| Secundaire kleur | Accentkleur voor knoppen en markeringen |
| Typografie | Kies uit premium lettertypefamilies (taalbewust) |
| Logo | Upload je logo (min. 200px breed, geschaald naar max. 350px) |
| Favicon | Upload favicon (min. 16x16, vierkant bijgesneden, max. 48x48) |
| Custom CSS | Geavanceerde stijlaanpassingen voor het dashboard |
Zie voor details Branding & Media.
Widget
Configureer de chatinterface die op je website verschijnt. Deze instellingen bepalen wat de eindgebruiker ziet.
| Instelling | Wat het doet | Tips |
|---|---|---|
| Widget Titel | Naam die bovenaan het chatvenster wordt getoond | Gebruik je merk- of botnaam (bijv. "Acme Support") |
| Welkomstbericht | Eerste bericht dat gebruikers zien bij het openen | Houd het kort en actiegericht: "Hoi! Stel me al je vragen over onze producten." |
| Positie | Plaatsing rechtsonder of linksonder op de pagina | Rechtsonder is de industriestandaard |
| Avatar | Profielafbeelding van de bot in de chat | Kies uit de galerij of upload je eigen (auto-resize naar 100x100) |
| Suggestievragen | Vooraf geschreven prompts getoond als knoppen onder het welkomstbericht | Voeg 3–4 van je meest voorkomende vragen toe om gebruikers te sturen |
| Talen | Welke talen de widget ondersteunt voor eindgebruikers | Elke ingeschakelde taal voegt een taalschakelaar toe in de widget |
Best practices voor suggestievragen
Suggestievragen verschijnen als klikbare knoppen die gebruikers kunnen aantikken in plaats van typen. Ze verhogen de betrokkenheid aanzienlijk:
- Gebruik echte klantvragen — "Wat zijn jullie tarieven?" in plaats van "Vertel me over prijzen"
- Behandel je top 3–4 onderwerpen — Prijzen, functies, support, contact
- Houd ze kort — Minder dan 50 tekens per stuk
- Update ze regelmatig — Gebaseerd op wat gebruikers daadwerkelijk vragen (bekijk Analytics)
Zie voor details over de insluitcode Widget & Embed Code.
Leadformulier
Bepaal welke velden worden verzameld wanneer een lead wordt vastgelegd in de chat. Het leadformulier verschijnt in de widget wanneer dit wordt getriggerd door intentie-detectie of configuratieregels.
| Veld | Standaard | Verplicht? | Notities |
|---|---|---|---|
| Naam | Ingeschakeld | Ja | Volledige naam — altijd zichtbaar voor de gebruiker |
| Ingeschakeld | Ja | Primair contactveld — gebruikt voor integraties | |
| Telefoon | Uitgeschakeld | Nee | Inschakelen als je salesteam telefonisch opvolgt |
| Bedrijf | Uitgeschakeld | Nee | Nuttig voor B2B-bedrijven |
| Aangepaste velden | Geen | Nee | Voeg dropdowns, checkboxes of vrije tekstvelden toe voor branche, budget, tijdlijn, etc. |
Wanneer verschijnt het leadformulier?
Het formulier wordt automatisch getriggerd wanneer:
- De bot een koopintentie detecteert of een verzoek om contact op te nemen
- De gebruiker expliciet vraagt om contactgegevens achter te laten
- Een geconfigureerd aantal berichten is uitgewisseld (indien ingesteld)
Aangepaste veldtypes
| Type | Use Case | Voorbeeld |
|---|---|---|
| Tekst | Open vragen | "Wat is je grootste uitdaging?" |
| Dropdown | Vooraf gedefinieerde keuzes | Branche: Technologie, Financiën, Zorg |
| Checkbox | Opt-in / toestemming | "Ik ga akkoord om gecontacteerd te worden" |
Minder velden = hogere conversie
Elk extra verplicht veld verlaagt de voltooiingspercentages met 10–20%. Begin met Naam + E-mail en voeg alleen meer toe als je salesteam de data daadwerkelijk gebruikt.
Voor leadbeheer, zie Lead Management.
Humane Overdracht (Handoff)
Schakel menselijke overname in wanneer de AI niet voldoende is. Wanneer een gebruiker om een medewerker vraagt, pauzeert de bot en wordt het gesprek doorgeleid naar een live agent in het dashboard.
| Instelling | Wat het doet | Voorbeeld |
|---|---|---|
| Schakel Overdracht in | Hoofdschakelaar voor de volledige overdrachtfunctie | Moet aan staan voor Live Chat |
| Trigger Trefwoorden | Woorden/zinnen die de bot aanzetten tot overdracht | "praat met een mens", "spreek medewerker", "echt persoon" |
| Meldingen | Hoe agents worden gewaarschuwd bij een overdrachtverzoek | E-mail, webhook, of dashboard-notificatie |
| SLA Timeout | Hoe lang te wachten op een agent voordat wordt teruggevallen op lead-vastlegging | bijv. 5 minuten — als er geen agent deelneemt, toon het leadformulier |
Checklist voor installatie
- Zet Schakel Overdracht in aan
- Voeg veelvoorkomende trefwoorden toe die je klanten gebruiken
- Configureer ten minste één notificatiemethode zodat agents weten wanneer ze moeten inspringen
- Stel een SLA-timeout in zodat gebruikers niet oneindig wachten
- Zorg dat agents de Handoff module hebben ingeschakeld in hun rolmachtigingen
Voor de volledige overdracht-workflow en de gids voor de werkruimte voor agents, zie Live Chat (Handoff).
Infrastructuur
Real-time gezondheidsmonitoring voor alle kernonderdelen van het systeem. Elke indicator heeft een kleurcode:
| Indicator | Kleur bij gezond | Wat het controleert | Indien rood |
|---|---|---|---|
| DB | Groen | Databaseverbinding, query-gezondheid en opslag | Neem contact op met je accountmanager — de database heeft aandacht nodig |
| VEC | Groen | Beschikbaarheid van de zoekmachine voor de kennisbank | Neem contact op met je accountmanager — de vector-zoekdienst heeft aandacht nodig |
| LLM | Groen | Verbinding met AI-provider (OpenRouter) en geldigheid API-sleutel | Ga naar AI Engine tab → verbind OpenRouter opnieuw of controleer je API-sleutel |
| Groen | Status van de WhatsApp-dienst en API-bereikbaarheid | Controleer het WhatsApp-kanaal in Kanalen, of neem contact op met je accountmanager |
Snelle gezondheidscheck
Bezoek dit tabblad wanneer er iets niet goed lijkt te werken. Als alle indicators groen zijn, ligt het probleem waarschijnlijk in je configuratie (systeemprompt, inhoud kennisbank) in plaats van de infrastructuur.
Voor gedetailleerde stappen voor probleemoplossing, zie Troubleshooting.
Systeem
Algemene administratieve instellingen die het gehele dashboard en systeemgedrag beïnvloeden.
| Instelling | Wat het doet | Notities |
|---|---|---|
| Projectnaam | Getoond in dashboardheader, browsertabblad en widget | Gebruik je bedrijfs- of productnaam |
| Systeemtijdzone | Regelt tijdsaanduiding in logs, rapporten en gesprekken | Stel in op je eigen tijdzone voor accurate rapportage |
| Max Sessieduur | Hoe lang dashboardgebruikers ingelogd blijven voor her-authenticatie | Opties van 1 uur tot 1 maand — korter is veiliger |
| Dashboard Talen | Welke talen verschijnen in de taalschakelaar van het dashboard | Ondersteunt momenteel Engels, Spaans, en Hebreeuws (met RTL) |
Sessiebeveiliging
Kortere sessieduren zijn veiliger, maar vereisen vaker inloggen. Gebruik voor teams die computers delen 1–4 uur. Voor persoonlijke apparaten is 1 week of 1 maand handig.
Eigen Domein (Custom Domain)
Configureer een branded URL voor je bot (bijv. https://bot.jouwbedrijf.nl).
Zie voor de volledige gids Custom Domains.
Danger Zone
Handelingen met een grote impact die expliciete bevestiging vereisen. Deze acties kunnen niet ongedaan worden gemaakt.
| Actie | Wat het doet | Wat blijft behouden |
|---|---|---|
| Export Data | Downloadt een back-up van de gegevens van de huidige bot (kennisbank, gesprekken, leads) | Alles — dit is alleen-lezen |
| Factory Reset | Verwijdert alle geïndexeerde inhoud, gesprekken, leads en analytics voor de bot | Bot-configuratie (instellingen, branding, gebruikers) — alleen data wordt verwijderd |
Wanneer Factory Reset gebruiken
- Na het testen opnieuw beginnen — alle testgesprekken en leads verwijderen
- Een bot inzetten voor een ander doeleinde
- Opschonen voordat je opnieuw indexeert met nieuwe content
Wanneer Export Data gebruiken
- Voordat je een Factory Reset uitvoert
- Voor compliance — periodieke gegevensback-ups
- Migreren van gegevens naar een ander systeem
Factory Reset is definitief
Deze handeling kan niet ongedaan worden gemaakt. Alle geïndexeerde content, gesprekken, leads en statistieken worden permanent verwijderd. Exporteer altijd eerst je data als je deze later nog nodig zou kunnen hebben.
Veelgestelde vragen (FAQ)
V: De AI stopte met antwoorden nadat ik de instellingen had gewijzigd.
- Verbind OpenRouter opnieuw in het tabblad AI Engine. Controleer of er een model is geselecteerd en of de API-sleutel geldig is.
V: Wijzigingen zijn niet toegepast na het opslaan.
- Vernieuw de pagina. Als de wijzigingen nog steeds niet verschijnen, controleer dan of de database bereikbaar is (DB-gezondheidsindicator moet groen zijn).
V: Waar worden instellingen opgeslagen?
- Alle instellingen worden veilig opgeslagen in de database. Ze blijven behouden bij herstarts en worden onmiddellijk van kracht — geen technische configuratie vereist.