Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

Fehlerbehebung

Dieser Leitfaden hilft Ihnen, häufige Probleme mit der Hanc.AI-Plattform zu lösen. Finden Sie Ihr Problem unten und folgen Sie den Lösungsschritten.

Schnelldiagnose​

SymptomWahrscheinliche UrsacheLösungsabschnitt
Kann mich nicht anmeldenKonto-/PasswortproblemKontoprobleme
Agent reagiert nichtKonfigurationsproblemAgenten-Probleme
Falsche AntwortenWissensdatenbank-ProblemWissensdatenbank-Probleme
Anrufe verbinden nichtTelefon-EinrichtungsproblemTelefon-Probleme
Schlechte AudioqualitätNetzwerk-/EinstellungsproblemAudio-Probleme
Widget lädt nichtDomain-/Browser-ProblemWidget-Probleme
Anruf wird mit "Keine Credits" beendetCredits aufgebrauchtCredit-Probleme
Funktion nicht verfügbarTariflimitierungAbrechnungsprobleme

Kontoprobleme​

Kann mich nicht anmelden​

Symptome:

  • Login-Seite zeigt Fehler
  • Passwort wird nicht akzeptiert
  • Konto scheint gesperrt

Lösungen:

  1. E-Mail/Passwort prüfen

    • Korrekte E-Mail-Adresse sicherstellen
    • Feststelltaste prüfen
    • Passwort kopieren und einfügen versuchen

  2. Passwort zurücksetzen

    • Auf "Passwort vergessen" klicken
    • E-Mail prüfen (auch Spam-Ordner)
    • Reset-Link innerhalb von 1 Stunde anklicken
    • Neues Passwort erstellen

  3. Browser-Daten löschen

    • Cookies für hanc.ai löschen
    • Cache löschen
    • Inkognito-/Privatmodus versuchen

  4. Anderen Browser versuchen

    • Chrome, Firefox, Safari oder Edge
    • Browser-Erweiterungen deaktivieren

Immer noch fest? Kontaktieren Sie support@hanc.ai

Kann kein Konto erstellen​

Symptome:

  • Registrierung schlägt fehl
  • "E-Mail existiert bereits"-Fehler
  • Verifizierungscode nicht erhalten

Lösungen:

  1. E-Mail bereits registriert

    • "Passwort vergessen" versuchen, um bestehendes Konto wiederherzustellen
    • Andere E-Mail verwenden

  2. Telefonverifizierung schlägt fehl

    • Korrekte Landesvorwahl sicherstellen
    • Nummer ohne führende Null eingeben
    • 60 Sekunden warten, bevor neuer Code angefordert wird
    • Andere Telefonnummer versuchen

  3. Seitenfehler

    • Seite aktualisieren und erneut versuchen
    • Browser-Cache löschen
    • Anderen Browser versuchen

Agenten-Probleme​

Agent reagiert nicht​

Symptome:

  • Testanruf verbindet, aber Agent ist stumm
  • Agent spricht keine Begrüßung
  • Endloses Laden

Diagnoseschritte:

1. Prüfen, ob Agent aktiv ist (nicht pausiert)
2. Erste Nachricht ist eingestellt verifizieren
3. Prüfen, ob Prompt nicht leer ist
4. LLM-Anbieter verbunden verifizieren
5. Prüfen, ob Tarif weitere Anrufe erlaubt

Lösungen:

  1. Agent-Status prüfen

    • Zu Sprachagenten gehen
    • Sicherstellen, dass Agent als "Aktiv" angezeigt wird
    • Aus-/Einschalten, wenn hängengeblieben

  2. Erste Nachricht verifizieren

    • Agent-Einstellungen → Erste Nachricht
    • Sicherstellen, dass Text vorhanden ist
    • Nach Änderungen speichern

  3. Agent-Einstellungen prüfen

    • Prompt ist konfiguriert
    • Wissensdatenbank ist verbunden (falls zutreffend)

  4. Im Browser testen

    • Auf "Mit Agent sprechen" klicken
    • Mikrofon erlauben
    • Auf Begrüßung warten

Agent gibt falsche Informationen​

Symptome:

  • Falsche Preise genannt
  • Falsche Öffnungszeiten genannt
  • Erfundene Informationen

