Launchchecklist

Gebruik deze checklist voordat je ChattyBox aan klanten toont. Hij vangt veelvoorkomende setupgaten op waardoor een chatbot geïnstalleerd lijkt, maar nog niet klaar is.

Combineer deze checklist voor een supportuitrol met de gids voor AI-chatbots voor klantenservice, zodat antwoorden uit openbare inhoud een duidelijk escalatiepad hebben voor accountspecifieke, gevoelige of onopgeloste vragen.

Content gereedmaken

• Er is openbare, crawlbare content geselecteerd waaruit de chatbot kan antwoorden.
• Privépagina’s, beheer, checkout, accounts, concepten en staging zijn bewust uitgesloten door de bronnen expliciet te selecteren; vertrouw niet alleen op robots.txt, want de crawler dwingt dit niet af.
• Je hebt de juiste invoer gekozen: sitemap, handmatige URL’s, alleen de homepage of crawl. Crawl gebruikt eerst gevonden conventionele sitemaps en valt daarna terug op links; een onvolledige sitemap wordt niet aangevuld door links te volgen.
• Belangrijke pagina’s over product, prijzen, beleid, support, FAQ, onboarding en probleemoplossing zijn opgenomen.
• Meertalige sites bevatten de taalversies waarvan je verwacht dat de widget ze gebruikt voor antwoorden.

Scraping valideren

• De scrape is beëindigd, opgeslagen/geselecteerde aantallen zijn vergeleken en de verwachte pagina’s zijn aanwezig. De badge Voltooid bewijst op zichzelf geen volledige dekking.
• Het aantal geïndexeerde pagina’s komt overeen met wat je verwachtte voor je plan en launchscope.
• Pagina’s met Gedeeltelijk geïndexeerd zijn gecontroleerd op ontbrekende tekst boven de limiet van 512 KiB; lange pagina’s zijn waar nodig opgesplitst.
• Afzonderlijke embeddingtaken zijn voltooid en het ophalen van informatie is met representatieve vragen getest.
• Recent bewerkte of gemigreerde pagina’s zijn opnieuw gescrapet.
• Voor ontbrekende pagina’s zijn authenticatie, botuitdagingen, mislukte/onveilige redirects, bronfilters en uitsluitend JavaScript-content gecontroleerd. Belangrijke tekst staat in de opgehaalde HTML, zonder JavaScript-rendering.
• Verouderde opgeslagen pagina’s zijn verwijderd via Kennis → Pagina’s, niet alleen uit de sitemap; de bron is aangepast om herontdekking te voorkomen.

Gebruik en eigenaarschap

• De projecteigenaar kan het dashboard openen en de chatbot beheren; publieke sleutels en lidmaatschap van een organisatie geven geen dashboardtoegang.
• Account en facturatie op /settings/account heeft genoeg berichtenruimte voor tests en lanceringsverkeer over alle chatbots van de eigenaar; Chatbot testen verbruikt die gedeelde berichtenruimte.
• Zowel de limiet voor opgeslagen pagina’s als het afzonderlijke maandelijkse budget voor pagina-refreshes is gecontroleerd. Dit refreshbudget wordt gedeeld over de projecten van de eigenaar. Handmatige indexrebuilds verbruiken ook refreshwerk.
• Het refreshschema past bij het plan: Free staat maximaal wekelijkse refreshes toe, betaalde plannen maximaal dagelijkse. Handmatige scrapepogingen volgen dezelfde wachttijd, ook na mislukte taken.
• Bij Pro/Business staat PAYG uit, is het per functie begrensd of is Geen bestedingslimiet bewust gekozen (dit kan onbeperkte gebruikskosten veroorzaken); dit heft de crawlerwachttijd of het maandelijkse refreshbudget niet op.
• Als configvergrendeling wordt gebruikt, zijn de onomkeerbare beperkingen en de aparte workflow met geheime deploymenttokens duidelijk.

Antwoordkwaliteit

• Je hebt echte testvragen gesteld uit verkoop-, support-, onboarding- en documentatiecases.
• Representatieve antwoorden zijn gebaseerd op geïndexeerde content en niet-ondersteunde vragen krijgen de bedoelde fallback. Controleer de antwoorden; een geslaagde test garandeert niet dat alle toekomstige antwoorden correct zijn.
• Bronvermeldingen verschijnen bij nuttige antwoorden.
• Citaatlinks openen de verwachte openbare bronpagina’s.
• Zwakke antwoorden zijn opgelost door de broncontent te verbeteren of ontbrekende pagina’s toe te voegen en daarna opnieuw te scrapen.
• Als de Persona is gewijzigd, bevestigt de opslagstatus dat deze is opgeslagen; validatiefouten zijn opgelost of mislukte opslagpogingen opnieuw uitgevoerd vóór het testen. De afgedwongen fallback is apart getest; de Persona-tekst vervangt niet de ingestelde reactie bij ontbrekende context.
• Testvragen bevatten voldoende context: de antwoordgenerator krijgt maximaal 12 recente opgeslagen berichten, elk afgekapt op 2.000 tekens, niet de volledige conversatie.

