Zum Hauptinhalt springen

Administrator-Konfiguration

Diese Seite erkl\u00e4rt, wie Sie PulseChat als Administrator konfigurieren: Transport, Berechtigungen, Limits, Omnichannel-Kan\u00e4le, KI und weitere Optionen in views/admin/settings.php.

Alle untenstehenden Optionen finden Sie unter Einstellungen -> Module -> PulseChat -> Einstellungen (welches admin/pulsechat/settings \u00f6ffnet).

1. Allgemein​

Diese Optionen steuern das globale Modulverhalten.

  • PulseChat aktivieren

    • Option: pulsechat_enabled
    • Bei Ja ist PulseChat aktiv und der Chat-Men\u00fceintrag erscheint f\u00fcr Mitarbeiter mit Berechtigung.

  • Kunden-Chat aktivieren

    • Option: pulsechat_clients_enabled
    • Bei Ja wird ein Chat-Widget in das Kundenportal eingebettet, das Gespr\u00e4che zwischen Mitarbeitern und Kunden erm\u00f6glicht.

  • Standard-Benutzerstatus bei Anmeldung

    • Option: pulsechat_default_status
    • Werte: online, away, busy, offline
    • Bestimmt den anf\u00e4nglichen Pr\u00e4senzstatus, wenn Mitarbeiter den Administrationsbereich \u00f6ffnen.

2. Benachrichtigungen​

  • Desktop-Benachrichtigungen

    • Option: pulsechat_desktop_notifications
    • Aktiviert Browser-Desktop-Benachrichtigungen f\u00fcr neue Nachrichten (Mitarbeiter m\u00fcssen Benachrichtigungen im Browser erlauben).

  • Ton-Benachrichtigungen

    • Option: pulsechat_sound_notifications
    • Spielt einen Ton ab (assets/audio/notification.mp3), wenn neue Nachrichten eintreffen.

  • Toast-Benachrichtigungen

    • Option: pulsechat_toast_notifications
    • Zeigt kleine Popup-Benachrichtigungen in der Admin-Oberfl\u00e4che f\u00fcr wichtige Ereignisse an.

3. Berechtigungen & Zugriff​

Diese Optionen und Mitarbeiterf\u00e4higkeiten steuern, wer was verwenden kann.

3.1 Mitarbeiterf\u00e4higkeiten (rollenbasiert)​

Definiert in pulsechat.php \u00fcber pulsechat_register_permissions():

  • view --- kann die PulseChat-Oberfl\u00e4che sehen.
  • send --- kann Nachrichten senden.
  • delete --- kann Nachrichten l\u00f6schen (vorbehaltlich zus\u00e4tzlicher Einstellungen).
  • create_groups --- kann Gruppenkonversationen erstellen.
  • manage_channels --- kann Omnichannel-Verbindungen konfigurieren.
  • manage_automation --- kann Automatisierungsregeln verwalten.
  • view_analytics --- kann Analysen und Berichte einsehen.
  • use_ai --- kann auf KI-Tools zugreifen (Entwurf, Vorschl\u00e4ge, Umschreibung, \u00dcbersetzung, etc.).
  • assign --- kann Konversationen zuweisen / neu zuweisen.
  • view_all_channels --- kann alle Omnichannel-Konversationen sehen, nicht nur zugewiesene/eigene.

Weisen Sie diese F\u00e4higkeiten den Rollen zu unter Einstellungen -> Mitarbeiter -> Rollen.

3.2 Berechtigungen im Einstellungs-Tab​

  • Mitarbeitern erlauben, Nachrichten zu l\u00f6schen

    • Option: pulsechat_staff_can_delete

  • Mitarbeitern erlauben, Gruppen zu erstellen

    • Option: pulsechat_staff_can_create_groups

  • Gruppen verlassen erlauben

    • Option: pulsechat_allow_leave_groups
    • Bei Nein k\u00f6nnen nur Administratoren Mitglieder entfernen oder Gruppen aufl\u00f6sen.

  • Neue Mitglieder sehen Verlauf

    • Option: pulsechat_new_members_see_history
    • Bei Ja sehen neu hinzugef\u00fcgte Mitglieder den vollst\u00e4ndigen Gruppenverlauf.
    • Bei Nein sehen sie nur Nachrichten, die nach ihrem Beitritt gesendet wurden.

  • Nur berechtigte Benutzer

    • Option: pulsechat_only_permitted_users
    • Bei Ja erscheinen nur Mitarbeiter mit der view-F\u00e4higkeit (oder Administratoren) in den Mitarbeiterlisten und k\u00f6nnen PulseChat verwenden.

