Aan de slag
In de komende release worden inbegrepen pagina's gedeeld tussen de projecten van een eigenaar; tot de uitrol kan het openbare dashboard nog de eerdere limieten per chatbot tonen.
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 New Chatbot en geef het project een naam en optioneel een Website URL. Open de chatbot daarna vanuit de projectlijst. Het standaardtabblad is Content; alleen maken start geen scrape.
Bekijk prijzen voor de actuele limieten voor projecten, pagina’s en gebruik.
2. Configureer je contentbron
Open Settings. Sla onder General Settings de openbare Website URL op met Save Changes. Kies onder Scraping Configuration ontdekmodus, maximumaantal pagina’s en optioneel schema en sla op met Save Config. Dit zijn afzonderlijke formulieren; include/exclude en crawldiepte zijn alleen beschikbaar via configuratie als code.
Voer Scrape now uit. ChattyBox haalt leesbare openbare HTML op en zet gewijzigde inhoud in de wachtrij voor indexering. Het rendert geen JavaScript en handhaaft robots.txt niet; gebruik alleen geautoriseerde openbare bronnen.
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
Ga terug naar Content en vergelijk de werkelijke pagina’s met de verwachte. Een voltooide scrape garandeert niet elke URL of sectie: controleer waarschuwingen voor gedeeltelijke indexering en de aparte embeddingstatus voordat je beoordeelt.
4. Test de antwoordkwaliteit
Open Test Chat 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 broncontent of selectie en scrape opnieuw zodra de cooldown dit toestaat: Free hoogstens wekelijks, betaalde plannen hoogstens dagelijks. Test Chat verbruikt berichtquotum en verschijnt met openbare chat in Logs, Analytics en Content Gaps.
5. Stem de ervaring af
Gebruik Persona om een profiel of Custom Persona te kiezen, instructies te bewerken en op te slaan. Persona vult groundingregels aan en kan ontbrekende context niet leveren of de afgedwongen fallback vervangen; assistant.fallbackMessage is alleen beschikbaar via configuratie als code. Gebruik Embed voor titel, welkomstbericht, kleuren, pictogram, positie en taalgedrag.
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. Openbare sleutels werken standaard voor productie-, preview-, staging- en localhost-origins. Kies voor optionele extra beveiliging Public Keys > Edit origins, schakel Restrict this key to specific origins in en voeg elke toegestane browser-origin toe. Beperkte origins moeten exact overeenkomen op schema, hostnaam en poort (bijvoorbeeld https://example.com en http://localhost:3000 zijn verschillende origins). Ga vervolgens terug naar Embed om de sleutel te selecteren en het gegenereerde fragment en de API-URL te kopiëren.
Openbare widgetsleutels zijn bedoeld om in browsercode te staan. Configuratiedeploymenttokens en andere beheergegevens zijn privé en mogen nooit aan een website worden toegevoegd.
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 Logs in elk plan of Analytics en Content Gaps in Pro/Business.
Dashboardoverzicht
Onder /chatbot/<projectId> zijn Content, Test Chat, Logs, Analytics (laatste 30 dagen, hoogstens 5.000 interacties; Pro/Business), Content Gaps (Pro/Business), Persona, Public Keys, Embed en Settings tabbladen. Account & Billing staat op /settings/account; berichten, opgeslagen pagina’s, maandelijks refreshbudget en cooldowns zijn afzonderlijke limieten. Config lock is onomkeerbaar en blokkeert dashboardwijzigingen en handmatige contentacties; openbare sleutels, gespreksopschoning en de plan-toegestane brandingvoorkeur blijven afzonderlijk.