Widgetinstallatie

• De widget is geïnstalleerd op de bedoelde openbare pagina’s.
• Het script wordt slechts één keer per pagina geladen.
• Het script bevat data-api-key.
• Het script bevat data-api-url.
• Automatisch detecteren/Vast en Script-override toestaan zijn bewust ingesteld. data-locale krijgt alleen voorrang als overrides zijn toegestaan, ook in de modus Vast.
• De widgettaal, de taal van vragen/antwoorden en de geïndexeerde taalversies zijn afzonderlijk getest.
• De widget opent en verzendt een testvraag in een incognitovenster.
• Tests met een mobiele viewport bevestigen dat de launcher en het chatpaneel bruikbaar zijn.

Controles voor API-sleutel en optionele originbeperkingen

• De beoogde publieke sleutel is geselecteerd in Installeren → Installatie op website; beheer sleutels en origins via Installeren → Sleutels en domeinen.
• Een sleutelrotatie is afgerond door de nieuwe sleutel te installeren en te testen voordat de oude wordt verwijderd. Sleutelnamen scheiden omgevingen niet vanzelf.
• De sleutel is getest op de beoogde productie-, preview/staging- en localhost-sites. Een sleutel die voor een website is voorbereid, kan al tot die origin zijn beperkt; sleutels die zonder beperkingen zijn gemaakt, werken vanaf alle browserorigins.
• Als optionele beveiliging is ingeschakeld, staan de exacte bedoelde origins in Sleutels en domeinen → Origins bewerken (schema, host en poort moeten overeenkomen). Originbeperkingen zijn geen bezoekersauthenticatie en beveiligen geen afzonderlijke paden; publieke browsersleutels zijn geen geheimen.
• Er staan geen privéserver-API-sleutels, admintokens of geheimen in frontendcode, GTM, aangepaste CMS-HTML of de paginabron.

Browser- en deploymentcontroles

• De browserconsole bevat geen ChattyBox-fouten.
• Het Content Security Policy staat het widgetscript en de API-URL toe als je site CSP gebruikt.
• Adblockers of toestemmingshulpmiddelen blokkeren de widget niet op de pagina’s waar die wordt verwacht.
• De definitief gedeployde site, niet alleen de lokale ontwikkeling, is getest.

Na de lancering

• Controleer Gesprekken → Geschiedenis op elk plan en Analyses / Onbeantwoorde vragen op Pro of Business.
• Interpreteer Analyses als hoogstens 5.000 geregistreerde interacties van de afgelopen 30 dagen, inclusief Chatbot testen; dit bewijst geen antwoordnauwkeurigheid en is geen rapport van alleen bezoekersverkeer.
• Bekijk gevonden hiaten, test verbeterde content opnieuw en los hiaten handmatig op. De standaardlijst verbergt opgeloste hiaten; met Opgeloste hiaten opnemen. en Ongedaan maken kun je ze tonen en heropenen. Een terugkerende vraag heropent een opgelost hiaat niet automatisch.
• Controleer Populaire triggers als paginatoewijzing belangrijk is. De gehoste widget stuurt paginacontext zonder querystring of fragment, maar behoudt het pad. Laad of behoud de widget niet op gevoelige of privépagina’s. Een triggerregel verwijdert een al geïnitialiseerde widget niet bij SPA-navigatie: voer zo nodig teardown uit, bijvoorbeeld met window.ChattyBox.destroy() zodra de API beschikbaar is. De headless SDK sendMessage() stuurt geen paginacontext.
• Voeg ontbrekende documentatie, FAQ’s of voorbeelden toe op basis van echte bezoekersvragen.
• Scrape bijgewerkte pagina’s opnieuw na contentwijzigingen.
• Roteer publieke widgetsleutels indien nodig; pas originbeperkingen alleen aan als de optionele beperking actief is en de toegestane domeinen veranderen.
• Het verwijderen van gesprekken reset het verbruik of de Analytics niet; deze gegevens staan los van elkaar.

Als een item mislukt, gebruik dan Probleemoplossing vóór de lancering.