Zum Hauptinhalt springen

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-/Twilio-ProblemTelefon-Probleme
Schlechte AudioqualitätNetzwerk-/EinstellungsproblemAudio-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. LLM-Einstellungen prüfen

    • Anbieter ausgewählt (OpenAI usw.)
    • Modell ausgewählt
    • API-Verbindung aktiv

  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. Twilio-Verbindung prüfen

    • Integration → Twilio
    • Status sollte "Verbunden" sein
    • Wenn nicht, Anmeldedaten erneut eingeben

  2. Nummernzuweisung verifizieren

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

  3. Twilio-Konto prüfen

    • Bei Twilio einloggen
    • Konto hat Guthaben?
    • Nummer ist aktiv?
    • Webhook korrekt konfiguriert?

  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

    • In Twilio 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. Twilio-Status prüfen

  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. STT 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. Nutzung prüfen

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

  3. 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

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​

Twilio verbindet nicht​

Lösungen:

  1. Anmeldedaten verifizieren

    • Account SID korrekt?
    • Auth Token korrekt?
    • Keine zusätzlichen Leerzeichen kopiert?

  2. Twilio-Kontostatus prüfen

    • Konto aktiv und aufgeladen?
    • Nicht gesperrt?

  3. Anmeldedaten neu eingeben

    • Trennen und neu verbinden
    • Frisch aus Twilio-Konsole kopieren

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/Agency: Innerhalb von 4 Stunden

Statusseite​

Plattformstatus bei Ausfällen prüfen:

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

Verwandte Themen​