Als iets niet werkt, is dit de eerste pagina om te raadplegen. De symptomen zijn geordend op de plek waar je ze opmerkt — begin bij het onderdeel dat past bij wat je ziet.
Geen paniek. De meeste problemen zijn configuratiefouten, geen bugs. Het platform is zo opgezet dat je niets belangrijks kunt stukmaken — pauzeer de deployment, los het op, hervat. Zelfs een vervelend probleem kost je zelden meer dan een paar verspilde testgesprekken.
Staat je probleem er niet bij? Mail [email protected] met de deployment-ID, de call-ID (indien van toepassing) en een beschrijving van wat je verwachtte en wat er gebeurde. Voeg screenshots toe als het om iets visueels gaat.
Testgesprekken
"Mijn testgesprek kwam nooit binnen."
| Mogelijke oorzaak | Wat te controleren |
|---|
| Verkeerde notatie telefoonnummer | Neem de landcode op. VS: +15551234567. India: +919876543210. Het platform toont vooraf een preview met "geteste notatie: …". |
| Proeftegoed op | Instellingen → Abonnement en facturering → Verbruik. Nieuwe accounts krijgen $25 tegoed. |
| Nummer staat op de algemene blokkeerlijst | Instellingen → Compliance → Bel-me-niet-lijst → zoek je nummer op. |
| Weigering door provider | Sommige providers (vooral internationale) blokkeren gesprekken vanaf nieuwe nummers. Probeer een ander afzendernummer. |
| Spamfilter op je telefoon | Spamfilters van Apple/Google blokkeren soms stilzwijgend. Probeer een ander afzendernummer. |
"Het testgesprek kwam binnen, maar de Finn bleef stil of gedroeg zich vreemd."
| Mogelijke oorzaak | Wat te controleren |
|---|
| Welkomstbericht staat op vast, maar het veld is leeg | Finn bewerken → Welkomstbericht → zorg dat er tekst in het veld staat of schakel over naar dynamisch |
| Stem niet correct toegewezen | Finn bewerken → Stem → selecteer opnieuw. Sommige stemmen vereisen een overeenkomende regio. |
| LLM-service verkeerd geconfigureerd (geavanceerd) | Finn bewerken → AI Service Configuration → terugzetten naar standaard |
| Microfoonprobleem aan de kant van de Finn | Vernieuw en probeer opnieuw. Blijft het probleem? Neem contact op met support. |
Een Finn bouwen of bewerken
"Ik kan mijn Finn niet opslaan — de knop Opslaan is grijs."
| Mogelijke oorzaak | Wat te controleren |
|---|
| Verplicht veld leeg | Let op rode labels — meestal Naam, Stem of Taal. |
| Validatiefout in de workflow | Gebruik je het tabblad Workflow, controleer dan of er nodes met een rode rand zijn. |
| Browsersessie verlopen | Vernieuw, log opnieuw in en probeer het nogmaals. Je bewerkingen worden automatisch als concept opgeslagen. |
"Mijn Finn volgt het script niet dat ik heb geschreven."
| Waarschijnlijke oorzaak | Wat te herstellen |
|---|
| Identiteitsveld te vaag | Wees specifiek. "Je bent Maya, een vriendelijke receptioniste" werkt beter dan "Je bent een AI-assistent." |
| Guardrails verstopt onder te veel andere instructies | Verplaats cruciale guardrails naar een eigen apart veld (Style & Guardrails). |
| Tegenstrijdige instructies verspreid over velden | Controleer Identity + Style + Welcome + Workflow op tegenstrijdigheden. |
| Kennisbank bevat tegenstrijdige informatie | Open het tabblad Knowledge in de Data Extractor Sidebar voor een voorbeeldgesprek om te zien wat is opgehaald. Verwijder tegenstrijdigheden uit de kennisbank. |
| Vrije vorm terwijl je structuur nodig hebt | Gebruik Workflows als je een strikte, verplichte volgorde hebt. |
"De Finn is te spraakzaam / niet spraakzaam genoeg."
| Symptoom | Oplossing |
|---|
| Te veel praten | Voeg toe aan Response Guidelines: "Houd antwoorden korter dan twee zinnen, tenzij om meer detail wordt gevraagd." |
| Te kort | Voeg toe aan Response Guidelines: "Geef volledige antwoorden met voorbeelden waar relevant." |
| Onderbreekt de beller | Stel Settings → Call Settings → Interruption Sensitivity bij (lager = geduldiger) |
| Lange ongemakkelijke stiltes | Stel max_idle_duration lager in (bijv. 5s in plaats van 10s) |
"Mijn Finn stelt dezelfde vraag twee keer."
| Waarschijnlijke oorzaak | Oplossing |
|---|
| Het antwoord van de beller kwam niet overeen met het verwachte formaat | Maak de parser van de Ask-node soepeler, of herformuleer de vraag |
| LLM sloeg het antwoord niet op in het geheugen | Voeg toe aan Response Guidelines: "Stel een vraag niet opnieuw zodra die is beantwoord." |
| Bug met lus in workflow | Open de workflow → controleer op een edge die terugloopt naar de Ask-node |
Kennisbank
"Finn beantwoordt geen vragen waarvan ik weet dat ze in de documenten staan."
| Waarschijnlijke oorzaak | Wat te controleren |
|---|
| Documenten nog niet geïndexeerd | Tabblad Knowledge Base → controleer de status. Moet Indexed zijn. Klik op Re-index Now als het vastloopt. |
| Document bevat alleen afbeeldingen (PDF) | Gescande PDF's worden niet ge-OCR'd. Zet ze eerst om naar tekst (bijvoorbeeld met Adobe of een online OCR-tool). |
| Document te lang, ophalen mist relevante sectie | Splits het document op in kleinere, gerichte bestanden. |
| Formulering van de vraag komt niet overeen met die van het document | Open Data Extractor Sidebar → tabblad Knowledge voor een voorbeeldgesprek → bekijk wat er is opgehaald. Als er verkeerde fragmenten terugkomen, heeft de KB meer semantische dekking nodig. |
| Bestand groter dan limiet van 25 MB | Comprimeer of splits het bestand. |
"Finn geeft verouderde antwoorden."
| Mogelijke oorzaak | Oplossing |
|---|
| Oude versie van document staat nog in de KB | Knowledge Base → verwijder het oude bestand, upload het nieuwe |
| Website-import bevat verouderde gecachete inhoud | Knowledge Base → Website Imports → [URL] → Re-crawl Now |
| Gecachet queryresultaat (zeldzaam) | Klik op Re-index Now om verversen af te dwingen |
Deployments
"Ik heb op Launch geklikt, maar er gaan geen gesprekken uit."
| Mogelijke oorzaak | Wat te controleren |
|---|
| Buiten het beltijdvenster | Deployments bellen alleen binnen het ingestelde beltijdvenster in de lokale tijd van de gebelde. Start je om 8:00 uur PT met beltijden van 9-18 uur, dan gaat het eerste gesprek pas om 9:00 uur uit. |
| Doelgroep leeg | Open de doelgroep en controleer of er rijen in staan. Synchronisatieproblemen kunnen hem leeg achterlaten. |
| Alle nummers onderdrukt | Settings → Compliance → Do Not Call List. Als je per ongeluk je testlijst hebt onderdrukt, verwijder die dan. |
| Afzendernummer niet geregistreerd | Amerikaanse nummers zonder geregistreerde nummerweergave mislukken zonder melding. Controleer Settings → Phone numbers → [Number] → Registration Status. |
| Uitgavelimiet bereikt | Live Deployments → het health-paneel toont "Cap reached." Verhoog de limiet of wacht op de volgende periode. |
| Deployment gepauzeerd | Live Deployments → klik op de deployment → controleer de status. |
"Er gaan gesprekken uit, maar iedereen hangt meteen op."
| Mogelijke oorzaak | Oplossing |
|---|
| Nummerweergave toont "SPAM LIKELY" | Registreer de nummerweergave. Zonder registratie markeren Amerikaanse providers je gesprekken als spam en storten de opnamepercentages in. |
| Welkomstbericht klinkt als spam | Scherp de opening aan. "Hallo, u spreekt met [naam] van [herkenbare bedrijfsnaam] over [reden waarom ze een gesprek verwachten]." Dat "over" is belangrijk — bij algemene openingen wordt opgehangen. |
| Bellen op ongunstige tijden | Controleer of het beltijdvenster wordt toegepast. |
| Lijst is koud (geen eerdere relatie) | Dit is geen Finn-probleem, maar een lijstprobleem. Koude lijsten hebben altijd een lage opneem-en-blijf-luisteren-ratio. |
"De deployment is gepauzeerd, maar ik weet niet waarom."
Live Deployments → klik op de deployment → scroll naar Pauzereden. Veelvoorkomende redenen:
| Reden | Wat het betekent |
|---|
| Uitgavenlimiet bereikt | De ingestelde limiet per deployment is bereikt. Verhoog de limiet of sluit de deployment af. |
| Doelgroep uitgeput | Alle contacten zijn gebeld (inclusief nieuwe pogingen). Rond de deployment af of voeg meer contacten toe. |
| Buffer leeg | De dispatcher had even geen werk meer. Herstelt meestal binnen een minuut vanzelf. |
| Handmatige pauze | Jij of een teamlid heeft op Pauzeren geklikt. Bekijk het auditlogboek. |
| Storing bij provider | Probleem bij de telefonieprovider. Wordt hervat zodra de storing is verholpen. |
| Plaatslimiet bereikt | Je hebt het maandelijkse belquotum van je abonnement verbruikt. Upgrade of wacht op de volgende cyclus. |
Analytics
"Analytics toont nul gesprekken, maar ik weet dat er is gebeld."
| Waarschijnlijke oorzaak | Oplossing |
|---|
| Verkeerde deployment bekeken | Controleer de deployment-dropdown — je zit zo op een andere |
| Verouderde cache | Klik op Vernieuwen (de knop verschijnt zodra de badge "Cached" zichtbaar is) |
| Gesprekken korter dan 5 seconden | Sommige statistieken filteren zeer korte gesprekken eruit (die tellen als niet opgenomen). Bekijk het volledige gesprekslogboek. |
"De velden van de post-call analyse zijn leeg."
| Waarschijnlijke oorzaak | Oplossing |
|---|
| Velden toegevoegd nadat de deployment was gestart | Post-call analyse draait alleen op gesprekken die zijn afgerond nadat het veld is toegevoegd. Nieuwe gesprekken worden wel gevuld. |
| Vraag bij het veld is te vaag | Herformuleer. "Toonde de beller interesse?" werkt beter dan "Interesseniveau?" |
| Transcript is te kort | Als een gesprek 5 seconden duurde, valt er niets uit te halen. |
| Fout bij LLM-extractie | Zeldzaam. Controleer de Extraction Status van het gesprek in de zijbalk. |
"Sentiment lijkt verkeerd bij gesprekken."
Sentimentanalyse is niet perfect. Het is een nuttige indicatie, geen oordeel. Bij structurele misclassificatie voeg je een aangepast veld voor na het gesprek toe met een specifiekere vraag (bijv. "Leek de beller tevreden met de oplossing?") en gebruik je dat in plaats daarvan.
Telefoonnummers
"Ik heb een nummer gekocht maar kan het niet gebruiken."
| Waarschijnlijke oorzaak | Wat te controleren |
|---|
| Compliancecontrole nog niet afgerond | Sommige landen (India, Frankrijk, Duitsland) vereisen KYC. Instellingen → Telefoonnummers → [Nummer] → Compliancestatus. |
| Beller-ID niet geregistreerd (VS) | Uitgaande gesprekken mislukken met "carrier rejected" tot registratie is voltooid. |
| SIP-trunk verkeerd geconfigureerd (BYO) | Instellingen → Telefonie-account → test de trunk. Vaak voorkomend: codec-mismatch, verkeerde inloggegevens. |
| Nummer niet toegewezen aan een Finn (inkomend) | Instellingen → Telefoonnummers → [Nummer] → Standaard inkomende Finn → wijs er een toe. |
"Uitgaande gesprekken mislukken met 'carrier rejected'."
| Oorzaak | Oplossing |
|---|
| Beller-ID niet geregistreerd (VS/Canada) | Instellingen → Telefoonnummers → [Nummer] → Registratie beller-ID |
| Bestemmingsland vereist verificatie van de afzender | KYC via Instellingen → Telefoonnummers → Compliance |
| Nummer bevat geen spraakfunctionaliteit | Koop een nummer met spraakfunctie; nummers die alleen sms ondersteunen kunnen niet bellen |
| Provider filtert bekende kwaadwillende afzenders | Probeer een ander afzendernummer; oude nummers worden soms door providers geblokkeerd |
Integraties
| Waarschijnlijke oorzaak | Oplossing |
|---|
| Synchronisatieschema te weinig frequent | Instellingen → Integraties → [CRM] → stel in op elke 15 min of elk uur |
| CRM-token verlopen | Autoriseer de integratie opnieuw |
| Filter sluit nieuwe contacten uit | Open het CRM-filter van de doelgroep en controleer de criteria |
| CRM API-snelheidslimiet bereikt | Wacht en probeer opnieuw. Zware synchronisaties kunnen limieten aan CRM-zijde activeren. |
"Mijn webhook ontvangt geen events."
| Waarschijnlijke oorzaak | Wat te controleren |
|---|
| URL niet bereikbaar vanaf internet | Gebruik een openbare URL, geen localhost. Gebruik voor lokaal testen een tunnel (ngrok, Cloudflare Tunnel). |
| Retourneert een niet-2xx-respons | Het platform verwacht 200-299. 3xx/4xx/5xx leidt tot een nieuwe poging. |
| Endpoint verloopt in een time-out | Moet binnen 10 s reageren. Accepteer bij langlopende logica de webhook snel en verwerk deze asynchroon. |
| HMAC-handtekening komt niet overeen | Controleer of je ondertekeningsimplementatie overeenkomt met onze specificatie — zie Integraties → Webhooks. |
"Agenda-afspraken verschijnen niet in mijn agenda."
| Waarschijnlijke oorzaak | Oplossing |
|---|
| Verkeerde agenda geselecteerd | Instellingen → Integraties → Agenda → controleer de geselecteerde agenda |
| Rechten ingetrokken bij de agendaprovider | Autoriseer de integratie opnieuw |
| Afspraak kwam in een agenda die je niet bekijkt | Veel mensen hebben meerdere agenda's; de afspraak staat ergens. Controleer de weergave "alle agenda's". |
| Titel van agenda-item is misleidend | Afspraken krijgen standaard "Appointment via Finn" — zoek daarop |
Facturering
"Mijn factuur is hoger dan verwacht."
Instellingen → Abonnement en facturering → Gebruik → Anomaliemarkeringen. Zoek naar regels die meer dan 2x je gemiddelde van de afgelopen 30 dagen zijn. Veelvoorkomende oorzaken:
- Een Finn liep op een vijandig publiek en kwam in lange, vastgelopen gesprekken terecht (stel
limit_call_duration in).
- Een deployment werd gestart zonder uitgavenlimiet en belde een veel grotere lijst dan bedoeld.
- Een premium stem of premium model was ingeschakeld (Instellingen → Abonnement).
- Er is een nieuw land toegevoegd — internationale telefonietarieven kunnen 10-50x hoger liggen dan Amerikaanse tarieven.
"Ik wil een terugbetaling voor een mislukte deployment."
Mail [email protected] met de deployment-ID en een toelichting. Problemen door bugs worden meestal terugbetaald. Fouten in de configuratie door de gebruiker doorgaans niet, maar neem toch contact op — we beoordelen per geval.
Account en toegang
"Ik kan niet inloggen."
| Waarschijnlijke oorzaak | Wat te proberen |
|---|
| Wachtwoord vergeten | Klik op "Wachtwoord vergeten" op de inlogpagina |
| Account geblokkeerd na te veel mislukte pogingen | Wacht 15 minuten en probeer het opnieuw |
| E-mailadres niet bevestigd | Controleer je spammap op de bevestigingsmail |
| Teamaccount, maar je bent niet uitgenodigd | Vraag je beheerder om je uit te nodigen via Instellingen → Team |
| SSO werkt niet | Als je organisatie SSO gebruikt, moet je inloggen via de SSO-link, niet met e-mailadres en wachtwoord |
"Ik heb geen toegang meer tot mijn account / mijn 2FA-apparaat kwijt."
Mail [email protected] met bewijs van accounteigendom (factuur-e-mailadres, laatste 4 cijfers van de betaalmethode, enz.). We helpen je weer toegang te krijgen.
Prestaties / kwaliteit
"De latency is te hoog — Finn doet te lang over een antwoord."
Streefwaarde: <800 ms tussen het einde van de spraak van de beller en het begin van Finns antwoord.
| Oorzaak | Oplossing |
|---|
| Premium stem geselecteerd | Schakel over naar een standaardstem (-100-200 ms) |
| Verafgelegen regio | Stel bij registratie de accountregio in die het dichtst bij je bellers ligt |
| Netwerkproblemen bij de provider | Meestal tijdelijk — wacht een paar minuten |
| Complexe workflow met diepe nesting | Vereenvoudig; voeg subflows samen |
| Grote kennisbank + trage retrieval | Instellingen → Kennis → opnieuw indexeren, of kennisbank verkleinen |
"Finn klinkt robotachtig / niet menselijk genoeg."
| Oorzaak | Oplossing |
|---|
| Standaard stemniveau | Probeer een premium stem |
| Taal komt niet overeen | Controleer of de primaire taal van de stem overeenkomt met de taal die je spreekt |
| Antwoordrichtlijnen te streng | "Houd antwoorden korter dan één zin" maakt het kortaf. Versoepel dit. |
| Workflow dwingt een star script af | Schakel over op vrije vorm, of gebruik Say-nodes spaarzamer |
Als niets anders werkt
- Pauzeer de deployment — stopt het bellen, geen verdere kosten.
- Bekijk een recent mislukt gesprek — open de Data Extractor Sidebar voor de volledige context.
- Doorzoek deze troubleshootingpagina met Ctrl+F op trefwoorden uit je foutmelding.
- Mail support — [email protected] met deployment-ID, gespreks-ID en je beschrijving.
- Gebruik de Finn-chatbubbel — rechtsonder — die is getraind op deze documentatie en lost problemen meestal direct op.
- Voor Enterprise-klanten — je vaste CSM zit in je Slack-kanaal.
Volgende
- FAQ → — vragen die niet echt over troubleshooting gaan.
- Compliance → — zaken die misgaan door juridische of regelgevende problemen.
- Woordenlijst → — definities van termen die je niet herkent.