Zum Hauptinhalt springen

Fehlerbehebung & FAQ

Diese Seite behandelt h\u00e4ufige Probleme und deren L\u00f6sung bei der Arbeit mit PulseChat.

1. Chat erscheint nicht in der Seitenleiste​

Symptome:

  • Kein "Chat"-Men\u00fceintrag in der Admin-Seitenleiste.

Pr\u00fcfungen:

  1. Modul aktiviert?

    • Gehen Sie zu Einstellungen > Module.
    • Stellen Sie sicher, dass PulseChat Aktiv ist.

  2. Mitarbeiterberechtigungen?

    • Ihre Rolle muss die view-F\u00e4higkeit f\u00fcr PulseChat haben.
    • Pr\u00fcfen Sie Einstellungen > Mitarbeiter > Rollen und best\u00e4tigen Sie:
      • view unter PulseChat ist f\u00fcr Ihre Rolle aktiviert.

  3. PulseChat-Option aktiviert?

    • In den PulseChat-Einstellungen stellen Sie sicher, dass:
      • pulsechat_enabled auf Yes gesetzt ist.

2. Transportprobleme (Nachrichten langsam oder nicht in Echtzeit)​

Symptome:

  • Nachrichten erscheinen nur nach Seitenaktualisierung oder mit Verz\u00f6gerungen.
  • Tipp-Indikatoren / Lesebest\u00e4tigungen sind inkonsistent.

Pr\u00fcfungen:

  1. Schauen Sie auf die Transportleiste oben im Chat:

    • "Pusher WebSockets -- sofortige Zustellung" (blau) oder
    • "Integriertes Polling -- Nachrichten aktualisieren sich alle ~3s" (gr\u00fcn).

  2. Bei Verwendung von Pusher:

    • Best\u00e4tigen Sie die Pusher-Zugangsdaten (App ID/Key/Secret/Cluster) in den Perfex-Einstellungen.
    • Stellen Sie sicher, dass die Firewall pusher.com nicht blockiert.
    • Pr\u00fcfen Sie das Pusher-Dashboard auf Fehler oder Verbindungslimits.

  3. Bei Verwendung von Polling:

    • Eine gewisse Verz\u00f6gerung (einige Sekunden) ist normal; dies ist das erwartete Verhalten.

  4. Um den Transport zu wechseln:

    • Gehen Sie zu PulseChat-Einstellungen > Echtzeit-Transport.
    • W\u00e4hlen Sie pusher, polling oder auto.
    • Speichern Sie und laden Sie die Chat-Seite neu.

3. Dateien werden nicht hochgeladen​

Symptome:

  • Upload schl\u00e4gt stillschweigend fehl oder mit einem Fehler.

Pr\u00fcfungen:

  1. Erlaubte Dateitypen

    • Stellen Sie sicher, dass die Erweiterung in pulsechat_allowed_file_types erlaubt ist.

  2. Maximale Gr\u00f6\u00dfe

    • Die Dateigr\u00f6\u00dfe muss innerhalb des pulsechat_max_file_size_mb-Limits liegen.

  3. Berechtigungen

    • \u00dcberpr\u00fcfen Sie, ob modules/pulsechat/uploads/ beschreibbar ist.

  4. Fehlerprotokolle

    • Pr\u00fcfen Sie Perfex-Protokolle und Server-Fehlerprotokolle auf Upload-bezogene Meldungen.

4. Kunden k\u00f6nnen den Chat nicht sehen oder nutzen​

Symptome:

  • Mitarbeiter k\u00f6nnen PulseChat nutzen; Kunden sehen kein Chat-Widget.

Pr\u00fcfungen:

  1. Kunden-Chat aktiviert?

    • Stellen Sie sicher, dass pulsechat_clients_enabled in den Einstellungen auf Yes gesetzt ist.

  2. Kundenportal-Hooks

    • PulseChat injiziert ein Widget in das Kundenportal \u00fcber init_chat.php.
    • Stellen Sie sicher, dass keine \u00dcberschreibungen oder Template-Anpassungen dies entfernen.

  3. Berechtigungen

    • Nur eingeloggte Kontakte k\u00f6nnen den Kunden-Chat nutzen; anonyme Besucher werden ihn nicht sehen.