Ursache: Normalerweise ein Wissensdatenbank- oder Prompt-Problem.

Lösungen:

  1. Wissensdatenbank-Inhalt prüfen

    • Sind die korrekten Informationen vorhanden?
    • Sind sie klar formatiert?
    • Gibt es widersprüchliche Informationen?

  2. WD-Verbindung verifizieren

    • Agent-Einstellungen → Wissensdatenbank
    • Korrekte WD ausgewählt?

  3. Prompt-Einschränkungen verstärken Zum Prompt hinzufügen:

    KRITISCH: Nutze nur Informationen aus der Wissensdatenbank.
    Wenn Information nicht in der Wissensdatenbank ist, sage "Diese Information habe ich leider nicht."
    NIEMALS Preise, Öffnungszeiten oder andere spezifische Details erfinden.

  4. Temperature senken

    • Temperature auf 0.3-0.5 reduzieren
    • Deterministischere Antworten

Agent nutzt Wissensdatenbank nicht​

Symptome:

  • Sagt "Ich weiß nicht" für existierende Informationen
  • Generische Antworten statt spezifischer

Lösungen:

  1. WD-Verbindung bestätigen

    • Agent-Einstellungen → Wissensdatenbank-Bereich
    • Sollte Ihre WD als ausgewählt zeigen

  2. WD-Inhaltsformat prüfen

    • Klare Überschriften
    • Einfache Struktur
    • Frage/Antwort-Paare für FAQ

  3. FAQ-Format hinzufügen

    F: Wie sind Ihre Öffnungszeiten?
    A: Wir sind Montag-Freitag 9-18 Uhr und Samstag 10-14 Uhr geöffnet.

  4. Datei-Upload verifizieren

    • Zu Wissensdatenbank gehen
    • Prüfen, ob Datei in Liste erscheint
    • Prüfen, ob Dateigröße nicht null ist

Agent hört nicht auf zu reden​

Symptome:

  • Sehr lange Antworten
  • Wartet nicht auf Benutzer
  • Überwältigende Informationen

Lösungen:

  1. Zum Prompt hinzufügen:

    - Halte Antworten auf 1-2 Sätze
    - Stelle eine Frage auf einmal
    - Warte auf die Antwort des Kunden
    - Sei prägnant und direkt

  2. Max Tokens senken

    • Wenn in Einstellungen verfügbar
    • Begrenzt Antwortlänge

Wissensdatenbank-Probleme​

Datei-Upload schlägt fehl​

Symptome:

  • Fehler beim Hochladen
  • Datei abgelehnt
  • Verarbeitung hängt fest

Lösungen:

  1. Dateiformat prüfen

    • Unterstützt: .pdf, .docx, .txt, .md, .html, .csv
    • Nicht unterstützt: .doc (altes Word), .xls, Bilder

  2. Dateigröße prüfen

    • Maximale Dateigröße kann gelten
    • Große Dokumente aufteilen versuchen

  3. Dateiinhalt prüfen

    • Nicht passwortgeschützt
    • Nicht beschädigt
    • Enthält tatsächlichen Text (keine gescannten Bilder)

  4. Anderes Format versuchen

    • PDF in .txt oder .docx konvertieren
    • Text in neues Dokument kopieren

Information wird nicht gefunden​

Symptome:

  • Agent sagt "Ich weiß nicht"
  • Information existiert in WD, wird aber nicht genutzt

Lösungen:

  1. Struktur verbessern

    • Klare Überschriften für Themen
    • FAQ-Format für häufige Fragen
    • Lange Absätze vermeiden

  2. Exakte Phrasen verwenden

    • Anpassen, wie Kunden fragen
    • Variationen von Fragen einschließen

  3. Mehr Kontext hinzufügen

    • Nicht nur Preise auflisten
    • Dienstleistungsnamen und Beschreibungen einschließen

Verbesserungsbeispiel:

❌ Schlecht:

25, 35, 55

✅ Gut:

## Haarschnitt-Preise
- Herrenhaarschnitt: 25€
- Damenhaarschnitt: 35€
- Kinderhaarschnitt (unter 12): 20€

Telefon-Probleme​

