Aan de slag
De gedocumenteerde inbegrepen paginaquota worden gedeeld tussen de projecten van een eigenaar. Bekijk prijzen voor de planquota en Account en facturatie in het dashboard voor het huidige gebruik en de beschikbare ruimte van je account.
Bouw een nuttige chatbot voordat je die op je site zet. De kernvolgorde is maken → content toevoegen → controleren → testen → aanpassen → integreren.
1. Maak een account en project
Meld je aan bij het ChattyBox-dashboard, selecteer Nieuwe chatbot en geef het project een naam en eventueel een Website-URL. Na het aanmaken wordt Kennis → Importeren en verversen geopend. Als je een project opent zonder geselecteerd tabblad, is Overzicht de standaardweergave. Alleen een project aanmaken start geen import.
Bekijk prijzen voor de actuele limieten voor projecten, pagina’s en gebruik.
2. Configureer je contentbron
Ga naar Kennis → Importeren en verversen, koppel de openbare website, bekijk de gevonden pagina’s, pas de aanbevolen of aangepaste selectie aan en start de import of verversing van alleen de geselecteerde pagina’s. Wijzigingen in broninstellingen worden automatisch opgeslagen: controleer de opslagstatus en los validatiefouten op of probeer een mislukte opslag opnieuw voordat je verdergaat. De geavanceerde broninstellingen bieden ook een aparte actie Nu scrapen, die de ingestelde ontdekkingsmodus gebruikt. Regels voor opnemen/uitsluiten en de crawldiepte zijn alleen beschikbaar via configuratie als code, niet in het dashboard.
ChattyBox haalt leesbare HTML-inhoud op en zet gewijzigde inhoud klaar voor indexering. Het ontdekken van pagina’s en automatisch opslaan starten de import niet zelf. JavaScript wordt niet gerenderd en robots.txt wordt niet afgedwongen; gebruik alleen openbare pagina’s die je mag indexeren en selecteer de gewenste scope bewust. De duur hangt af van de ontdekkingsstap, het aantal pagina’s en het indexeringswerk.
Gebruik Content toevoegen en vernieuwen wanneer je begeleiding nodig hebt bij sitemaps, handmatige URL’s, crawlen, meertaligheid of opnieuw scrapen.
3. Controleer geïndexeerde content
Open Kennis → Pagina’s en vergelijk de gevonden pagina’s met je verwachte bronnen. Bekijk de scrape-taak voor aantallen en waarschuwingen over gedeeltelijke inhoud en controleer ook de afzonderlijke embeddingtaak voordat je antwoorden beoordeelt. Een voltooide scrape betekent niet dat elke aangevraagde pagina of sectie is geïndexeerd. Zie voortgang en gedeeltelijke indexering.
4. Test de antwoordkwaliteit
Open Chatbot testen en stel representatieve vragen die echte bezoekers zullen gebruiken. Controleer of antwoorden:
- de geïndexeerde documentatie gebruiken in plaats van onbewezen aannames;
- naar nuttige bronpagina’s linken;
- ontbrekende informatie afhandelen met de bedoelde fallback;
- werken voor belangrijke talen en terminologie.
Verbeter bij zwakke antwoorden de broninhoud of paginaselectie en ververs opnieuw zodra de wachttijd van je abonnement dit toestaat: Free maximaal wekelijks, betaalde abonnementen maximaal dagelijks. Chatbot testen gebruikt het berichtenquotum van de eigenaar en slaat gesprekken op. Testinteracties kunnen verschijnen in Analyses en, wanneer ze als onbeantwoord worden herkend, in Onbeantwoorde vragen; facturering en registratie van hiaten hangen af van de uitkomst. Installeer de chatbot niet alleen omdat de eerste scrape klaar is.
5. Stem de ervaring af
Gebruik Aanpassen → Gedrag om Behulpzame assistent, Verkoopmedewerker, Technische support, Sarcastische bot of Aangepaste persona te kiezen en de instructies te bewerken. Wijzigingen worden automatisch opgeslagen; controleer de opslagstatus voordat je verdergaat. Als je een voorinstelling bewerkt, wordt die Aangepast. De instructies vullen de ingebouwde grounding- en opmaakregels van ChattyBox aan; opgehaalde inhoud wordt automatisch toegevoegd, dus plak je kennisbank niet in de prompt.
Personatekst vervangt niet de afgedwongen fallback bij ontbrekende context of hiaten in de inhoud. De aparte instelling assistant.fallbackMessage is beschikbaar via configuratie als code, niet als Persona-veld. Test na het opslaan zowel ondersteunde vragen als het fallbackgedrag. Gebruik Aanpassen → Uiterlijk om titel, welkomstbericht, kleuren, pictogram, positie en taalgedrag van de gehoste widget vooraf te bekijken. Ook deze wijzigingen worden automatisch opgeslagen; controleer de opslagstatus. De vaste modus en scriptoverschrijvingen bepalen de UI-taal van de widget, niet de talen van geïndexeerde pagina’s; zie problemen met de taal oplossen. Free bevat styling maar vereist ChattyBox-branding; met Starter en hoger kun je die verbergen.
Deze keuzes komen na het testen van de content, zodat de visuele inrichting problemen met retrieval of documentatie niet verbergt.
6. Kies een integratie
| Doel | Volgende stap |
|---|---|
| De onderhouden interface van ChattyBox vanuit applicatiecode mounten | JavaScript-SDK |
| Je eigen interface bouwen en onderhouden | Headless JavaScript-SDK |
| Een AI-codeerassistent het npm-pakket laten integreren | AI-ondersteunde integratie |
| Projectconfiguratie vanuit Git en CI beheren | CLI en configuratie-deployment |
| De onderhouden interface zonder npm of buildstap gebruiken | Script voor gehoste widget |
| De onderhouden widget aan WordPress toevoegen zonder themabewerkingen | WordPress-plug-in |
| De onderhouden widget met Composer aan Drupal 10 of 11 toevoegen | Drupal-module |
Browserintegraties hebben een openbare widget-API-sleutel nodig. Een sleutel die voor het domein van een website is voorbereid, kan al tot die origin zijn beperkt; sleutels die zonder beperkingen zijn gemaakt, werken op verschillende origins. Gebruik Installeren → Sleutels en domeinen en Origins bewerken om optionele beperkingen te beheren en de benodigde productie-, preview-, staging- en localhost-origins toe te voegen. Als beperkingen zijn ingeschakeld, moeten schema, hostnaam en poort exact overeenkomen (bijvoorbeeld https://example.com en http://localhost:3000 zijn verschillende origins). Dit is optionele extra beveiliging, geen bezoekersauthenticatie. Selecteer de sleutel bij Installeren → Installatie op website en kopieer het gegenereerde fragment en de API-URL.
Openbare widgetsleutels zijn bedoeld om in browsercode te staan. Configuratiedeploymenttokens en andere beheergegevens zijn privé en mogen nooit aan een website worden toegevoegd.
Om een bestaande openbare sleutel terug te vinden, voer je bij Installatie op website een HTTP(S)-website-URL in en selecteer je de sleutel in het fragment. De kiezer toont niet-verlopen sleutels die onbeperkt zijn of voor de origin van die URL zijn toegestaan. Voer voor een beperkte sleutel een toegestane origin in; bekijk de beperkingen via Sleutels en toegestane domeinen beheren. Is het formulier niet beschikbaar, voltooi dan eerst de getoonde installatiestap in het dashboard. Maak voor rotatie een nieuwe sleutel, werk de installatie bij en test die, en verwijder daarna de oude sleutel. Verwijderen stopt onmiddellijk installaties die die sleutel nog gebruiken. Een sleutel hoort bij één chatbot; een naam als “staging” of “production” scheidt omgevingen niet af.
7. Valideer vóór de lancering
Installeer de gekozen integratie eerst op een preview- of staging-site. Test de gedeployde origin, navigatie tussen routes, citaten, fallbackgedrag, mobiele layout en browserconsole voordat je breed publiceert.
Voltooi de launchchecklist en gebruik daarna Gesprekken → Geschiedenis om de opgeslagen gesprekken te bekijken (beschikbaar bij elk abonnement), of Analyses en Onbeantwoorde vragen met Pro/Business om de documentatie te verbeteren wanneer er echte vragen binnenkomen.
Dashboardoverzicht
Open een project via /chatbot/<projectId>. De weergaven zijn tabbladen die worden geselecteerd met de queryparameter tab, geen afzonderlijke subpagina’s:
| Werkruimteweergave | Querywaarde | Wat je daar kunt doen |
|---|---|---|
| Overzicht | overview | Voortgang van de installatie en recente activiteit bekijken |
| Kennis → Importeren en verversen | settings | Pagina’s ontdekken, selecteren, importeren en verversen; broninstellingen aanpassen |
| Kennis → Pagina’s | content | Pagina’s en scrape-taken bekijken, inhoud verwijderen en embeddings opnieuw opbouwen |
| Chatbot testen | test | Vragen stellen en opgeslagen gesprekken opnieuw bekijken |
| Gesprekken → Geschiedenis | logs | Opgeslagen gesprekken lezen en afzonderlijke of alle gesprekken verwijderen |
| Gesprekken → Analyses | analytics | De laatste 30 dagen aan geregistreerde interacties bekijken, maximaal 5.000; Pro/Business |
| Gesprekken → Onbeantwoorde vragen | gaps | Herkende onbeantwoorde vragen bekijken en oplossen; Pro/Business |
| Aanpassen → Gedrag | prompts | Instructies voor de assistent kiezen of bewerken |
| Aanpassen → Uiterlijk | appearance | Het uiterlijk en de taal van de gehoste widget bekijken en aanpassen |
| Installeren → Sleutels en domeinen | keys | Openbare widgetsleutels beheren en optionele originbeperkingen bewerken |
| Installeren → Installatie op website | embed | Een installatie voorbereiden en het fragment voor een sleutel kopiëren |
| Chatbotinstellingen | manage | Chatbotgegevens, deploymenttokens en configuratievergrendeling beheren of de chatbot verwijderen |
Alle chatbots gaat terug naar /dashboard. Het accountoverzicht staat op /dashboard/overview; Account en facturatie staat op /settings/account en bevat profiel, abonnement, berichtgebruik, facturatieportaal en PAYG-instellingen. /settings en /settings/billing verwijzen door. /settings/keys biedt een projectkiezer voor het aanmaken of verwijderen van openbare sleutels; optionele origininstellingen staan in Sleutels en domeinen van de chatbot.
Machtigingen en configuratievergrendeling
Alleen de eigenaar (of de eigenaar van een legacy-werkruimte) heeft toegang tot projectinstellingen in het dashboard. Een openbare widgetsleutel geeft geen toegang tot projectinstellingen of opgeslagen gespreksgeschiedenis; lidmaatschap van een organisatie alleen verleent deze projectmachtigingen niet.
Voor beheer via Git/CI kun je onder Chatbotinstellingen configuratie-deploymenttokens aanmaken met scopes voor ontwikkeling, preview en/of productie, een optionele vervaldatum en de mogelijkheid tot intrekken. De volledige tokenwaarde wordt alleen bij het aanmaken getoond; in dit gedeelte staat ook de deploymentgeschiedenis.
Configuratie vergrendelen is onomkeerbaar. Het blokkeert configuratiewijzigingen in het dashboard en handmatige contentbewerkingen, waaronder Persona opslaan en Nu scrapen, ook als een bedieningselement zichtbaar blijft. Deploy configuratie voortaan via de CLI-workflow. Openbaar-sleutelbeheer, gesprekken opschonen en de brandingvoorkeur die je abonnement toestaat, staan los van deze vergrendelde configuratievelden. Tokenomgevingsscopes autoriseren deployments; ze maken geen aparte chatbots of browser-sleutelomgevingen.
Via configuratie als code is ook widget.enabled beschikbaar. Instellen op false schakelt openbare chat uit, ook via de headless SDK, niet alleen de zwevende widget. De huidige weergave Uiterlijk heeft geen aan/uit-schakelaar.
Abonnementen en quota
| Abonnement | Chatbots | Inbegrepen pagina’s | Berichten per maand |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1.000 |
| Pro | 10 | 5.000 | 10.000 |
| Business | 25 | 25.000 | 50.000 |
Berichten en inbegrepen opgeslagen pagina’s zijn quota op eigenaarsniveau die worden gedeeld door de chatbots van de eigenaar, inclusief Chatbot testen. Maandelijks pagina-verversingswerk en de wachttijd tussen verversingen zijn afzonderlijke limieten; bekijk de verversingsquota vóór een grote import of herbouw. Zie prijzen voor de gedeelde planquota en Account en facturatie voor het huidige gebruik en de beschikbare quota van je account.
PAYG voor berichten, pagina’s en sites is optioneel bij Pro/Business en standaard uitgeschakeld. Stel onder Account en facturatie maandelijkse budgetten voor extra gebruik per functie in of kies expliciet Geen bestedingslimiet. Een budget van nul houdt die functie hard begrensd; zonder bestedingslimiet kunnen gebruikskosten onbeperkt oplopen. PAYG ontgrendelt geen functies van Free/Starter en omzeilt de crawler-wachttijden niet. Je kunt daar je profielnaam wijzigen; je e-mailadres beheer je via de accountinstellingen van je aanmeldprovider.