Problemen oplossen
Veelvoorkomende problemen en hoe u ze kunt oplossen. Begin bij elk probleem met de eerste voorgestelde oplossing — dit is meestal de meest waarschijnlijke oorzaak.
Widget verschijnt niet op mijn website
- Controleer het dashboard — Open de URL van uw dashboard rechtstreeks. Als deze niet laadt, is de server mogelijk offline — neem contact op met uw accountmanager.
- Controleer
data-bot-id— De bot-ID in uw embed-code moet overeenkomen met de slug van uw bot. Controleer dit in Dashboard → Embed. - Controleer
data-backend-url— Deze moet het schema (https://) en het juiste domein bevatten. - Controleer de browserconsole — Open DevTools (F12) → Console voor JavaScript-fouten.
Widget verschijnt, maar de bot antwoordt niet
- Controleer de LLM-statusindicator — Als deze rood is, is OpenRouter niet verbonden. Ga naar Settings → AI Engine en maak opnieuw verbinding.
- Controleer of er een model is geselecteerd — Er moet een AI-model worden gekozen in het uitrolmenu.
- Controleer de kennisbank — Als deze leeg is, kan de bot generiek of helemaal niet antwoorden. Voeg inhoud toe in de Knowledge Base.
Chatgeschiedenis blijft niet bewaard bij het laden van de pagina
- LocalStorage moet ingeschakeld zijn — De widget slaat sessiegegevens op in de localStorage van de browser. De privé- of incognitomodus kan dit blokkeren.
- Bot-ID moet consistent zijn — Als de
data-bot-idper pagina verschilt, behandelt de widget ze als afzonderlijke bots met afzonderlijke geschiedenissen.
Eigen domein werkt niet
- Wacht op DNS-propagatie — Wijzigingen kunnen 5 tot 30 minuten duren.
- Controleer het A-record — Controleer het controlepaneel van uw DNS-provider om te bevestigen dat het A-record naar het IP-adres van uw server verwijst.
- Probeer SSL te vernieuwen — Ga naar Settings → Custom Domain → Renew SSL.
- Cloudflare-gebruikers — Zorg ervoor dat de SSL-modus is ingesteld op Full (Strict).
- Neem contact op met uw accountmanager als het probleem aanhoudt nadat de DNS is gesynchroniseerd.
Instellingen worden niet opgeslagen
- Controleer de DB-statusindicator — Deze moet bovenaan de pagina groen zijn.
- Vernieuw de pagina — Instellingen worden gecachet; een vernieuwing forceert een nieuwe uitlezing.
- Neem contact op met uw accountmanager als de DB-indicator rood is.
Dashboard laadt maar toont geen gegevens
- Controleer de statusindicatoren — Als DB of VEC rood is, heeft een backend-service mogelijk aandacht nodig.
- Vernieuw de pagina — Gegevens zijn mogelijk niet geladen bij het eerste bezoek.
- Neem contact op met uw accountmanager als de indicatoren rood blijven.
Integratietest mislukt
- Controleer inloggegevens — API-keys, SMTP-wachtwoorden en webhook-URL's moeten actueel zijn.
- Controleer Activity Logs — Filter op de module Integraties voor gedetailleerde foutmeldingen.
- Test de externe service — Bevestig of het webhook-endpoint, de SMTP-server of de API toegankelijk is.
Bot antwoordt generiek (negeert kennisbank)
- Controleer Sync Jobs — Bestanden of URL's kunnen nog in verwerking zijn. Wacht op de status Completed.
- Vernieuw de kennisbank — Ga naar de Knowledge Base en klik op Refresh.
- Controleer de system prompt — Tegenstrijdige instructies in Settings → Model Behavior kunnen het ophalen uit de kennisbank overschrijven.
- Voeg FAQ's toe — Voeg voor cruciale vragen een FAQ toe met het exacte antwoord. FAQ's hebben prioriteit.
WhatsApp-berichten komen niet aan
- Controleer de status van de WhatsApp-service — Ga naar Settings → WhatsApp en controleer of de service op Running staat.
- Controleer de API-gezondheidscontrole — De statusindicator moet groen zijn.
- Controleer de QR-code sessie — Als de verbinding is verbroken, scant u de QR-code opnieuw.
- Neem contact op met uw accountmanager als de service niet start.
Prestaties zijn traag
- Schakel over naar een sneller AI-model — Gebruik Gemini Flash of Claude Haiku voor een lagere latentie. Zie AI Models.
- Verlaag max tokens — Beperk de lengte van het antwoord in Settings → Model Behavior.
- Schoon de kennisbank op — Verwijder verouderde documenten om het zoeken te versnellen.
- Voeg FAQ's toe — Veelgestelde vragen die door FAQ's worden beantwoord, slaan het AI-model volledig over.
- Neem contact op met uw accountmanager als de traagheid aanhoudt — de server heeft mogelijk een resource-upgrade nodig.
Komt u er nog niet uit?
- Controleer Activity Logs in het dashboard voor foutmeldingen.
- Neem contact op met uw accountmanager met een beschrijving van het probleem en eventuele foutmeldingen die u ziet.