Troubleshooting

Fälle aus dem tatsächlichen Betrieb. Symptom → Ursache → Lösung.

Zugang

Ich komme nicht ins Dashboard

Anmeldung schlägt fehl oder die Seite scheint nicht zu laden.

  • Welcher Dialog? Grauer Browserkasten oder gestaltete Seite mit E-Mail? Das entscheidet das Passwort.
  • kissa-ai users — Zustand gesperrt?
  • kissa-ai set-password mail@firma.ch bzw. kissa-ai set-htpasswd kissa

Seite tot nach Passwortänderung

Sieht nicht aus wie falsches Passwort, sondern wie eine tote Seite.

Ursache: Browser speichert Basic-Auth. Lösung: privates Fenster öffnen.

Server oder Browser?

curl -s -o /dev/null -w "%{http_code}\n" https://kissa-ai.kitech.ai/healthz
curl -s -o /dev/null -w "%{http_code}\n" -u kissa https://kissa-ai.kitech.ai/

200 heisst: Server in Ordnung.

Nach Anmeldung kein Menü

Betrifft Versionen vor 1.15.0. Aktualisieren oder /einrichten aufrufen.

Meta und Instagram

Es kommen keine Nachrichten an

  • Professional-Konto + Facebook-Seite?
  • Webhook-Abos: comments und messages
  • kissa-ai status — öffentliche Adresse gesetzt?
  • Konto eingeschaltet? Ausgeschaltete Konten verwerfen Zustellungen.

Webhook-Verifizierung schlägt fehl

Verify Token unterschiedlich, oder Adresse von aussen nicht per HTTPS erreichbar.

Berechtigungen / redirect_uri

Ohne App Review nur Konten mit App-Rolle. Redirect-URI Zeichen für Zeichen gleich — kein Schrägstrich zu viel/zu wenig.

Keine Antwort auf ältere Nachricht

Plattformregel: DM 24 h, Kommentar 7 Tage.

Agent und Antworten

Kein Preis in der Antwort

Beabsichtigt: nur Wissensbasis/Preisspanne. Fehlende Pflichtangabe → keine Zahl.

Alles landet in der Freigabe

Stufe 1 so vorgesehen. Ungeprüfte Wissenseinträge erzwingen Freigabe.

Antwort verworfen statt vorgelegt

Preisgabe interner Angaben oder Behauptung, ein Mensch zu sein — nicht freigabefähig.

Nichts geht hinaus trotz Freigabe

Notbremse? Konto aus? Testmodus? Autonomie < 2? Fenster abgelaufen? Kontingent > 80 %? kissa-ai sendestatus

Betrieb

Dienst startet nach Update nicht

kissa-ai status, dann kissa-ai logs api --lines 40. Migrationen nur vorwärts; ggf. vorige Paketversion.

Queue-Fehler im Protokoll

Connection terminated unexpectedly / read ECONNRESET bei Neustarts sind normal.

Hilfe

E-Mail an info@kitech.ai mit: Version aus kissa-ai status, Plattform, Fehlermeldung im Wortlaut, relevante Logzeilen ohne Geheimnisse.