WebBlocks Live Chat

Führen Sie selbst gehostete Supportgespräche zwischen Websitebesuchern und CMS-Operatoren. Besucher öffnen ein Chat-Widget auf Ihrer Website; Operatoren lesen und beantworten Nachrichten unter Live Chat im CMS-Panel. Ein externes Chatkonto oder ein WebSocket-Dienst ist nicht erforderlich. Diese Anleitung beschreibt Live Chat 0.7.1.

Verwenden Sie PHP ab 8.4 und WebBlocks CMS ^1.95.1, das die erforderliche WebBlocks-UI-Laufzeit bereitstellt. Laden Sie die passende ZIP-Datei von der Live-Chat-Katalogseite herunter. Installieren und aktivieren Sie sie unter System → Plugins und prüfen Sie die erfolgreiche Datenbankeinrichtung. Ältere Hostanwendungen können eine Plugin-Gesundheitswarnung melden; aktualisieren Sie den Host vor Verwendung dieser Version.

Öffnen Sie Live Chat → Einstellungen und wählen Sie die Website. Allgemeine Einstellungen steuern Widget-Aktivierung, Online-/Offline-Verfügbarkeit, linke/rechte Position, die E-Mail-Pflicht im Offline-Modus und optionale Operator-E-Mails. Die Verfügbarkeit wird manuell gewählt und erkennt nicht, ob ein Operator anwesend ist.

Sprachtexte haben ein eigenes Formular. Legen Sie Titel, Begrüßung, Offline-Nachricht und Beschriftung der Startschaltfläche je aktivierter Website-Sprache fest. Allgemeine Einstellungen zu speichern erhält die Sprachtexte; Sprachtexte zu speichern erhält die allgemeinen Einstellungen. Fehlende Texte fallen zunächst auf die Standardsprache und dann auf bestehende ältere Texte zurück.

Das aktivierte Widget öffnet sich erst beim Klick auf seine Startschaltfläche. Besucher geben einen Namen und optional eine E-Mail-Adresse an; für neue Offline-Gespräche können Sie die Adresse verlangen. Beim Schließen bleibt ein ungesendeter Entwurf erhalten. Nach dem Schließen eines Gesprächs führt Neues Gespräch starten zurück zur Aufnahme. Nachrichten und Operatorantworten werden durch regelmäßige Abfragen im Widget zugestellt.

Operatoren benötigen Live-Chat anzeigen zum Lesen, Live-Chat beantworten zum Antworten oder Schließen und Live-Chat verwalten zur Widget-Konfiguration. Die gewählte Website begrenzt die Gesprächsliste und verfügbaren Aktionen.

Verwenden Sie die Ansichten offen, Antwort ausstehend, ungelesen und geschlossen. Die Suche erfasst Besuchernamen, E-Mail-Adressen und Nachrichtenverlauf. In der offenen Standardansicht stehen antwortbedürftige Gespräche zuerst; alternativ lassen sich neueste oder älteste Gespräche zuerst anzeigen. Ungelesen und Antwort ausstehend sind verschiedene Zustände: Eine Nachricht zu lesen beantwortet sie nicht.

Posteingang und Gespräch aktualisieren sich im sichtbaren Zustand alle fünf Sekunden. Das Lesen am Ende eines sichtbaren Gesprächs markiert Besuchernachrichten als gelesen. Beim Zurückscrollen bleibt Ihre Position trotz neuer Nachrichten bestehen; Neue Nachrichten führt zur neuesten Nachricht. Antworten Sie, schließen Sie erledigte Gespräche oder öffnen Sie sie bei weiterem Hilfebedarf erneut. Erneutes Öffnen erlaubt Besuchern wieder zu antworten.

Berechtigte Operatoren erhalten außerdem Ungelesen-Markierungen in der Seitenleiste und Hinweise im Panel für neue Besuchernachrichten. Diese Hinweise markieren Gespräche nicht als gelesen und senden keine Betriebssystembenachrichtigungen.

Offline-Benachrichtigungen an Operatoren sind optional. Konfigurieren Sie einen Empfänger und aktivieren Sie sie nur bei Bedarf. Antwort-E-Mails an Besucher sind deaktiviert; Operatorantworten werden über das Chat-Widget zugestellt.

Inhalt und Häufigkeit erben die Benachrichtigungsrichtlinie der CMS-Website. Je nach Richtlinie erfolgt der Versand sofort, gebündelt oder in einer Tageszusammenfassung. Reine Warnmeldungen enthalten weder Besuchernamen, Adressen, Nachrichtentexte noch private Gesprächstoken. Tageszusammenfassungen enthalten immer nur minimale Angaben.

Gebündelte/tägliche Zustellung und tägliche Erinnerungen setzen einen minütlich ausgeführten Laravel-Scheduler des Hosts voraus. Prüfen Sie die aufgezeichnete Scheduler-Gesundheit, wenn E-Mails ausstehen. Ausschließlich sofortige Benachrichtigungen ohne tägliche Erinnerungen benötigen keinen geplanten Versand. Der Versand verwendet die CMS-Mailkonfiguration; erfolgreiche Übergabe an den Mailtransport beweist keine Zustellung im Posteingang.

Das aktivierte Plugin meldet seine Routen über CMS-API-Discovery und OpenAPI. Verwenden Sie GET /webadmin/api/plugins/webblocks-live-chat/settings?site_id=1 mit live-chat.read. PATCH oder PUT auf derselben Route benötigt live-chat.settings.write und eine explizite site_id.

Schreibzugriffe ändern nur mitgesendete Felder und führen Sprachwerte mit bestehenden Texten zusammen. Nur aktivierte Website-Sprachen werden akzeptiert. Websitebeschränkungen des Tokens und aktuell delegierte Zugriffe gelten weiterhin. Ermitteln Sie die unterstützte Token-Berechtigungsrichtlinie am installierten CMS; die Aktivierung des Plugins gewährt nicht automatisch Zugriff.

Fehlt die Startschaltfläche, prüfen Sie Plugin-Aktivierung, Websiteauswahl, Widget-Aktivierung und Hostkompatibilität. Der Offline-Modus ändert Aufnahmetexte; die Widget-Aktivierung ist eine separate Einstellung. Bleiben Antworten aus, prüfen Sie, ob das Gespräch geschlossen wurde. Bei ausstehenden E-Mails prüfen Sie Empfänger, CMS-Mailkonfiguration, geerbte Richtlinie und Scheduler-Gesundheit.

Kehren Sie zur Plugin-Übersicht zurück, prüfen Sie die Katalogversion oder verwenden Sie die Internal-Content-API-Referenz.