🌐 Web-Chat-Widget

Das Web-Chat-Widget ist eine einbettbare JavaScript-Chat-Blase, die jeder Website hinzugefügt werden kann. Wenn Besucher eine Nachricht über das Widget senden, erscheint sie in PulseHubs Posteingang wie jeder andere Kanal.

---

Widget zu Ihrer Website hinzufügen

1. Web-Chat-Kanal in PulseHub hinzufügen

1. Gehen Sie zu Kanäle → Kanal hinzufügen
2. Wählen Sie Web-Chat-Widget
3. Geben Sie einen Namen und optionale Begrüßung/Farbe ein
4. Klicken Sie auf Kanal speichern
5. Notieren Sie die Kanal-ID von der Karte

2. Script einbetten

<script
  src="https://ihredomain.com/public/js/webchat-widget.js"
  data-channel="IHRE_KANAL_ID"
  data-greeting="Hallo! Wie können wir Ihnen helfen?"
  data-color="#10b981">
</script>

---

Widget-Konfigurationsoptionen

Attribut	Standard	Beschreibung
data-channel	erforderlich	Die Kanal-UUID von PulseHub
data-greeting	Hi! How can we help you?	Nachricht beim ersten Öffnen des Chats
data-color	#10b981	Hex-Farbe für den Button und gesendete Nachrichten

---

Wie Sessions funktionieren

Das Widget speichert zwei Werte in localStorage:

• ph_contact_{channel_id} — die UUID des Kontakts
• ph_conv_{channel_id} — die UUID der Konversation

Das bedeutet, Besucher, die den Tab schließen und zurückkehren, setzen dieselbe Konversation fort.

---

Cross-Origin-Anfragen

Wenn PulseHub auf einer anderen Domain als Ihre Website ist, fügen Sie CORS-Header hinzu:

<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "https://ihrewebsite.com"
    Header set Access-Control-Allow-Methods "GET, POST, PATCH, DELETE, OPTIONS"
    Header set Access-Control-Allow-Headers "Content-Type, X-Webchat-Channel"
</IfModule>

---

Sicherheitshinweis

Die Web-Chat-API-Endpoints akzeptieren Anfragen von nicht authentifizierten Benutzern, wenn der Header X-Webchat-Channel vorhanden ist. Stellen Sie Rate-Limiting auf Webserver- oder Firewall-Ebene sicher.