Anrufe verbinden nicht​

Symptome:

  • Anrufe gehen zur Mailbox oder Fehler
  • Klingelt aber keine Antwort
  • Anruf wird sofort beendet

Lösungen:

  1. Telefonnummern-Verbindung prüfen

    • Integration → Telefonnummern
    • Status sollte "Verbunden" sein
    • Wenn nicht, Einrichtung prüfen

  2. Nummernzuweisung verifizieren

    • Telefonnummern-Bereich
    • Nummer hat Agent zugewiesen?
    • Agent ist aktiv?

  3. Telefonnummern-Status prüfen

    • Nummer ist aktiv?
    • Konto hat Credit-Guthaben?

  4. Mit Browser testen

    • "Mit Agent sprechen" im Dashboard nutzen
    • Wenn das funktioniert, ist Problem telefonseitig

Falscher Agent antwortet​

Symptome:

  • Agent A erwartet, Agent B bekommen
  • Falsche Begrüßung

Lösungen:

  1. Nummernzuweisung prüfen

    • Telefonnummern → Auf Nummer klicken
    • Korrekten Eingangs-Agenten ausgewählt verifizieren

  2. Auf Webhook-Konflikte prüfen

    • Verifizieren, dass Webhook auf Hanc.AI zeigt
    • Keine anderen Dienste abfangen

Audio-Probleme​

Schlechte Anrufqualität​

Symptome:

  • Roboterstimme
  • Abgehacktes Audio
  • Verzögerungen im Gespräch

Lösungen:

  1. Internetverbindung prüfen

    • Minimum 5 Mbps empfohlen
    • Kabelverbindung besser als WLAN

  2. Plattform-Status prüfen

    • Regionale Probleme können Qualität beeinflussen

  3. Andere Stimme versuchen

    • Einige Stimmen performen besser
    • Alternativen in Einstellungen testen

  4. Für Browser-Testanrufe

    • Andere Tabs/Anwendungen schließen
    • Kabelgebundenes Headset wenn möglich verwenden
    • Prüfen, ob Mikrofon nicht stumm ist

Agent versteht Anrufer nicht​

Symptome:

  • Agent bittet um Wiederholung
  • Versteht Wörter falsch
  • Falsche Transkription

Lösungen:

  1. Spracheinstellungen

    • Korrekte Sprache ausgewählt verifizieren
    • Mit erwarteter Sprache des Anrufers abgleichen

  2. Prompt für Klarheit Zum Prompt hinzufügen:

    Wenn du nicht verstehst, bitte den Anrufer höflich zu wiederholen.

  3. Spracherkennung unabhängig testen

    • Testanruf-Funktion nutzen
    • Klar sprechen und Probleme notieren
    • Kann Akzent oder Audioqualität sein

Abrechnungsprobleme​

Funktion nicht verfügbar​

Symptome:

  • Schaltfläche ausgegraut
  • "Upgrade erforderlich"-Meldung
  • Kann nicht mehr Agenten erstellen

Lösungen:

  1. Aktuellen Tarif prüfen

    • Einstellungen → Abrechnung
    • Tariflimits überprüfen

  2. Kann keinen Agenten erstellen

    • Der Free-Plan ist auf 1 Agenten begrenzt
    • Upgrade auf Starter oder höher für unbegrenzte Agenten

  3. Nutzung prüfen

    • Nahe an oder am Limit?
    • Auf nächsten Abrechnungszyklus warten oder upgraden

  4. Tarif upgraden

    • Wenn nötig, von Abrechnungsseite upgraden

Zahlung fehlgeschlagen​

Symptome:

  • "Zahlung fehlgeschlagen"-Fehler
  • Dienst unterbrochen
  • Kann Abonnement nicht aktualisieren

Lösungen:

  1. Kartendaten prüfen

    • Karte nicht abgelaufen?
    • Ausreichend Guthaben?
    • Korrekte Rechnungsadresse?

  2. Bank kontaktieren

    • Internationale Zahlungen gesperrt?
    • Verdächtige Aktivität markiert?

  3. Zahlungsmethode aktualisieren

    • Einstellungen → Abrechnung → Zahlung aktualisieren
    • Andere Karte versuchen

  4. Support kontaktieren