4. Funktionen​

Optionale Funktionalit\u00e4t ein-/ausschalten:

  • Dateifreigabe

    • pulsechat_allow_file_sharing
    • Aktiviert das Hochladen von Anh\u00e4ngen \u00fcber die B\u00fcroklammer-Schaltfl\u00e4che.

  • Audionachrichten

    • pulsechat_allow_audio_messages
    • Aktiviert die Aufnahme und das Senden von Sprachnachrichten.

  • Reaktionen

    • pulsechat_allow_reactions
    • Aktiviert Emoji-Reaktionen auf Nachrichten.

  • Weiterleitung

    • pulsechat_allow_message_forwarding

  • Anheften

    • pulsechat_allow_message_pinning

  • Ticket-Konvertierung

    • pulsechat_allow_ticket_conversion
    • Aktiviert die Schaltfl\u00e4che "In Ticket umwandeln" im Chat-Header.

  • Tipp-Indikatoren

    • pulsechat_show_typing_indicators

  • Lesebest\u00e4tigungen

    • pulsechat_show_read_receipts

  • Online-Status

    • pulsechat_show_online_status

5. Limits & Datenverwaltung​

5.1 Limits​

  • Maximale Dateigr\u00f6\u00dfe

    • pulsechat_max_file_size_mb
    • Maximale Upload-Gr\u00f6\u00dfe f\u00fcr Anh\u00e4nge (in MB).

  • Nachrichtenbearbeitungsfenster

    • pulsechat_edit_window_minutes
    • Wie lange nach dem Senden eine Nachricht bearbeitet werden kann (0 = nie erlaubt).

  • Maximale Gruppenmitglieder

    • pulsechat_max_group_members

  • Erlaubte Dateitypen

    • pulsechat_allowed_file_types
    • Kommagetrennte Liste von Erweiterungen (z.B. .jpg,.png,.pdf,.docx).

5.2 Datenaufbewahrung​

In derselben Einstellungsseite definiert:

  • Automatische Bereinigung nach (Monaten)
    • pulsechat_auto_purge_months
    • 0 = nie bereinigen.
    • Andernfalls k\u00f6nnen Nachrichten, die \u00e4lter als die angegebene Anzahl von Monaten sind, durch die Bereinigungslogik gel\u00f6scht werden.

6. Darstellung​

PulseChat \u00fcbernimmt Perfex-Stile und f\u00fcgt eigene hinzu.

Wichtige Optionen:

  • Markenfarbe

    • pulsechat_brand_color
    • Wird f\u00fcr prim\u00e4re Akzente in der Chat-Oberfl\u00e4che verwendet.

  • Chat-Hintergrund

    • pulsechat_chat_bg
    • W\u00e4hlen Sie aus vordefinierten Hintergr\u00fcnden/Themes.

Es gibt auch Einstellungen auf Benutzerebene (Dunkel-/Hell-Theme), die pro Mitarbeiter gespeichert und \u00fcber data-theme-Attribute in chat_view.php angewendet werden.

7. Transport (Echtzeit)​

PulseChat unterst\u00fctzt:

  • Integriertes Polling --- Periodische AJAX-Aufrufe zum Abrufen neuer Nachrichten (keine externen Dienste).
  • Pusher WebSockets --- Echtzeit-Zustellung \u00fcber Pusher Channels.
  • Auto --- Verwendet Pusher wenn korrekt konfiguriert; ansonsten F\u00e4llt auf Polling zur\u00fcck.

