Veelvoorkomende foutmeldingen

Deze handleiding behandelt de meest voorkomende fouten die u bij het gebruik van Conviro kunt tegenkomen en hoe u ze oplost.

HTTP 401 -- Unauthorized

Betekenis: Uw API-sleutel of sessietoken is ongeldig of verlopen.

Oorzaken en oplossingen:

• API-sleutel is onjuist -- controleer de sleutel bij Dashboard -> Settings -> API Keys
• API-sleutel is ingetrokken -- genereer een nieuwe sleutel en werk uw integratie bij
• Sessie verlopen -- log uit en weer in op het dashboard
• Authorization-header ontbreekt -- zorg dat uw API-verzoek Authorization: Bearer sk_your_key bevat

HTTP 403 -- Forbidden

Betekenis: U hebt geen toestemming om deze resource te benaderen.

Oorzaken en oplossingen:

• Domein niet toegestaan -- voeg het domein van uw website toe bij Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains
• Planlimiet bereikt -- u probeert een functie te gebruiken die niet beschikbaar is in uw huidige plan (bijv. WhatsApp op Starter)
• Rolbeperking -- uw teamrol (Agent) heeft mogelijk geen rechten voor deze actie; vraag het aan een Admin of Owner
• Bot is inactief -- activeer de bot bij Dashboard -> Assistants

HTTP 404 -- Not Found

Betekenis: De opgevraagde resource bestaat niet.

Oorzaken en oplossingen:

• Verkeerd endpoint -- raadpleeg de API-documentatie op /developers voor de juiste URL's
• Verwijderde resource -- de chatbot, sessie of het contact is verwijderd
• Typefout in de ID -- controleer de resource-ID in de URL van uw verzoek

HTTP 429 -- Too Many Requests (Rate Limiting)

Betekenis: U hebt de API-rate limit van uw plan overschreden.

Oorzaken en oplossingen:

• Controleer de rate limit-headers in de response:

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

• Verlaag de frequentie van uw verzoeken -- bouw vertraging in of voer bewerkingen in batches uit
• Upgrade uw plan -- hogere plannen hebben hogere rate limits
• Cache de responses -- voorkom dat u hetzelfde verzoek herhaaldelijk verstuurt

Rate limits per plan:

CORS-fouten

Betekenis: De browser blokkeert een cross-origin verzoek.

Symptoom: U ziet in de browserconsole een fout zoals Access to XMLHttpRequest has been blocked by CORS policy.

Oorzaken en oplossingen:

• Widgetdomein niet toegestaan -- voeg uw domein toe aan de lijst Allowed Domains
• Gemengde inhoud -- zorg dat uw site HTTPS (geen HTTP) gebruikt als het widget via HTTPS wordt geladen
• Interferentie van proxy of CDN -- controleer of uw CDN de CORS-headers verwijdert

Mislukte webhookleveringen

Betekenis: Conviro heeft een webhook verstuurd, maar uw server antwoordde niet met een 2xx-statuscode.

Oorzaken en oplossingen:

• Server is offline -- controleer of uw webhook-endpoint draait en bereikbaar is
• Time-out -- Conviro wacht 10 seconden op een antwoord. Zorg dat uw endpoint snel reageert
• Probleem met het SSL-certificaat -- uw endpoint moet een geldig SSL-certificaat hebben (zelfondertekende certificaten worden niet geaccepteerd)
• Firewall blokkeert -- zet het IP-bereik van Conviro op de whitelist van uw firewall
• Verkeerde URL -- controleer de webhook-URL bij Dashboard -> Settings -> Webhooks

Herhaalbeleid: Conviro probeert mislukte webhooks 3 keer opnieuw met exponentiële backoff (1 min, 5 min, 30 min). Na 3 mislukte pogingen wordt de webhook als mislukt gemarkeerd en ontvangt u een e-mailmelding.

Bekijk de leveringslogboeken bij Dashboard -> Settings -> Webhooks -> Delivery Log.

Berichtenlimiet bereikt

Betekenis: U hebt al uw maandelijkse berichten verbruikt.

Oorzaken en oplossingen:

• Free/Starter -- gesprekken worden gepauzeerd tot de volgende factuurperiode. Stap over op een hoger plan voor meer berichten.
• Pro/Growth -- schakel facturering van extra verbruik in bij Dashboard -> Settings -> Billing om automatisch extra berichtenblokken aan te schaffen.
• Verbruik bekijken -- volg uw verbruik bij Dashboard -> AI Usage.

Algemene tips

• Controleer altijd de browserconsole (F12) op fouten aan de clientzijde.
• Bekijk bij API-fouten de response body -- die bevat meestal een duidelijke foutmelding.
• Raadpleeg de statuspagina van Conviro voor lopende storingen of onderhoud.
• Lukt het niet om het probleem op te lossen, neem dan contact op via [email protected] met de foutdetails, het request-ID (indien beschikbaar) en de stappen om de fout te reproduceren.