🌐 Web Sohbet Widget'ı

Web Sohbet Widget'ı, herhangi bir web sitesine eklenebilen gömülebilir bir JavaScript sohbet baloncuğudur. Ziyaretçiler widget aracılığıyla mesaj gönderdiğinde, diğer kanallar gibi PulseHub'ın gelen kutusunda görünür.

---

Widget'ı Web Sitenize Ekleme

1. PulseHub'da Web Sohbet Kanalı Ekleme

1. Channels → Add Channel bölümüne gidin
2. Web Chat Widget seçin
3. Bir ad ve isteğe bağlı karşılama mesajı/renk girin
4. Save Channel düğmesine tıklayın
5. Karttaki Channel ID'yi not edin

2. Script'i Gömme

<script
  src="https://yourdomain.com/public/js/webchat-widget.js"
  data-channel="YOUR_CHANNEL_ID"
  data-greeting="Hi! How can we help you today?"
  data-color="#10b981">
</script>

---

Widget Yapılandırma Seçenekleri

Özellik	Varsayılan	Açıklama
data-channel	zorunlu	PulseHub'daki kanal UUID'si
data-greeting	Hi! How can we help you?	Sohbet ilk açıldığında gösterilen mesaj
data-color	#10b981	Düğme ve gönderilen mesajlar için hex renk kodu

---

Oturumlar Nasıl Çalışır

Widget localStorage içinde iki değer saklar:

• ph_contact_{channel_id} — kişinin UUID'si
• ph_conv_{channel_id} — konuşmanın UUID'si

Bu, sekmeyi kapatıp geri dönen ziyaretçilerin aynı konuşmaya devam ettiği anlamına gelir.

---

Cross-Origin İstekleri

PulseHub web sitenizden farklı bir alan adındaysa, CORS başlıkları ekleyin:

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

---

Güvenlik Notu

Web Sohbet API uç noktaları, X-Webchat-Channel başlığı mevcut olduğunda kimliği doğrulanmamış kullanıcılardan gelen istekleri kabul eder. Web sunucusu veya güvenlik duvarı düzeyinde hız sınırlaması sağlayın.