Wenn etwas nicht funktioniert, sollten Sie zuerst auf dieser Seite nachsehen. Die Symptome sind danach sortiert, wo sie auftreten – beginnen Sie mit dem Abschnitt, der zu Ihrer Beobachtung passt.
Zunächst: keine Panik. Die meisten Probleme sind Konfigurationsfehler, keine Bugs. Die Plattform ist so ausgelegt, dass Sie nichts Wichtiges zerstören können – Deployment pausieren, Problem beheben, fortsetzen. Selbst ein hartnäckiges Problem kostet Sie selten mehr als ein paar verschwendete Testanrufe.
Falls Ihr Problem hier nicht aufgeführt ist: Schreiben Sie an [email protected] und geben Sie die Deployment-ID, die Call-ID (falls zutreffend) sowie eine Beschreibung des erwarteten und des tatsächlichen Verhaltens an. Bei visuellen Problemen bitte Screenshots beilegen.
Testanrufe
„Mein Testanruf ist nie angekommen."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Falsches Rufnummernformat | Ländervorwahl angeben. USA: +15551234567. Indien: +919876543210. Die Plattform zeigt vor dem Auslösen eine Vorschau „getestetes Format: …" an. |
| Testguthaben aufgebraucht | Einstellungen → Tarif und Abrechnung → Nutzung. Neue Konten erhalten ein Guthaben von 25 $. |
| Nummer auf globaler Sperrliste | Einstellungen → Compliance → Do-Not-Call-Liste → nach Ihrer Nummer suchen. |
| Ablehnung durch den Netzbetreiber | Manche Netzbetreiber (vor allem international) blockieren Anrufe von neuen Nummern. Andere Absendernummer versuchen. |
| Spam-Blocker auf Ihrem Telefon | Spamfilter von Apple/Google blockieren manchmal unbemerkt. Von einer anderen Absendernummer aus testen. |
„Der Testanruf kam an, aber der Finn war stumm oder verhielt sich seltsam."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Begrüßungsnachricht auf definiert gesetzt, Feld aber leer | Finn bearbeiten → Begrüßungsnachricht → sicherstellen, dass Text im Feld steht, oder auf dynamisch umstellen |
| Stimme nicht korrekt zugewiesen | Finn bearbeiten → Stimme → erneut auswählen. Manche Stimmen erfordern eine passende Region. |
| LLM-Dienst falsch konfiguriert (fortgeschritten) | Finn bearbeiten → AI Service Configuration → auf Standard zurücksetzen |
| Mikrofonberechtigung auf Finn-Seite fehlerhaft | Neu laden, erneut versuchen. Bei anhaltendem Problem: Support kontaktieren. |
Finn erstellen / bearbeiten
„Ich kann meinen Finn nicht speichern – die Schaltfläche ‚Speichern' ist ausgegraut."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Pflichtfeld leer | Auf rot markierte Beschriftungen achten – meist Name, Stimme oder Sprache. |
| Validierungsfehler im Workflow | Bei Verwendung des Tabs „Workflow" auf Knoten mit roten Rahmen prüfen. |
| Browser-Sitzung abgelaufen | Neu laden, erneut anmelden, erneut versuchen. Ihre Änderungen werden als Entwurf automatisch gespeichert. |
„Mein Finn hält sich nicht an das Skript, das ich geschrieben habe."
| Mögliche Ursache | Lösung |
|---|
| Identitätsfeld zu vage | Werden Sie konkret. „Du bist Maya, eine freundliche Empfangsmitarbeiterin" ist besser als „Du bist ein KI-Assistent." |
| Guardrails gehen zwischen zu vielen anderen Anweisungen unter | Verschieben Sie wichtige Guardrails in ein eigenes Feld (Stil & Guardrails). |
| Widersprüchliche Anweisungen in verschiedenen Feldern | Prüfen Sie Identität, Stil, Begrüßung und Workflow auf Widersprüche. |
| Wissensdatenbank enthält widersprüchliche Informationen | Öffnen Sie für einen Beispielanruf den Tab Wissen in der Data-Extractor-Seitenleiste, um zu sehen, was abgerufen wurde. Entfernen Sie Widersprüche aus der Wissensdatenbank. |
| Freie Form, obwohl Struktur nötig ist | Bei einem festen Ablauf mit vorgegebener Reihenfolge nutzen Sie stattdessen Workflows. |
„Der Finn redet zu viel / zu wenig."
| Symptom | Lösung |
|---|
| Redet zu viel | Ergänzen Sie in den Antwortrichtlinien: „Halte Antworten unter zwei Sätzen, sofern nicht mehr Details gefragt sind." |
| Zu knapp | Ergänzen Sie in den Antwortrichtlinien: „Gib vollständige Antworten, mit Beispielen, wo sinnvoll." |
| Unterbricht den Anrufer | Passen Sie Einstellungen → Anrufeinstellungen → Unterbrechungsempfindlichkeit an (niedriger = geduldiger) |
| Lange, unangenehme Pausen | Setzen Sie max_idle_duration niedriger (z. B. 5 s statt 10 s) |
„Mein Finn stellt dieselbe Frage zweimal."
| Mögliche Ursache | Lösung |
|---|
| Die Antwort des Anrufers entsprach nicht dem erwarteten Format | Lockern Sie den Parser des Ask-Knotens oder formulieren Sie die Frage um |
| LLM hat die Antwort nicht im Speicher erfasst | Ergänzen Sie in den Antwortrichtlinien: „Wenn eine Frage beantwortet ist, stelle sie nicht erneut." |
| Schleifenfehler im Workflow | Workflow öffnen → prüfen, ob eine Kante zurück zum Ask-Knoten führt |
Wissensdatenbank
„Finn beantwortet Fragen nicht, obwohl ich weiß, dass sie in den Dokumenten stehen."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Dokumente noch nicht indexiert | Tab „Wissensdatenbank" → Status prüfen. Sollte Indexiert lauten. Bei Hängenbleiben auf „Jetzt neu indexieren" klicken. |
| Dokument ist reines Bild-PDF | Gescannte PDFs werden nicht per OCR erkannt. Zuerst in Text umwandeln (z. B. mit Adobe oder einem Online-OCR-Tool). |
| Dokument zu lang, Abruf verfehlt relevanten Abschnitt | Dokument in kleinere, thematisch fokussierte Dateien aufteilen. |
| Formulierung der Frage passt nicht zur Formulierung im Dokument | Data Extractor Sidebar → Tab „Knowledge" für einen Beispielanruf öffnen → prüfen, was abgerufen wurde. Kamen falsche Textstellen zurück, braucht die KB mehr semantische Abdeckung. |
| Datei überschreitet Größenlimit von 25 MB | Komprimieren oder aufteilen. |
„Finn gibt veraltete Antworten."
| Mögliche Ursache | Lösung |
|---|
| Alte Version des Dokuments noch in der KB | Knowledge Base → alte Datei löschen, neue hochladen |
| Website-Import enthält veralteten Cache-Inhalt | Knowledge Base → Website Imports → [URL] → Re-crawl Now |
| Zwischengespeichertes Abfrageergebnis (selten) | Auf Re-index Now klicken, um eine Aktualisierung zu erzwingen |
Deployments
„Ich habe auf Launch geklickt, aber es gehen keine Anrufe raus."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Außerhalb des Anrufzeitfensters | Deployments wählen nur innerhalb des konfigurierten Anrufzeitfensters in der Ortszeit des Angerufenen. Wird um 8:00 Uhr PT gestartet und sind die Anrufzeiten 9–18 Uhr, geht der erste Anruf erst um 9:00 Uhr raus. |
| Zielgruppe leer | Zielgruppe öffnen und prüfen, ob sie Einträge enthält. Sync-Probleme können sie leer lassen. |
| Alle Nummern unterdrückt | Settings → Compliance → Do Not Call List. Falls die Testliste versehentlich unterdrückt wurde, Einträge entfernen. |
| Absendernummer nicht registriert | US-Nummern ohne Caller-ID-Registrierung schlagen ohne Fehlermeldung fehl. Prüfen unter Settings → Phone numbers → [Nummer] → Registration Status. |
| Ausgabenlimit erreicht | Live Deployments → das Health-Panel zeigt „Cap reached". Limit erhöhen oder auf die nächste Periode warten. |
| Deployment pausiert | Live Deployments → Deployment anklicken → Status prüfen. |
„Anrufe gehen raus, aber alle legen sofort auf."
| Mögliche Ursache | Lösung |
|---|
| Caller ID zeigt „SPAM LIKELY" | Caller ID registrieren. Ohne Registrierung stufen US-Carrier die Anrufe als Spam ein und die Annahmequoten brechen ein. |
| Begrüßungsnachricht klingt nach Spam | Einstieg straffen. „Guten Tag, hier ist [Name] von [bekannter Firmenname] wegen [Grund, mit dem sie rechnen]." Das „wegen" ist entscheidend — bei generischen Einstiegen wird aufgelegt. |
| Anrufe zu ungünstigen Zeiten | Prüfen, ob das Zeitfenster für Anrufe angewendet wird. |
| Liste ist kalt (keine bestehende Beziehung) | Das ist kein Finn-Problem, sondern ein Listenproblem. Kalte Listen haben immer niedrige Annahme- und Verweilraten. |
„Die Deployment ist pausiert, aber ich weiß nicht warum."
Live Deployments → Deployment anklicken → zu Pause Reason scrollen. Häufige Gründe:
| Grund | Bedeutung |
|---|
| Ausgabenlimit erreicht | Das konfigurierte Limit pro Deployment wurde erreicht. Limit erhöhen oder Deployment schließen. |
| Zielgruppe erschöpft | Alle Kontakte wurden angerufen (inklusive Wiederholungsversuchen). Deployment abschließen oder weitere Kontakte hinzufügen. |
| Puffer leer | Dem Dispatcher sind kurzzeitig die Aufgaben ausgegangen. Erholt sich meist innerhalb einer Minute von selbst. |
| Manuelle Pause | Sie oder ein Teammitglied haben auf Pause geklickt. Prüfen Sie das Audit-Log. |
| Carrier-Ausfall | Störung beim Telefonieanbieter. Wird nach Ende der Störung fortgesetzt. |
| Tariflimit erreicht | Sie haben das monatliche Anrufkontingent Ihres Tarifs aufgebraucht. Upgraden oder auf den nächsten Abrechnungszeitraum warten. |
Analytics
„Analytics zeigt null Anrufe, obwohl Anrufe stattgefunden haben."
| Mögliche Ursache | Lösung |
|---|
| Falsches Deployment geöffnet | Deployment-Dropdown prüfen — man landet leicht bei einem anderen |
| Cache veraltet | Auf Refresh klicken (Button erscheint, wenn das Badge „Cached" sichtbar ist) |
| Anrufe waren kürzer als 5 Sekunden | Manche Metriken filtern sehr kurze Anrufe heraus (gelten als nicht angenommen). Sehen Sie im vollständigen Anrufprotokoll nach. |
„Die Felder der Nachbearbeitung sind leer."
| Mögliche Ursache | Lösung |
|---|
| Felder wurden nach dem Start des Deployments hinzugefügt | Die Nachbearbeitung läuft nur für Anrufe, die nach dem Hinzufügen des Feldes abgeschlossen wurden. Neue Anrufe werden befüllt. |
| Feldfrage zu unspezifisch | Umformulieren. „Hat der Anrufer Interesse geäußert?" ist besser als „Interessengrad?" |
| Transkript zu kurz | Wenn ein Anruf 5 Sekunden gedauert hat, gibt es nichts zu extrahieren. |
| LLM-Extraktionsfehler | Selten. Prüfen Sie den Extraktionsstatus des Anrufs in der Seitenleiste. |
„Die Stimmung wird bei Anrufen falsch erkannt."
Die Stimmungsanalyse ist nicht perfekt. Sie ist ein nützlicher Indikator, kein Urteil. Bei dauerhaft falscher Einstufung fügen Sie ein eigenes Feld für die Nachbearbeitung mit einer präziseren Frage hinzu (z. B. „Wirkte der Anrufer mit der Lösung zufrieden?") und verwenden Sie stattdessen dieses.
Telefonnummern
„Ich habe eine Nummer gekauft, kann sie aber nicht nutzen."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| Compliance-Prüfung ausstehend | Einige Länder (Indien, Frankreich, Deutschland) verlangen KYC. Einstellungen → Telefonnummern → [Nummer] → Compliance-Status. |
| Anrufer-ID nicht registriert (USA) | Ausgehende Anrufe schlagen mit „Carrier hat abgelehnt" fehl, bis die Registrierung erfolgt ist. |
| SIP-Trunk falsch konfiguriert (BYO) | Einstellungen → Telefoniekonto → Trunk testen. Häufig: Codec-Konflikt, falsche Zugangsdaten. |
| Nummer keinem Finn zugewiesen (eingehend) | Einstellungen → Telefonnummern → [Nummer] → Standard-Finn für eingehende Anrufe → einen zuweisen. |
„Ausgehende Anrufe schlagen mit ‚Carrier hat abgelehnt' fehl."
| Ursache | Lösung |
|---|
| Anrufer-ID nicht registriert (USA/Kanada) | Einstellungen → Telefonnummern → [Nummer] → Anrufer-ID-Registrierung |
| Zielland verlangt Absenderverifizierung | KYC unter Einstellungen → Telefonnummern → Compliance |
| Absendernummer unterstützt keine Sprachanrufe | Kaufen Sie eine sprachfähige Nummer; reine SMS-Nummern können nicht anrufen |
| Carrier filtert bekannte Problemabsender | Andere Absendernummer testen; alte Nummern landen mitunter auf Carrier-Sperrlisten |
Integrationen
„Die CRM-Synchronisierung übernimmt keine neuen Kontakte."
| Mögliche Ursache | Lösung |
|---|
| Synchronisierungsintervall zu lang | Einstellungen → Integrationen → [CRM] → auf alle 15 Minuten oder stündlich setzen |
| CRM-Token abgelaufen | Integration erneut autorisieren |
| Filter schließt neue Kontakte aus | CRM-Filter der Zielgruppe öffnen und Kriterien prüfen |
| CRM-API-Rate-Limit erreicht | Warten und erneut versuchen. Umfangreiche Synchronisierungen können Limits auf CRM-Seite auslösen. |
„Mein Webhook empfängt keine Events."
| Mögliche Ursache | Was zu prüfen ist |
|---|
| URL aus dem Internet nicht erreichbar | Eine öffentliche URL verwenden, nicht localhost. Für lokale Tests einen Tunnel nutzen (ngrok, Cloudflare Tunnel). |
| Antwort außerhalb des 2xx-Bereichs | Die Plattform erwartet 200–299. 3xx/4xx/5xx lösen einen erneuten Versuch aus. |
| Endpunkt läuft in Timeout | Muss innerhalb von 10 s antworten. Bei langlaufender Logik den Webhook schnell annehmen und asynchron verarbeiten. |
| HMAC-Signatur stimmt nicht überein | Prüfen, ob Ihre Signaturimplementierung unserer Spezifikation entspricht — siehe Integrationen → Webhooks. |
„Kalenderbuchungen erscheinen nicht in meinem Kalender."
| Mögliche Ursache | Lösung |
|---|
| Falscher Kalender ausgewählt | Einstellungen → Integrationen → Kalender → ausgewählten Kalender prüfen |
| Berechtigungen beim Kalenderanbieter entzogen | Integration erneut autorisieren |
| Buchung landete in einem Kalender, den Sie nicht ansehen | Viele Nutzer haben mehrere Kalender; die Buchung ist irgendwo. Ansicht „Alle Kalender" prüfen. |
| Irreführender Titel des Kalendereintrags | Buchungen heißen standardmäßig „Appointment via Finn" — danach suchen |
Abrechnung
„Meine Rechnung ist höher als erwartet."
Einstellungen → Tarif und Abrechnung → Nutzung → Anomalie-Kennzeichen. Nach Posten suchen, die mehr als das Doppelte Ihres 30-Tage-Durchschnitts betragen. Häufige Ursachen:
- Ein Finn lief auf einer schwierigen Zielgruppe und geriet in lange, festhängende Anrufe (
limit_call_duration setzen).
- Eine Kampagne wurde ohne Ausgabenlimit gestartet und hat eine deutlich größere Liste angerufen als beabsichtigt.
- Premium-Stimme oder Premium-Modell war aktiviert (Einstellungen → Tarif).
- Ein neues Land wurde hinzugefügt — internationale Telefontarife können das 10- bis 50-Fache der US-Tarife betragen.
„Ich möchte eine Rückerstattung für eine misslungene Kampagne."
Schreiben Sie an [email protected] mit der Deployment-ID und einer Erläuterung. Fehlerbedingte Fälle werden in der Regel erstattet. Konfigurationsfehler der Nutzer normalerweise nicht — melden Sie sich trotzdem, wir entscheiden im Einzelfall.
Konto und Zugriff
„Ich kann mich nicht anmelden."
| Mögliche Ursache | Was Sie versuchen können |
|---|
| Passwort vergessen | Auf der Anmeldeseite auf „Passwort vergessen" klicken |
| Konto nach zu vielen Fehlversuchen gesperrt | 15 Minuten warten, dann erneut versuchen |
| E-Mail nicht bestätigt | Spam-Ordner auf die Bestätigungs-E-Mail prüfen |
| Teamkonto, aber Sie wurden nicht eingeladen | Bitten Sie Ihren Admin um eine Einladung über Einstellungen → Team |
| SSO funktioniert nicht | Wenn Ihre Organisation SSO nutzt, müssen Sie sich über den SSO-Link anmelden, nicht mit E-Mail und Passwort |
„Ich habe den Zugriff auf mein Konto / mein 2FA-Gerät verloren."
Schreiben Sie an [email protected] mit einem Nachweis der Kontoinhaberschaft (Rechnungs-E-Mail, letzte 4 Stellen des Zahlungsmittels usw.). Wir helfen Ihnen, den Zugriff wiederherzustellen.
Leistung / Qualität
„Die Latenz ist zu hoch – Finn braucht zu lange zum Antworten."
Zielwert: <800 ms zwischen Ende der Nutzeräußerung und Beginn der Antwort von Finn.
| Ursache | Lösung |
|---|
| Premium-Stimme ausgewählt | Auf eine Standardstimme wechseln (-100–200 ms) |
| Weit entfernte Region | Kontoregion bei der Registrierung möglichst nah an Ihren Anrufern wählen |
| Netzprobleme beim Carrier | Meist vorübergehend – einige Minuten warten |
| Komplexer Workflow mit tiefer Verschachtelung | Vereinfachen; Unterabläufe zusammenfassen |
| Große Wissensdatenbank + langsamer Abruf | Einstellungen → Wissen → neu indexieren oder Umfang der Wissensdatenbank reduzieren |
„Finn klingt robotisch / nicht menschlich genug."
| Ursache | Lösung |
|---|
| Standard-Stimmklasse | Eine Premium-Stimme ausprobieren |
| Sprache stimmt nicht überein | Prüfen, ob die Hauptsprache der Stimme mit der gesprochenen Sprache übereinstimmt |
| Antwortrichtlinien zu restriktiv | „Antworten auf einen Satz beschränken" wirkt knapp. Lockern. |
| Workflow erzwingt starres Skript | Auf freie Formulierung wechseln oder Say-Nodes sparsamer einsetzen |
Wenn nichts anderes hilft
- Deployment pausieren – der Wählvorgang stoppt, es fallen keine weiteren Kosten an.
- Einen kürzlich fehlgeschlagenen Anruf ansehen – die Data-Extractor-Sidebar öffnen, um den vollständigen Kontext zu sehen.
- Diese Troubleshooting-Seite durchsuchen – mit Strg+F nach Stichwörtern aus deiner Fehlermeldung.
- E-Mail an den Support – [email protected] mit Deployment-ID, Anruf-ID und einer Beschreibung.
- Den Finn im Chat-Fenster nutzen – unten rechts – er ist auf diese Dokumentation trainiert und löst Probleme meist sofort.
- Für Enterprise-Kunden – dein dedizierter CSM ist in deinem Slack-Kanal erreichbar.
Weiter
- FAQ → – Fragen, die nicht ganz ins Troubleshooting fallen.
- Compliance → – Dinge, die aus rechtlichen oder regulatorischen Gründen scheitern.
- Glossar → – Definitionen für alle Begriffe, die dir unbekannt sind.