5. Omnichannel-Nachrichten kommen nicht an​

Symptome:

  • WhatsApp/Telegram/E-Mail-Nachrichten erscheinen nicht in den Kan\u00e4len.

Pr\u00fcfungen:

  1. Omnichannel aktiviert?

    • pulsechat_channels_enabled = Yes.

  2. Kanalkonfiguration

    • F\u00fcr jeden Kanaltyp:
      • WhatsApp: Token, Telefon-ID, Webhook-URL bei Meta konfiguriert.
      • Telegram: Bot-Token und Webhook-URL \u00fcber BotFather konfiguriert.
      • E-Mail: IMAP-Einstellungen korrekt, SSL/Ports korrekt, Zugangsdaten g\u00fcltig.

  3. Webhooks

    • Best\u00e4tigen Sie, dass die Anbieter-Webhooks auf Ihren ChannelWebhook/webhook.php-Endpoint zeigen.
    • Pr\u00fcfen Sie Protokolle auf fehlgeschlagene Signaturverifizierungen.

  4. E-Mail-Polling

    • Stellen Sie sicher, dass der Perfex-Cron l\u00e4uft.
    • pulsechat_cron_email_poll wird ohne after_cron_run nicht ausgef\u00fchrt.

6. KI-Schaltfl\u00e4chen funktionieren nicht​

Symptome:

  • Die KI-Werkzeugleiste ist sichtbar, aber:
    • Klicken auf Entwurf/Vorschlagen/Umschreiben/\u00dcbersetzen bewirkt nichts, oder
    • Toasts zeigen "AI not configured" oder HTTP-Fehler.

Pr\u00fcfungen:

  1. Einstellungen

    • pulsechat_ai_enabled = Yes.
    • Anbieter ausgew\u00e4hlt (openai oder anthropic).
    • Korrekter API-Schl\u00fcssel f\u00fcr den gew\u00e4hlten Anbieter eingegeben.
    • KI-Funktionsschalter (Auto-Antwort, Vorschl\u00e4ge, Umschreibung, \u00dcbersetzung, Stimmung) wie gew\u00fcnscht aktiviert.

  2. Netzwerk

    • Stellen Sie sicher, dass Ihr Server erreichen kann:
      • https://api.openai.com
      • https://api.anthropic.com
    • Pr\u00fcfen Sie auf Firewall-/Proxy-Blockierungen oder DNS-Probleme.

  3. Fehlertext

    • Viele Fehler geben zur\u00fcck:
      • "OpenAI API key not configured."
      • "Text is required."
      • HTTP-Status mit Anbieter-Fehlermeldung.

  4. KI-Protokolle

    • Schauen Sie in pc_ai_logs f\u00fcr mehr Details:
      • action_type, model, error (falls erfasst), Token-Z\u00e4hler.

7. Datenbankfehler (Undefinierte Konstanten)​

Symptome:

  • Fehler wie "Undefined constant TABLE_PC_MESSAGES".

Pr\u00fcfungen:

  1. Stellen Sie sicher, dass der neueste PulseChat-Code bereitgestellt ist:
    • pulsechat.php definiert die TABLE_PC_*-Konstanten.
  2. Fallbacks in Pulsechat_model:
    • Das Modell definiert Kerntabellenkonstanten, falls sie noch nicht definiert sind.
  3. Wenn Sie das immer noch sehen:
    • Best\u00e4tigen Sie, dass es keine doppelten/alten Kopien des Moduls in anderen Pfaden gibt.

8. Immer noch nicht weiter?​

Wenn Sie das Obige versucht haben und das Problem immer noch nicht l\u00f6sen k\u00f6nnen:

  1. Sammeln Sie:
    • Genaue Fehlermeldungen.
    • Relevante Protokolle (PHP-Fehlerprotokolle, Perfex-Protokolle).
    • Screenshots der relevanten Einstellungsbildschirme.
  2. Kontaktieren Sie den Support mit:
    • Ihrer Perfex-Version.
    • PulseChat-Version.
    • Jegliche Anpassungen, die Sie vorgenommen haben (\u00fcberschriebene Views, ge\u00e4nderter Code, etc.).

Diese Informationen machen die Diagnose und Behebung des Problems wesentlich schneller.