Chatbot Builder - Help
Volledige gids voor het maken van AI-chatbots op basis van diverse documenten en webbronnen
Overzicht
Chatbot Builder (Chatbotty.ai) is een voor Redis Cache geoptimaliseerd platform voor het maken van AI-chatbots op basis van diverse documenten en webbronnen. Het is bedoeld voor iedereen die kwalitatieve antwoorden moet bieden op gebruikersvragen op basis van actuele documenten en bronnen - overheidsinstellingen, organisaties, bedrijven en particulieren.
β¨ Belangrijkste functies
π€ AI en verwerking
- β’ AI-chatbots op basis van diverse documenten en webbronnen
- β’ Slimme AI-routering voor optimale antwoordkwaliteit
- β’ Vectordatabase voor semantisch zoeken
- β’ Geavanceerde chunking per documenttype
β‘ Prestaties en betrouwbaarheid
- β’ Meerlaagse caching (Geheugen β Redis β PostgreSQL)
- β’ Asynchroon widget zonder impact op paginasnelheid
- β’ Bescherming tegen misbruik en botaanvallen
- β’ Flexibele snelheidslimieten per chatbot
π Beheer en analyse
- β’ Uitgebreide personalisatie- en configuratiemogelijkheden
- β’ Automatische documentvervanging bij nieuwe versies
- β’ Realtime analyse en kwaliteitsoptimalisatie
- β’ Automatisch abonnements- en tariefbeheer
π― Ideaal voor
- Overheidsinstellingen en publieke instellingen
Automatisering van informatiediensten voor burgers, antwoorden op veelgestelde vragen over officiΓ«le procedures
- E-commerce en online diensten
Slimme klantenondersteuning zonder callcenter, afhandeling van bestellingen en klachten
- Bedrijven met uitgebreide documentatie
Snel zoeken in interne bronnen, onboarding van nieuwe medewerkers
- Onderwijsinstellingen
Ondersteuning voor studenten en antwoorden op veelgestelde vragen, informatie over studieprogramma's
- Zorginstellingen
PatiΓ«ntinformatie en administratieve ondersteuning, patiΓ«ntgidsen
- Advocatenkantoren
Snelle toegang tot juridische documenten en precedenten, analyse van juridische zaken
- IT- en technologiebedrijven
Automatisering van technische ondersteuning en API-documentatie, oplossing van veelvoorkomende problemen
- Adviesbureaus
Delen van expertise en best practices, interne kennisbank
- Marketingbureaus
Analyse van klantbehoeften en contentoptimalisatie, hulp bij creatieve briefings
Aan de slag
π― Snelstartgids
- 1Registratie en inloggen
Maak uw account aan. U krijgt automatisch het Evaluation-abonnement voor 14 dagen met 3.000 berichten/maand (meer dan de 500 van Elite) plus alle Elite-functies.
- 2Uw eerste chatbot maken
Klik op "Nieuwe Chatbot" β voer naam en beschrijving in β kies antwoordstijl (formeel/vriendelijk/professioneel). Na het aanmaken wordt u doorgestuurd naar gedetailleerde instellingen waar u alle chatbotparameters naar wens kunt aanpassen.
- 3Document uploaden
Sleep PDF/DOCX/TXT/MD-bestanden of voer een webpagina-URL in. U kunt het documenttype kiezen voor een optimale chunkingstrategie (juridisch, technisch, academisch, nieuws, algemeen).
- 4Testen en insluiten
Test de chatbot in voorbeeldmodus β kopieer de insluitcode β voeg in op uw website
β‘ Snelle tips om te beginnen
π Documentvoorbereiding
- β’ Structuur: Gebruik duidelijke koppen, opsommingstekens en nummering
- β’ Formaat: PDF met leesbare tekst (geen gescande afbeeldingen)
- β’ Grootte: Bestandsgrootte beΓ―nvloedt de verwerkingssnelheid
- β’ Inhoud: Verwijder duplicaten en irrelevante delen
- β’ Taal: Consistente terminologie en stijl
- β’ Metadata: Duidelijke bestandsnamen voor betere organisatie
- β’ Actualiteit: Gebruik de nieuwste documentversies
π¨ Widget-integratie
Eenvoudige integratie met JavaScript-code:
<script src="https://chatbotty.ai/chatbot-embed.js" data-chatbot-id="xxxxxxxx"> </script>
- β’ Asynchroon laden zonder paginablokkering
- β’ Cross-domein ondersteuning
Chatbotbeheer
β Chatbots aanmaken
π― Basisconfiguratie
Basisinformatie:
- β’ Chatbotnaam: Identificatie van uw chatbot
- β’ Beschrijving: Korte beschrijving van het doel van de chatbot
- β’ Antwoordstijl: Formeel / Vriendelijk / Professioneel / Informeel
π¨ Uiterlijk
Widget-uiterlijk van de chatbot aanpassen:
- β’ Themekleur: Selectie uit vooraf ingestelde kleuren
- β’ Welkomstbericht: Tekst voor het eerste contact met de gebruiker
- β’ Foutmelding: Tekst die wordt weergegeven wanneer de chatbot niet beschikbaar is
- β’ Toegestane domeinen voor insluiting: Geef aan waar de widget kan worden gebruikt
π Maximaal aantal chatbots per abonnement
Free
1 chatbot
Evaluation
1 chatbot
14 dagen proefperiode
Basic
1 chatbot
Elite
2 chatbots
Enterprise
3 chatbots
ποΈ Verwijderbevestiging
Veilig verwijderproces
Bij het verwijderen van een chatbot verschijnt een bevestigingsvenster om onbedoelde verwijdering te voorkomen. Dit zorgt ervoor dat u geen belangrijke gegevens per ongeluk verliest.
β οΈ Waarschuwing:
Alle chatbotgegevens, documenten en analyses worden permanent verwijderd en kunnen niet worden hersteld.
Geavanceerde chatbotinstellingen
π§ AI-gedrag en prompts
π Systeeminstructies
Definieer de persoonlijkheid en het gedrag van de AI-assistent. Bevat richtlijnen voor:
- β’ Communicatiestijl en antwoordtoon
- β’ Algemeen gedrag en regels
- β’ Kritieke instructies voor beperkingen
π·οΈ Beschikbare plaatshouders
De volgende plaatshouders kunnen worden gebruikt in instructieprompts en berichten:
- β’
{current_datetime}- Huidige datum en tijd - β’
{chatbot_id}- Unieke chatbot-identificatie - β’
{fallback_message}- Aangepast terugvalbericht wanneer geen antwoord gevonden
β‘ Zoek- en antwoordkwaliteit
π Zoekparameters
- β’ Gelijkheidsdrempel (0.4): Minimale overeenkomst om document te gebruiken
- β’ Aantal documentchunks in context (5): Hoeveel documentchunks de AI ontvangt
- β’ Slimme modelroutering: Selecteert automatisch een beter model op basis van de complexiteit van de vraag
- β’ Automatische supporttickets: Wanneer AI niet kan antwoorden, biedt het aan een supportticket aan te maken. Vereist toestemming en e-mail van de gebruiker.
- β’ Terugval forceren: Indien ingeschakeld, wordt altijd het terugvalbericht getoond bij vragen met lage documentrelevantie. Indien uitgeschakeld, antwoordt AI ook zonder relevante documenten (conversatiemodus).
βοΈ Taalvoorkeuren en AI-parameters
- β’ Antwoordtaal chatbot: Taal waarin de chatbot antwoordt
- β’ Tijdzone: Voor antwoorden over huidige datum en tijd
- β’ Creativiteit (Temperature): 0.0 = nauwkeurig, 1.0 = creatieve antwoorden
- β’ Maximale antwoordlengte (tokens): Limiet in tokens (β 375 woorden voor 500 tokens)
π‘οΈ Anti-spambescherming
- ⒠Max verzoeken/dag: Maximaal aantal verzoeken van één IP-adres per 24 uur (anti-botbescherming)
- β’ Max verzoeken/sessie: Maximaal aantal verzoeken per sessie (2-uurs venster ter voorkoming van misbruik)
- β’ Snelheidslimiet per minuut: Bescherming tegen spamvragen
- β’ Cache TTL (seconden): Hoe lang antwoorden worden gecacht
π Standaardinstellingen herstellen
Standaardinstellingen herstellen
De knop 'Standaardinstellingen herstellen' zet alle geavanceerde instellingen terug naar hun standaardwaarden. Er verschijnt een bevestigingsvenster voordat de instellingen worden gereset om onbedoelde wijzigingen te voorkomen.
βΉοΈ Opmerking:
U kunt uw instellingen altijd terugzetten naar de standaardwaarden als u opnieuw wilt beginnen of als iets niet werkt zoals verwacht.
Documentbeheer
π€ Bestanden uploaden
π Ondersteunde bronnen
Bestanden
PDF, DOCX, TXT, MD, HTML
Web-URL
Automatische scraping
Updates
Automatische versievervanging
π― Optimale documentvoorbereiding
β Aanbevolen praktijken:
- β’ Duidelijke koppen en structuur
- β’ PDF met leesbare tekst (geen afbeeldingen)
- β’ Consistente opmaak
- β’ Logische sectienummering
β Vermijd:
- β’ Gescande afbeeldingen zonder OCR
- β’ Overmatige tekstfragmentatie
- β’ Inconsistente opmaak
- β’ Bestanden groter dan 10MB
πΎ Opslaglimieten per abonnement
Free
10MB totaal
Evaluation
20MB totaal
Basic
10MB totaal
Elite
20MB totaal
Enterprise
50MB totaal
π Duplicaatdetectie
Slimme duplicaatafhandeling
Bij het uploaden van een document met dezelfde naam als een bestaand document verschijnt een bevestigingsvenster met opties om onbedoeld overschrijven te voorkomen.
Beschikbare opties:
- β’ Vervangen: Overschrijft het bestaande document met de nieuwe versie
- β’ Beide bewaren: Bewaart beide versies (nieuw bestand krijgt een genummerd achtervoegsel)
π Document uploadproces
Selecteer chatbot
Kies de chatbot waaraan het document wordt toegewezen
Selecteer uploadmethode
π Bestanden (PDF, DOCX, TXT, MD)
Maximaal 10 MB per bestand
π Web-URL
Automatische webpagina-scraping
Selecteer documenttype
Het systeem optimaliseert de verwerking automatisch per type:
Juridisch document:
Wetten, voorschriften, contracten
Technische handleiding:
Gidsen, specificaties, procedures
Nieuws:
Artikelen, persberichten
Academische tekst:
Wetenschappelijke artikelen, studies
Algemeen document:
Universele instellingen
Document beschrijven (optioneel)
Voeg een beschrijving toe voor eenvoudige toekomstige navigatie in de documentenlijst
Tip voor bestandsupdate
Bij het invoeren van dezelfde documentnaam heeft u de mogelijkheid om de originele versie automatisch te vervangen zonder het verouderde document te hoeven verwijderen. Uw gegevens blijven actueel.
Chat Widget
π§ Webinsluiting (chatbot weergeven op uw website)
π Insluitcode ophalen
U vindt de insluitcode voor elke chatbot in het contextmenu (drie puntjes). Klik op "Insluitcode kopiΓ«ren" en plak deze op uw website vΓ³Γ³r de afsluitende </body>-tag.
<script src="https://chatbotty.ai/chatbot-embed.js" data-chatbot-id="xxxxxxxx"> </script>
π‘ Tip: De widget laadt asynchroon en heeft geen invloed op uw paginasnelheid. De chatbubbel verschijnt zodra de configuratie op de achtergrond is geladen.
π΄ Opmerking: Als de chatbot is gedeactiveerd, verschijnt de widget helemaal niet op de website.
β οΈ Installatie via GTM: Als u de widget via Google Tag Manager insluit en een bezoeker cookies weigert, wordt GTM niet geladen en verschijnt de chatbot niet. Wij raden aan de code rechtstreeks in HTML in te sluiten, buiten GTM.
βοΈ Widgetconfiguratie
U kunt de widget volledig aanpassen in het gedeelte "Uiterlijk" bij het bewerken van de chatbot. Alle instellingen worden automatisch toegepast op de insluitcode.
π¨ Uiterlijk en positie:
- β’ Themekleur: 6 vooraf ingestelde kleuren (blauw, rood, groen, geel, paars, oranje)
- β’ Widgetpositie: Rechtsonder / Linksonder
- β’ Welkomstbericht: Begroeting van de gebruiker
- β’ Terugvalbericht: Tekst voor gevallen waarin de chatbot het antwoord niet weet
βοΈ Chatbotgedrag:
- β’ Chatbotnaam: Weergegeven in de koptekst
- β’ Beschrijving: Korte beschrijving van het doel van de chatbot (niet weergegeven op web)
- β’ Antwoordstijl: Professioneel, vriendelijk, formeel
- β’ Status: Actieve/inactieve chatbot
π― Widget aanpassen
Positieopties:
- β’ Rechtsonder (standaard)
- β’ Linksonder
Bubbel-effecten:
- β’ Pulseffect - Geanimeerde bubbel om de aandacht te trekken (kan worden in-/uitgeschakeld)
ποΈ Widgetvoorbeeld
Gebruik het widgetvoorbeeld om uw chatbot te testen voordat u deze insluit:
- β’ Klik op de knop "Voorbeeld" in de chatbotinstellingen
- β’ Opent de widget in een modaal venster
- β’ Test alle functies en het uiterlijk
- β’ Geen code-installatie nodig
π Openbare widgetpagina
Toegang tot uw widget op: /widget-embed/[widgetId]
- β’ Zelfstandige pagina voor testen
- β’ Kan worden gedeeld met teamleden
- β’ Geen website-integratie vereist
π‘ Tip: Alle wijzigingen worden onmiddellijk van kracht op alle websites met de ingesloten widget. Geen codewijziging nodig.
β‘ Prestatie-optimalisatie
π Asynchroon laden
- β’ Asynchroon laden op de achtergrond
- β’ Bubbel verschijnt zodra configuratie gereed is
- β’ Geen impact op de snelheid van de hoofdpagina
- β’ Progressieve verbetering
πΎ Slimme cache
- β’ 90%+ cache hit rate
- β’ 5 minuten configuratiegeldigheid
- β’ Snel laden via Redis
- β’ Soepele werking zelfs bij Redis Cache-storing
π Beveiliging en beperkingen
π Domeinbeperkingen
Beperk toegang tot alleen toegestane domeinen:
Configuratievoorbeeld:
- β’ example.com
- β’ *.example.com (inclusief subdomeinen)
π‘οΈ Anti-spambescherming
Instellingen voor verzoeklimieten ter bescherming tegen spam en misbruik
Max verzoeken/dag
50
Maximaal aantal verzoeken van één IP-adres per 24 uur (anti-botbescherming)
Max verzoeken/sessie
20
Maximaal aantal verzoeken per sessie (2-uurs venster ter voorkoming van misbruik)
Verzoeklimiet/min
10
π‘οΈ Bescherming tegen spamvragen
Cache TTL (seconden)
300
β‘ Hoe lang antwoorden worden gecacht
π Opmerking:
Deze parameters zijn volledig door de gebruiker configureerbaar in de geavanceerde instellingen van elke chatbot voor maximale flexibiliteit.
Analyse
π― Toegang per abonnement
π Free
Geen toegang
Upgrade-popup met instructies
β Evaluation
Volledige toegang
14 dagen Elite-functies
π΅ Basic
Basisstatistieken
- β’ Berichtenaantallen
- β’ Topvragen
- β’ Chatbotstatistieken
π Elite+
Gedetailleerde analyse
- β’ Slagingspercentage
- β’ Gegevensexport
- β’ Gedetailleerde rapporten
- β’ Interactieve interface
- β’ Analyse per chatbot apart
π€ Gedetailleerde chatbotanalyseElite+
π Weergave per chatbot
- β’ Individueel overzicht: Aparte analyse per chatbot
- β’ Vraagfiltering: Alleen relevante gesprekken weergeven
- β’ GeΓ―soleerde statistieken: Individuele chatbotprestaties gescheiden
- β’ Chatbotvergelijking: Mogelijkheid om prestaties van verschillende bots te vergelijken
π Gedetailleerde vraagweergave
- β’ Volledige vraag: Weergave van de gehele vraag van de gebruiker
- β’ Antwoordbetrouwbaarheid: Exacte betrouwbaarheidsscore
- β’ AI-antwoord: Volledige tekst van het chatbotantwoord
- β’ Tijdstempel: Datum en tijd van elke vraag
π‘ Praktisch gebruik: Maakt nauwkeurige analyse mogelijk van hoe individuele chatbots reageren op gebruikersvragen, identificatie van probleemgebieden en documentoptimalisatie per chatbot apart.
π Beschikbare statistieken
π― Belangrijkste KPI's
π Antwoordkwaliteit
β οΈ Beperkingen gegevensgeschiedenis per abonnement
Gegevens die overeenkomen met het maximale aantal vragen per maand volgens uw abonnement worden bewaard. Oudere gegevens worden automatisch verwijderd voor optimalisatie van de databaseprestaties.
- β’ Free: 200 vragen
- β’ Basic: 3000 vragen
- β’ Elite: 6000 vragen
- β’ Enterprise: 10000 vragen
π€ Export en rapporten
π Beschikbaarheid: Exportfunctionaliteit is alleen beschikbaar voor Elite+ abonnementen (Elite en Enterprise).
π‘ Tip: Wij raden aan om gegevens op de laatste dag van elke maand te exporteren om de volledige geschiedenis van klantvragen bij te houden.
πΎ Exportformaten
- β’ CSV: Tabelgegevens voor Excel
- β’ JSON: Gestructureerde gegevens voor API
π Gegevensfilters
π Tijdfilters:
- β’ Deze week: Laatste 7 dagen
- β’ Deze maand: Huidige maand
- β’ Dit jaar: Huidig jaar
π Filters op antwoord:
- β’ Alle vragen: Volledige geschiedenis
- β’ β Beantwoord: Succesvolle antwoorden
- β’ β Gedeeltelijk beantwoord: Onvolledige antwoorden
- β’ β Onbeantwoord: Geen antwoord
Abonnement
π― Abonnementsoverzicht
Free
Perfect for getting started
β’10MB storage
β’1 chatbot
β’100 requests/month
β’Basic support
β’β Conversation history
β’β Basic analytics
β’β Web URL scraping
β’β Analytics export
β’β API access
β’β Support tickets
β’β Webhook actions
β’β White-label branding
β’β Buy extra requests
Evaluation
14-day trial with Enterprise features
β’10MB storage
β’1 chatbot
β’500 requests/month
β’β Conversation history
β’β Detailed analytics
β’β Web URL scraping
β’β Analytics export
β’β API access
β’β Support tickets (AI)
β’β Webhook actions (n8n)
β’β White-label branding
β’β Buy extra requests
β’Auto-downgrade to Free
Basic
For growing businesses
β’25MB storage
β’1 chatbot
β’3000 requests/month (total)
β’Priority support
β’β Conversation history
β’β Basic analytics
β’β Web URL scraping
β’β Analytics export
β’β API access
β’β Support tickets
β’β Webhook actions
β’β White-label branding
β’β Buy extra requests
Elite
Most popular
β’50MB storage
β’2 chatbots (max)
β’6000 requests/month (total)
β’Priority support
β’β Conversation history
β’β Detailed analytics
β’β Web URL scraping
β’β Analytics export
β’β API access
β’β Support tickets
β’β Webhook actions
β’β White-label branding
β’β Buy extra requests
Enterprise
Custom solutions
β’100MB storage
β’3 chatbots (max)
β’10000 requests/month (total)
β’Premium support
β’β Conversation history
β’β Detailed analytics
β’β Web URL scraping
β’β Analytics export
β’β API access
β’β Support tickets (AI)
β’β Webhook actions (n8n)
β’β White-label branding
β’β Buy extra requests
π‘ Gegevensgebruik
10MB aan gegevens komt overeen met ongeveer 1000 pagina's PDF-document. Bij puur tekstformaten zelfs veel meer.
Waarschuwing: De oorspronkelijke grootte van het geΓΌploade bestand telt mee voor de gegevenslimieten. Ingesloten afbeeldingen in documenten kunnen de bestandsgrootte aanzienlijk vergroten.
π° Jaarabonnement
Bespaar 2 maanden met jaarlijkse facturering β betaal slechts voor 10 maanden!
Jaarlijkse facturering biedt aanzienlijke besparingen ten opzichte van maandelijkse betalingen. U kunt uw factureringsperiode of abonnement op elk moment wijzigen.
β° Vervallen proefperiode
- β’ Automatische downgrade naar Free-abonnement na 14 dagen
- β’ Naadloze overgang zonder gegevensverlies
π Gebruiksregistratie
π Dashboard-tracking
Volg uw abonnementsgebruik rechtstreeks in realtime:
π Maandelijkse limieten
- β’ Aantal berichten per maand
- β’ Voorspelling tot einde van de maand
- β’ Automatische reset elke maand
π Permanente limieten
- β’ Opslagcapaciteit (MB/MB)
- β’ Aantal chatbots (aantal/limiet)
π Statistieken
- β’ Totaal aangemaakte chatbots
- β’ Actieve en functionele chatbots
- β’ Totaal vragen van gebruikers
- β’ GeΓΌploade documenten
π Visualisatie
- β’ Gekleurde voortgangsbalken
- β’ Realtime tracking
β οΈ Limiethandhaving
- β’ Opslag overschreden: Upload geblokkeerd met upgrade-prompt
- β’ Chatbotlimiet: Aanmaken geblokkeerd, upgrade-dialoog weergegeven
- β’ Maandelijkse berichten: Widget laadt niet (stille fout)
- β’ Analysetoegang: Functiebeperkingen per abonnement
π° Extra Messages Add-ons
Extra messages are additional message packages you can purchase to extend your monthly quota. Unlike monthly subscriptions, extra messages never expire and persist across billing cycles.
π How it works:
- Your monthly quota is consumed first
- When monthly quota is exhausted, extra messages are automatically used
- Extra messages persist until fully consumed (no expiration)
- Visible on dashboard with real-time tracking
π¦ Available Packages:
π‘ When to buy:
- β’ Seasonal traffic spikes
- β’ Special campaigns
- β’ Testing before upgrade
- β’ One-time high usage
π³ Purchase:Click "Buy Extra Messages" on dashboard or in usage tracking card when approaching limit.
Facturen
π Overzicht
Al uw facturen en betalingsgeschiedenis zijn direct beschikbaar in het klantenportaal. Daar vindt u abonnementen, aanvullende aankopen en alle eerdere betalingen.
π Hoe toegang te krijgen
- Ga naar Abonnement in de zijbalk van het dashboard
- Klik op de knop Abonnement beheren
- U wordt doorgestuurd naar het klantenportaal waar u alle facturen en betalingsgeschiedenis kunt bekijken
Instellingen
π€ Gebruikersaccountbeheer
π Naam wijzigen
Persoonlijke informatie
- β’ Naam: Weergegeven gebruikersnaam
- β’ Kan op elk moment worden gewijzigd
- β’ Wordt weergegeven in profiel en communicatie
π§ E-mail wijzigen
Na het indienen van het nieuwe adres worden bevestigingslinks naar beide uw huidige en nieuwe e-mailadres gestuurd. De wijziging wordt pas van kracht na het klikken op beide links.
- β’ Controleer uw huidige inbox en bevestig van daaruit
- β’ Controleer uw nieuwe inbox en bevestig van daaruit
- β’ Pas na beide bevestigingen wordt het nieuwe e-mailadres actief
π Wachtwoord wijzigen
Wachtwoord moet minimaal 6 tekens bevatten
Wachtwoordvereisten:
- β’ Minimaal 6 tekens
- β’ Combinatie van letters en cijfers
- β’ Huidig wachtwoord vereist
Wachtwoord vergeten:
- β’ Reset via e-mail
- β’ Veilige resetlink
- β’ Onmiddellijke levering
π Taalinstellingen
Schakel tussen de Engelse en Tsjechische interface
- β’ Klik op de taalkiezer in de bovenste navigatie
- β’ Beschikbare talen: Engels (EN) / Tsjechisch (CS)
- β’ Automatisch pagina herladen - De pagina wordt automatisch herladen na taalwijziging om alle vertalingen toe te passen
- β’ Taalvoorkeur wordt opgeslagen in uw account
β οΈ Gevarenzone
Acties in dit gedeelte zijn onomkeerbaar. Ga voorzichtig te werk.
β οΈ Het verwijderen van uw account zal al uw gegevens, chatbots, documenten en gesprekken permanent verwijderen. Deze actie is onomkeerbaar.
De knop "Account verwijderen" activeert de volledige verwijdering van alle gegevens uit de database.
API
π Programmatische toegang tot chatbots
π Beschikbaar voor hogere abonnementen
API-toegang is beschikbaar voor gebruikers met Evaluation, Elite en Enterprise abonnementen. Hiermee kunt u uw chatbots integreren in aangepaste applicaties, websites of systemen.
π Wat u krijgt
- β’ REST API: Standaard HTTP-verzoeken
- β’ Codevoorbeelden: JavaScript, Python, PHP, Node.js
- β’ Chatbot-ID: Unieke identificatie voor elke chatbot
- β’ Volledige documentatie: Direct beschikbaar in de app
π‘ Hoe te beginnen: Na inloggen in de applicatie vindt u het gedeelte "API-integratie" in het menu, waar u gedetailleerde instructies kunt vinden inclusief verbindingsvoorbeelden voor diverse programmeertalen en testvoorbeelden.
π API-authenticatie
Hoe het werkt
API-toegang gebruikt Bearer-tokenauthenticatie. Elke API-sleutel is gekoppeld aan een specifieke chatbot.
- Maak een API-sleutel aan in Dashboard β API-integratie voor uw chatbot
- Voeg de API-sleutel toe in de Authorization-header als Bearer-token
- Stuur een POST-verzoek naar het
/api/chatendpoint - De chatbot wordt automatisch geΓ―dentificeerd op basis van de API-sleutel
Belangrijk: U hoeft GEEN chatbot_id in de verzoektekst te sturen. De chatbot wordt bepaald op basis van uw API-sleutel.
π API-sleutelbeheer
API-sleutels aanmaken
Genereer veilige API-sleutels voor programmatische toegang tot uw chatbots.
Functies:
- β’ Aangepaste namen - Label sleutels voor eenvoudige identificatie
- β’ Max 50 sleutels - Limiet per chatbot
- ⒠Veilige tokens - Volledig token wordt slechts één keer getoond bij aanmaak
- β’ Activiteitsregistratie - Tijdstempel van laatst gebruik
- β’ Actief/inactief schakelen - Tijdelijk uitschakelen zonder verwijdering
Beveiliging:
- β’ Tokens zijn gemaskeerd in de UI (alleen eerste/laatste tekens zichtbaar)
- β’ KopiΓ«ren naar klembord voor eenvoudig gebruik
- β’ Verwijder gecompromitteerde sleutels onmiddellijk
β‘ Maandelijks quotum: API-gebruik telt mee voor uw maandelijkse berichtlimiet. Extra berichten kunnen worden aangeschaft wanneer het quotum is overschreden.
π» Codevoorbeelden
JavaScript (Browser)
// 1. first request β no conversation_id needed
const response = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What is your return policy?'
// conversation_id not required β created automatically
})
})
const result = await response.json()
const conversationId = result.data.conversation_id // save for follow-up requests
// 2. follow-up request β previous messages loaded as context
const response2 = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What about exchanges?',
conversation_id: conversationId
})
})Node.js
const response = await fetch('https://chatbotty.ai/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'What is your return policy?',
conversation_id: conversationId // optional: to continue a conversation
})
})
const result = await response.json()
console.log(result.data.message)
// result.data.conversation_id β save for follow-up requestsPython
import requests
response = requests.post(
'https://chatbotty.ai/api/chat',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={
'message': 'What is your return policy?',
'conversation_id': conversation_id # optional: to continue a conversation
}
)
result = response.json()
print(result['data']['message'])PHP
<?php
$ch = curl_init('https://chatbotty.ai/api/chat');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'message' => 'What is your return policy?',
'conversation_id' => $conversationId // optional: to continue a conversation
]));
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo $result['data']['message'];
?>cURL
curl -X POST https://chatbotty.ai/api/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "What is your return policy?"}'π Antwoordformaat
Succesvol antwoord
{
"success": true,
"data": {
"message": "AI response text...",
"conversation_id": "550e8400-e29b-41d4-a716-446655440000",
"sources": [
{
"content": "Relevant document excerpt...",
"similarity": 0.95,
"page": 1
}
],
"metadata": {
"tokensUsed": 150,
"cached": false,
"responseTime": 1234,
"searchResults": 3
}
},
"timestamp": "2025-01-28T10:00:00.000Z"
}Foutantwoord
{
"success": false,
"error": "Internal server error",
"timestamp": "2025-01-28T10:00:00.000Z"
}β οΈ Belangrijke opmerkingen
- ⒠API-sleutels zijn chatbot-specifiek - Elke sleutel werkt met slechts één chatbot
- β’ Tot 50 sleutels per chatbot - Maak meerdere sleutels voor verschillende applicaties
- β’ Sleutels kunnen worden uitgeschakeld - Tijdelijk deactiveren zonder verwijdering
- β’ Maandelijks quotum van toepassing - Beperkt door uw abonnementsberichten/maand + extra aangekochte berichten
- β’ Geen snelheidslimiet per minuut - API is ontworpen voor programmatische toegang zonder snelheidslimieten
- β’ Geen domeinvalidatie - API werkt vanaf elke oorsprong (gebruik met voorzichtigheid)
- β’ Gesprekscontext - Elk antwoord retourneert een
conversation_id. Geef deze door in volgende verzoeken om context te behouden β het systeem laadt automatisch de laatste 20 berichten. Zonderconversation_idstart elk verzoek een nieuw zelfstandig gesprek zonder context β dit is prima als u geen gespreksgeheugen nodig hebt (bijv. eenmalige gegevensopvragen). - β’ Beveilig uw sleutels - Stel API-sleutels nooit bloot in client-side code
Gesprekken
π Hoe het werkt
De functie Gespreksgeschiedenis registreert automatisch alle chatbotsessies met uitgebreide metadata voor analyse-, compliance- en kwaliteitsborgingsdoeleinden.
- β’ Sessieregistratie: Elk gesprek wordt opgenomen met een uniek sessie-ID
- β’ Metadata-tracking: IP-adres, pagina-URL, verwijzer, user agent
- β’ Tijdstempels: Nauwkeurige timing voor elke berichtenuitwisseling
- β’ Contactinformatie: Door gebruiker opgegeven e-mail en naam indien beschikbaar
π Gesprekken bekijken
Toegang tot gespreksgeschiedenis via Dashboard β Gesprekken in het hoofdmenu.
Beschikbare filters:
- β’ Periode: Filteren op tijdsperiode (deze maand, laatste 7 dagen, enz.)
- β’ Filter (Chatbot): Gesprekken voor een specifieke chatbot of alle weergeven
- β’ Bron: Filteren op bron (widget, API, enz.)
Weergegeven kolommen:
- β’ Sessie-ID, Datum/Tijd, Chatbotnaam
- β’ Aantal berichten, Bron, Contact e-mail
- β’ IP-adres (geanonimiseerd), Pagina-URL
π Gespreksdetails
Klik op een gesprek om de volledige berichtengeschiedenis met gedetailleerde informatie te bekijken.
- β’ Berichtentijdlijn: Alle gebruikersvragen en AI-antwoorden
- β’ Timinggegevens: Exacte tijdstempels voor elk bericht
- β’ Bronmetadata: Pagina-URL, verwijzer, user agent
- β’ Contactinformatie: E-mail en naam als de gebruiker deze heeft opgegeven
π‘ Tip: Gebruik de gespreksgeschiedenis om veelgestelde vragen te identificeren en de kennisbank van uw chatbot te verbeteren. Patronen in gebruikersvragen kunnen u helpen ontbrekende documentatie toe te voegen.
Supporttickets
Enterprise-functie
AI-gestuurde supporttickets zijn alleen beschikbaar voor Enterprise-abonnementgebruikers.
π€ Hoe het werkt
Het AI-supportticketsysteem detecteert automatisch wanneer de chatbot de vraag van een gebruiker niet kan beantwoorden en biedt aan een supportticket aan te maken voor menselijke opvolging.
- β’ Slimme detectie: AI herkent wanneer het geen bevredigend antwoord kan geven
- β’ Toestemming gebruiker: Systeem vraagt de gebruiker of hij/zij een ticket wil aanmaken
- β’ E-mailverzameling: Verzamelt het e-mailadres van de gebruiker voor opvolging
- β’ AI-samenvatting: Genereert een samenvatting van het gesprek voor het supportteam
π Ticketaanmaakproces
Het meerstaps gespreksproces voor het aanmaken van tickets:
- Trigger: AI detecteert onbeantwoordbare vraag of gebruiker uit frustratie
- Aanbod: "Wilt u dat ik een supportticket voor u aanmaak?"
- Toestemming: Gebruiker bevestigt dat hij/zij wil doorgaan
- E-mail: "Geef uw e-mailadres op voor opvolging"
- Samenvatting: AI genereert automatisch een gesprekssamenvatting
- Bevestiging: Ticket aangemaakt met referentienummer
π Tickets beheren
Toegang tot en beheer van supporttickets via Dashboard β Supporttickets.
Statusworkflow:
- β’ Open: Nieuw ticket wachtend op beoordeling
- β’ In behandeling: Supportteam werkt aan het probleem
- β’ Opgelost: Probleem behandeld, wachtend op bevestiging
- β’ Gesloten: Ticket voltooid en gearchiveerd
Beschikbare acties:
- β’ Volledige gesprekscontext bekijken
- β’ Ticketstatus bijwerken
- β’ Interne notities toevoegen
- β’ E-mailreactie naar gebruiker sturen
βοΈ Configuratie
Schakel supporttickets in en configureer ze in Chatbotinstellingen β tabblad Supporttickets.
- β’ In-/uitschakelen: Ticketaanmaak voor deze chatbot schakelen
- β’ E-mailmeldingen: Waarschuwingen ontvangen voor nieuwe tickets
- β’ Automatisch antwoord: Aangepast bericht verzonden naar gebruiker na ticketaanmaak
- β’ Triggers: Configureer wanneer ticketaanbiedingen worden gedaan
π‘ Tip: Bekijk tickets regelmatig om hiaten in uw kennisbank te identificeren. Veelvoorkomende ticketonderwerpen geven gebieden aan waar u meer documentatie moet toevoegen.
Webhook-acties
Enterprise & Evaluation Functie
Webhook-acties zijn beschikbaar voor Enterprise (maximaal 10 webhooks, maximaal 10 tools in totaal over alle webhooks) en Evaluation (maximaal 5 webhooks, maximaal 5 tools in totaal over alle webhooks) gebruikers.
π Overzicht
Webhook-acties stellen uw chatbot in staat om te communiceren met externe systemen via AI-gestuurde tool-aanroepen. Definieer aangepaste webhooks met specifieke tools die de AI tijdens gesprekken kan aanroepen.
- β’ Aangepaste webhooks: Definieer endpoints met authenticatie
- β’ AI-tools: Specificeer tools die de AI kan aanroepen (bijv. get_order_status)
- β’ Parameters: Definieer verplichte en optionele parameters voor elke tool
- β’ Responsverwerking: AI verwerkt webhook-responses op natuurlijke wijze
βοΈ Webhooks instellen
Configureer webhooks in Dashboard β Webhooks voor elke chatbot.
- Webhook aanmaken: Voer naam, URL en optionele authenticatieheaders in
- Tools definiΓ«ren: Voeg tools toe die de AI kan aanroepen (bijv. get_order_status, check_inventory)
- Parameters instellen: Definieer verplichte parameters (bijv. order_id, product_sku)
- Testen: Gebruik de testfunctie om te verifiΓ«ren dat uw webhook correct werkt
- Activeren: Schakel de webhook in voor productiegebruik
π n8n-integratie
n8n is een krachtige workflow-automatiseringstool die naadloos samenwerkt met ons webhook-systeem.
Snelle installatie:
- Maak een nieuwe workflow aan in n8n
- Voeg een Webhook-trigger node toe (POST-methode)
- Kopieer de webhook-URL naar uw chatbot webhook-configuratie
- Bouw uw workflowlogica (API-aanroepen, databasequery's, enz.)
- Retourneer een JSON-response die de AI zal verwerken
Voorbeeld responseformaat:{"status": "shipped", "tracking": "1Z999AA1", "eta": "2024-01-15"}
π‘ Voorbeelden van gebruik
π¦ Orderstatus opzoeken
Klant vraagt "Waar is mijn bestelling?" β AI roept get_order_status aan met ordernummer β Retourneert trackinginformatie
π€ CRM-integratie
Gebruiker geeft e-mail op β AI roept lookup_customer aan β Retourneert accountgegevens en recente activiteit
π Afspraak boeken
Gebruiker vraagt om afspraak β AI roept check_availability aan en vervolgens book_appointment β Bevestigt boeking
π Voorraadcontrole
Klant vraagt naar productbeschikbaarheid β AI roept check_stock aan β Retourneert huidige voorraad
π Beveiliging
- β’ HTTPS vereist: Alle webhook-endpoints moeten HTTPS gebruiken
- β’ Aangepaste headers: Voeg authenticatietokens toe in headers
- β’ Timeout-afhandeling: 30 seconden timeout voorkomt hangende verzoeken
- β’ SSRF-bescherming: PrivΓ©-IP-adressen worden geblokkeerd voor beveiliging
- β’ Snelheidsbeperking: Ingebouwde bescherming tegen overmatige aanroepen
β οΈ Belangrijk:Stel nooit gevoelige API-sleutels bloot in webhook-URL's. Gebruik in plaats daarvan authenticatieheaders.
π‘ Tip: Begin met eenvoudige alleen-lezen bewerkingen (zoals orderstatus opzoeken) voordat u schrijfbewerkingen implementeert. Test grondig met de ingebouwde webhook-tester voordat u activeert in productie.
Tips & Tricks voor documentvoorbereiding en succesvolle chatbot-implementatie
π Documentvoorbereiding
π Inhoud structureren
- ⒠Thematische verdeling: Eén bestand = één onderwerp
- β’ Logische structuur: Duidelijke secties en koppen
- β’ Eenvoudige updates: Wijzig alleen relevante delen
- β’ Duidelijkheid: Snelle oriΓ«ntatie op de inhoud
π Formaat en naamgeving
- β’ Tekstformaten: TXT, DOC, DOCX (zonder afbeeldingen)
- β’ Duidelijke namen: Beschrijvende bestandsnamen
- β’ Automatische update: Zelfde naam = vervanging
- β’ Zorgeloos: Oude versie automatisch verwijderd
π‘ Tip: Bereid documenten vooraf voor in platte tekst. Afbeeldingen en complexe opmaak kunnen de kwaliteit van chatbot-antwoorden verslechteren.
π― Semantisch zoeken
π Hoe de chatbot antwoorden vindt
- β’ Semantische matching: Zoekt naar vergelijkbare betekenis, niet exacte tekst
- β’ Trefwoorden: Identificeert belangrijke termen in de zoekopdracht
- β’ Context: Houdt rekening met de hele zinsbetekenis
- β’ Gelijkenis: Vergelijkt met bestaande informatie
βοΈ Optimale formulering
- β’ Directe antwoorden: "X is Y jaar oud" in plaats van "X vierde zijn Y-jarig bestaan"
- β’ Verschillende formuleringen: Gebruik diverse uitdrukkingswijzen
- β’ Verwachte vragen: Denk na over mogelijke gebruikersvragen
- β’ Trefwoorden: Neem synoniemen en varianten op
β Minder geschikt:
"Big Ben vierde zijn 165e verjaardag"
β Beter:
"Big Ben is 165 jaar oud"
Waarom:De tweede versie beantwoordt beter vragen als "Hoe oud is Big Ben?" of "Wat is de leeftijd van Big Ben?"
π Op analytics gebaseerde optimalisatie
π Lacune-analyse
- β’ Onbeantwoorde vragen: Volg veelgestelde vragen zonder antwoord
- β’ Lage betrouwbaarheid: Identificeer vragen met laag vertrouwen
- β’ Terugkerende problemen: Vind patronen in niet-succesvolle vragen
- β’ Gebruikersfrustraties: Observeer punten waar gebruikers "vastlopen"
π― Gerichte verbeteringen
- β’ Documentuitbreiding: Voeg ontbrekende informatie toe
- β’ Herformulering: Verduidelijk onduidelijke passages
- β’ Nieuwe formuleringen: Voeg verschillende uitdrukkingswijzen toe
- β’ Testen en itereren: Test wijzigingen en meet verbeteringen
π― Betrouwbaarheidsinterpretatie
< 30%
Niet-succesvol antwoord
30-40%
Gedeeltelijk beantwoord
> 40%
Succesvol antwoord
π‘ Tip: Test uw aanpassingen direct in de chatbot. Stel dezelfde vragen opnieuw en monitor betrouwbaarheidswijzigingen. Het doel is om consistent meer dan 40% betrouwbaarheid te bereiken.
Waarom zulke lage waarden? Voor 100% betrouwbaarheid zou de zoekopdracht exact in dezelfde bewoording in het document moeten worden geΓ―dentificeerd, wat zeer zelden voorkomt. Daarom zijn realistische waarden voor de Nederlandse omgeving lager.
β FAQ-optimalisatie
π Analyse van meest gestelde vragen
- β’ Trends volgen: Identificeer terugkerende vragen
- β’ Prioritering: Focus op de meest gestelde vragen
- β’ Patronen: Zoek naar vergelijkbare formuleringen van dezelfde vraag
- β’ Problemen: Vind vragen met lage betrouwbaarheid
π FAQ-document aanmaken
- β’ EΓ©n alinea = V&A: Vraag en antwoord samen
- β’ Natuurlijke taal: Gebruik gangbare formuleringen
- ⒠Volledige antwoorden: Alle benodigde informatie in één keer
- β’ Diverse varianten: Neem synoniemen en alternatieven op
β¨ Geoptimaliseerd FAQ-voorbeeld
Hoe lang duurt de verwerking van een paspoortaanvraag?De verwerking van een paspoortaanvraag duurt standaard 6-8 weken vanaf het indienen van een volledige aanvraag. Voor urgente reisbehoeften is spoedverwerking beschikbaar binnen 2-3 weken tegen een extra vergoeding van β¬60. U kunt uw paspoort persoonlijk ophalen bij het aanvraagcentrum of laten opsturen naar uw adres.
π Resultaat: Een FAQ-document verhoogt de betrouwbaarheid van antwoorden op de meest gestelde vragen dramatisch. U beantwoordt 80-90% van de gebruikersvragen met hoge nauwkeurigheid.
π Langetermijnanalyse
π Regelmatige monitoring
- β’ Wekelijkse controle: Volg niet-succesvolle antwoorden
- β’ Maandelijks overzicht: Analyseer trends en wijzigingen
- β’ Gedeeltelijke antwoorden: Identificeer verbeterpunten
- β’ Probleempatronen: Vind terugkerende tekortkomingen
π€ Analytics-exportElite+
- β’ CSV-formaat: Voor MS Excel en Numbers
- β’ Gedetailleerde gegevens: Alle vragen en antwoorden
- β’ Betrouwbaarheid: Vertrouwensniveau voor elke vraag
- β’ Tijdstempel: Trends volgen over tijd
π Aanbevolen workflow
1. Wekelijkse export
Download gegevens van afgelopen week
2. Excel-analyse
Filter op betrouwbaarheid < 40%
3. Updates
Pas documenten aan op basis van inzichten
π‘ Voor gevorderde gebruikers: Gebruik Excel-draaitabellen om vergelijkbare vragen te groeperen en de meest voorkomende probleemgebieden te identificeren.
π Webbronnen gebruiken
π Web-URL scrapingElite+
- β’ Directe import: Laad inhoud van websites
- β’ FAQ-secties: Ideaal voor bestaande veelgestelde vragen
- β’ Documentatie: Gebruik bestaande kant-en-klare documentatie
- β’ Actuele inhoud: Altijd de nieuwste versie van informatie
β Voordelen van web scraping
- β’ Tijdbesparing: Geen handmatig herschrijven
- β’ Dataconsistentie: Geen verschillen tussen website en chatbot
- β’ Automatische updates: Herlaad gewoon de URL
- β’ Gestructureerde inhoud: Opmaak blijft behouden
π Ideale bronnen voor scraping
β Geschikte pagina's:
- β’ FAQ-secties
- β’ Productdocumentatie
- β’ Handleidingen en procedures
- β’ Contactinformatie
β Minder geschikt:
- β’ Pagina's met veel afbeeldingen
- β’ Navigatiemenu's
- β’ Advertentie-inhoud
- β’ Door JavaScript gegenereerde inhoud
π‘ Tip:Als u kwalitatieve FAQ's of documentatie op uw website heeft, gebruik dan URL-scraping in plaats van handmatig herschrijven. Dit voorkomt inconsistentie en bespaart tijd bij updates.
π‘ Tips om het meeste uit uw chatbot te halen
Krijg betere antwoorden van uw chatbot en benut uw maandelijkse berichtenquotum optimaal met deze tips:
π Documentkwaliteit:
- β’ Verwijder onnodige inhoud voor het uploaden β schonere documenten = nauwkeurigere antwoorden
- β’ Gebruik goed gestructureerde documenten met duidelijke koppen en secties
- β’ Vermijd dubbele informatie in meerdere documenten
β Stimuleer goede vragen:
- β’ Specifieke, gerichte vragen krijgen betere antwoorden dan vage vragen
- β’ Goed voorbereide documenten leiden tot snellere, preciezere antwoorden
π Monitor uw gebruik:
- β’ Volg uw berichtenquotum in de dashboard-analytics
- β’ Gebruik bij seizoenspieken extra berichtenuitbreidingen in plaats van uw abonnement te upgraden
- β’ Bekijk maandelijkse trends om te bepalen of uw huidige abonnement aan uw behoeften voldoet
Probleemoplossing
β οΈ Veelvoorkomende problemen
π€ Chatbot reageert niet
Mogelijke oorzaken:
- β’ Maandelijkse berichtenlimiet overschreden
- β’ Domein geblokkeerd door beperkingen
- β’ Snelheidsbeperking geactiveerd
- β’ Widget-laadfout
Oplossing:
- β’ Controleer gebruik in dashboard
- β’ Verifieer toegestane domeinen
- β’ Browser-ontwikkeltools β Netwerk-tabblad
- β’ Neem contact op met support met foutdetails
π Document wordt niet verwerkt
Veelvoorkomende problemen:
- β’ Bestand groter dan abonnementslimiet
- β’ Niet-ondersteund formaat
- β’ Beschadigd of met wachtwoord beveiligd PDF
- β’ Verwerkingswachtrij overbelast
Diagnose:
- β’ Controleer bestandsgrootte vs. abonnementslimiet
- β’ Probeer tekst te selecteren in PDF
- β’ Verwerkingsstatus in documenten
- β’ Probeer opnieuw te uploaden als het vastloopt
π Widget laadt niet
Laadproblemen:
- β’ CORS-beleid blokkering
- β’ Script-laad timeout
- β’ CSP (Content Security Policy)
- β’ Adblocker-interferentie
Oplossingsstappen:
- β’ Foutmeldingen in browserconsole
- β’ Probeer een andere browser/incognito
- β’ Schakel tijdelijk adblockers uit
- β’ Controleer instellingen voor toegestane domeinen
π Contact opnemen met support
π§ E-mailsupport
support@chatbotty.ai
- β’ Prioriteitsabonnementen: binnen 24 uur (uitzonderlijk tot 48 uur)
- β’ Gratis abonnementen: meestal binnen 72 uur
- β’ Bijlagen: screenshots, logs welkom
π Wat u moet vermelden
- β’ Browsertype en -versie
- β’ Foutmelding of screenshot
- β’ Chatbot-ID en widget-URL
- β’ Reproductiestappen
- β’ Console-fouten (F12)