Relevante Einstellungen im Abschnitt "Echtzeit-Transport":

  • pulsechat_transport --- auto, pusher oder polling
  • Zus\u00e4tzliche Pusher-Einstellungen aus den Perfex-Kerneinstellungen (App ID, Key, Secret, Cluster).

Sie k\u00f6nnen diese jederzeit in den PulseChat-Einstellungen \u00e4ndern; die Oberfl\u00e4che zeigt den aktiven Modus \u00fcber die Transportleiste oben im Chat an.

8. Omnichannel-Kan\u00e4le​

Um den Omnichannel-Posteingang zu aktivieren:

  • Aktivieren Sie Omnichannel-Kan\u00e4le aktivieren
    • Option: pulsechat_channels_enabled
    • Bei Ja erscheint ein Kan\u00e4le-Tab in der linken Seitenleiste und das Omnichannel-Backend ist aktiv.

Jeder Kanal (WhatsApp, Telegram, E-Mail, etc.) wird in der Kan\u00e4le-Oberfl\u00e4che (Zahnradsymbol im Kan\u00e4le-Tab) konfiguriert und in pc_channels als verschl\u00fcsseltes JSON gespeichert.

Siehe Omnichannel & Kan\u00e4le f\u00fcr kanalspezifische Details.

9. KI-Assistent​

PulseChat kann OpenAI (ChatGPT) oder Anthropic (Claude) verwenden f\u00fcr:

  • Antwortentw\u00fcrfe
  • Intelligente Vorschl\u00e4ge (Chips)
  • Nachrichtenumschreibung
  • Rechtschreibung/Grammatik
  • Zusammenfassungen
  • \u00dcbersetzung
  • Stimmungsanalyse

Im Abschnitt KI-Assistent --- Multi-Anbieter finden Sie:

  • KI-Funktionen aktivieren

    • pulsechat_ai_enabled

  • KI-Anbieter

    • pulsechat_ai_provider --- openai oder anthropic

  • OpenAI API-Schl\u00fcssel

    • pulsechat_ai_api_key

  • Anthropic API-Schl\u00fcssel

    • pulsechat_ai_anthropic_api_key

  • KI-Modell

    • pulsechat_ai_model --- Optionen umfassen:
      • OpenAI: gpt-4o, gpt-4o-mini, gpt-3.5-turbo
      • Anthropic: claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, claude-3-opus-20240229

  • System-Prompt

    • pulsechat_ai_system_prompt
    • Globale Anweisung, die von allen KI-Aufrufen verwendet wird (z.B. "Sie sind ein hilfreicher Kundensupport-Assistent...").

  • Temperatur

    • pulsechat_ai_temperature

  • Maximale Token

    • pulsechat_ai_max_tokens

  • Funktionsschalter

    • pulsechat_ai_auto_reply --- zeigt die Entwurf-Schaltfl\u00e4che (KI-Antwortentwurf).
    • pulsechat_ai_suggestions --- zeigt Vorschlagschips.
    • pulsechat_ai_rewrite --- aktiviert die Umschreibungsschaltfl\u00e4che.
    • pulsechat_ai_translate --- aktiviert die \u00dcbersetzungsschaltfl\u00e4che.
    • pulsechat_ai_sentiment --- Stimmungsanalyse-Helfer.

Siehe KI-Assistent f\u00fcr Details zur Darstellung in der Oberfl\u00e4che und zum Verhalten in Konversationen.

10. Lizenzierung​

Die Lizenzierung von PulseChat wird konfiguriert \u00fcber:

  • pulsechat_verification_id
  • pulsechat_product_token
  • pulsechat_last_verification
  • pulsechat_heartbeat

Diese werden automatisch verwaltet durch den Lizenzierungsablauf und sollten nicht manuell bearbeitet werden. Um die Lizenz zu \u00e4ndern:

  • Deaktivieren Sie PulseChat unter Einstellungen -> Module.
  • Aktivieren Sie es erneut; der Aktivierungsbildschirm erscheint wieder und erm\u00f6glicht die Eingabe eines neuen Kaufschl\u00fcssels.