Widget-Probleme​

Widget lädt nicht​

Symptome:

  • Widget-Button erscheint nicht auf der Website
  • Widget zeigt einen Fehler oder leeren Bereich
  • Widget lädt, aber der Anruf wird nicht verbunden

Lösungen:

  1. Domain-Whitelist prüfen

    • Öffnen Sie die Widget-Einstellungen Ihres Agenten
    • Stellen Sie sicher, dass die Domain Ihrer Website in der Liste erlaubter Domains steht
    • Alle Varianten einschließen (mit/ohne www)

  2. Browser-Anforderungen prüfen Das Hanc.AI-Widget benötigt folgende Browser-Fähigkeiten:

    • WebGL 2.0 — zum Rendern der Widget-UI
    • Web Audio API — für die Audio-Verarbeitung
    • WebRTC — für Echtzeit-Sprachkommunikation

    Die meisten modernen Browser (Chrome, Firefox, Safari, Edge) unterstützen diese. Wenn Nutzer Probleme melden, bitten Sie sie, ihren Browser zu aktualisieren.

  3. Widget-Einbettungscode prüfen

    • Verifizieren Sie, dass das Embed-Script korrekt in Ihrem HTML platziert ist
    • Prüfen Sie die Browser-Konsole auf JavaScript-Fehler
    • Stellen Sie sicher, dass keine Ad- oder Script-Blocker stören

  4. Im Inkognito-Modus testen

    • Öffnen Sie Ihre Website in einem Inkognito-/Privatfenster
    • So schließen Sie Erweiterungs-Konflikte aus

Callback Widget – Probleme​

Besucher hat eine Nummer eingereicht, aber es kam kein Rückruf​

  1. Prüfen Sie, ob beim Agenten Rückrufe aktiviert sind — Öffnen Sie den Agenten → Tab Widgets → stellen Sie sicher, dass "Callback Widget aktivieren" eingeschaltet ist, und speichern Sie.
  2. Prüfen Sie, ob eine ausgehende Telefonnummer zugewiesen ist — Der Agent benötigt eine verifizierte ausgehende Nummer in seiner Nummernliste. Ohne diese schlagen die Rückrufe fehl.
  3. Prüfen Sie den Eignungs-Hinweis — Der Widgets-Tab zeigt ein Banner an, wenn eines der folgenden fehlt: bezahlter Plan, ausgehende Nummer oder verifizierte E-Mail.
  4. Schauen Sie ins Anrufprotokoll des Agenten — Fehlgeschlagene Rückrufe erscheinen im Protokoll mit einem klaren Fehlerhinweis (z.B. "Zielnummer nicht erreichbar", "keine ausgehende Nummer verfügbar").
  5. Prüfen Sie, ob die Nummer des Besuchers nicht fehlerhaft war — Das Widget validiert anhand des Formats des gewählten Landes, aber eine falsche Länderzuordnung kann eine Nummer durchlassen, die der Carrier später ablehnt.

Meldung "Warteschlange voll"​

Jeder Agent verarbeitet bis zu 10 Rückrufe parallel. Wenn die Warteschlange voll ist, warten neue Einreichungen. Warten Sie eine Minute und laden Sie neu — die Kapazität kehrt zurück, sobald laufende Anrufe enden. Wenn Sie regelmäßig an diese Grenze stoßen, sollten Sie den Verkehr auf mehrere Agenten verteilen.

Das Land des Besuchers ist nicht in der Auswahl​

Die Abdeckung ist kuratiert. Wenn Sie ein Land benötigen, das nicht aufgeführt ist, schreiben Sie an support@hanc.ai — die Abdeckung wird nach Bedarf erweitert.

Widget-UI erscheint auf Englisch statt in der konfigurierten Sprache des Agenten​

Das Widget liest die Sprache aus drei Quellen in folgender Priorität: das HTML-Attribut locale="…" am Einbettungs-Tag, die Widget-Sprache des Agenten im Dashboard und schließlich Englisch als Fallback. Sehen Sie Englisch auf einer deutschen Seite, steht die Agenten-Einstellung möglicherweise noch auf en — ändern Sie sie im Widgets-Tab des Agenten und speichern Sie.

Neuladen während eines laufenden Rückrufs zeigt ein frisches Formular statt des Warteschlangen-Status​

Das ist ungewöhnlich — das Widget verbindet sich beim Neuladen normalerweise wieder mit einem laufenden Rückruf. Stellen Sie sicher, dass das Einbettungs-Snippet auf beiden Seitenaufrufen identisch ist (gleiche agent-id, gleiche Nummer aus demselben Browser) und dass keine Datenschutz-Erweiterung die Seite beim Neuladen zurücksetzt.

Credit-Probleme​

Anruf wird mit "Keine Credits" beendet​

Symptome:

  • Anruf endet mitten im Gespräch abrupt
  • Trennungsgrund zeigt NO_CREDITS
  • Agent reagiert während eines aktiven Anrufs nicht mehr

Ursache: Ihrem Konto sind während eines laufenden Anrufs die Credits ausgegangen. Die Plattform beendet Anrufe, wenn keine Credits mehr zur Deckung der Nutzung verfügbar sind.

Lösungen:

  1. Credit-Guthaben prüfen

    • Zu Einstellungen → Abrechnung gehen
    • Verbleibende Credits prüfen

  2. Weitere Credits hinzufügen

    • Upgraden Sie Ihren Plan für mehr monatliche Credits
    • Credits aus Ihrem Abonnement sind sofort verfügbar

  3. Nutzung proaktiv überwachen

    • Analysen regelmäßig prüfen, um den Credit-Verbrauch zu verfolgen
    • Falls verfügbar, Nutzungs-Benachrichtigungen einrichten

  4. Übertragung von Credits verstehen

    • Ungenutzte Credits werden in den nächsten Monat übertragen
    • 100% Ihrer Abogebühr werden in Credits umgewandelt

Browser-Probleme​

Seite lädt nicht​

Lösungen:

  1. Seite aktualisieren (Strg/Cmd + R)
  2. Cache löschen (Strg/Cmd + Shift + Entf)
  3. Inkognito-Modus versuchen
  4. Anderen Browser versuchen
  5. Internetverbindung prüfen

Schaltflächen funktionieren nicht​

Lösungen:

  1. Werbeblocker deaktivieren für hanc.ai
  2. JavaScript aktivieren
  3. Cookies löschen
  4. Browser aktualisieren auf neueste Version

Integrationsprobleme​

Telefonnummern verbinden nicht​

Lösungen:

  1. Telefonnummern-Einrichtung verifizieren

    • Nummer ist aktiv?
    • Agent ist zugewiesen?

  2. Kontostatus prüfen

    • Konto aktiv und hat Credits?

  3. Erneut verbinden

    • Nummer trennen und neu verbinden
    • Support kontaktieren, wenn Probleme bestehen bleiben

Webhook empfängt keine Ereignisse​

Lösungen:

  1. URL verifizieren

    • URL ist öffentlich zugänglich
    • HTTPS (nicht HTTP)
    • Keine Authentifizierung erforderlich

  2. Server-Antwort prüfen

    • Muss 200-Status zurückgeben
    • Innerhalb von 30 Sekunden

  3. Mit webhook.site testen

    • Test-URL verwenden, um zu verifizieren, dass Ereignisse gesendet werden
    • Von dort debuggen

Hilfe erhalten​

Vor Kontaktaufnahme mit Support​

Diese Informationen sammeln:

  • Konto-E-Mail
  • Agent-Name/ID (falls zutreffend)
  • Screenshot des Fehlers
  • Schritte zur Reproduktion des Problems
  • Verwendeter Browser und Gerät

Support kontaktieren​

E-Mail: support@hanc.ai

Einschließen:

  • Klare Beschreibung des Problems
  • Wann es begann
  • Was Sie versucht haben
  • Screenshots falls hilfreich

Antwortzeit:

  • Standard: Innerhalb von 24 Stunden
  • Pro/Business: Innerhalb von 4 Stunden

Statusseite​

Plattformstatus bei Ausfällen prüfen:

  • Systemstatus-Ankündigungen
  • Geplante Wartungsfenster
  • Historische Verfügbarkeit

Verwandte Themen​