Site Widget'ı

Bu kılavuz, sohbet widget'ını web sitenize eklemeyi, görünümünü yönetmeyi ve widget'ın hangi veriyi nasıl topladığını anlatır.

Siteye Ekleme

Yönetim Paneli → Entegrasyonlar → Web sekmesini açın.
Hazır <script> kodunu kopyalayın.
Sitenizde, sayfanın </body> kapanış etiketinden hemen önce yapıştırın.

Hepsi bu — widget sayfanın sağ alt köşesinde belirir. Kod tüm sayfalara eklenebilir; paket boyutu 60 KB'ın (gzip) altındadır ve sayfa yüklemesini bloke etmez.

iframe ile gömme senaryoları için Entegrasyonlar → Gömülü (Embedded) sekmesindeki varyantı kullanın.

Görünümü Yönetme

Widget görünümü koddan değil, panelden yönetilir: Bot Görünümü ekranındaki her değişiklik (renkler, bot adı, karşılama mesajı, logo, önerilen sorular) otomatik kaydedilir ve canlıdaki widget'lara kod değişikliği olmadan yansır.

Bunu sağlayan mekanizma: widget açılırken yapılandırmasını herkese açık GET /api/widget-config?token=<site-token> ucundan çeker. Yanıt 60 saniye önbelleklenir; panelde yaptığınız değişiklik en geç bir dakika içinde tüm ziyaretçilere ulaşır.

Davranış

Karşılama — widget açıldığında karşılama mesajı ve (tanımladıysanız) önerilen sorular gösterilir; ziyaretçi bir soruya tıklayarak sohbete başlayabilir.
Bot yanıtları düz metindir; bağlantılar tıklanabilir hale getirilir.
İnsan devri — bot çözemediği konuşmayı insan temsilciye aktarır; ziyaretçi aynı pencerede temsilciyle devam eder.
Çevrimdışılık — bağlantı koptuğunda widget durumu gösterir ve bağlantı gelince kaldığı yerden sürer.
Konuşma, sekme kapansa bile aynı tarayıcıda kaldığı yerden devam eder.

Kampanya Takibi (Attribution)

Widget, bir konuşma ilk açıldığında pazarlama atıflarını yakalar ve konuşmaya iliştirir; bu veriler panelde ve (kurduysanız) CRM/lead akışında görünür:

utm_source, utm_medium, utm_campaign parametreleri
Ziyaretçinin geldiği sayfa (referrer) ve konuşmayı başlattığı sayfa (landing page)

İlk temas (first-touch) mantığı uygulanır: ziyaretçi kampanya bağlantısıyla girip konuşmayı başka bir sayfada başlatsa bile ilk girişteki kampanya bilgisi korunur (sekme ömrü boyunca).

Gizlilik

Çerez ve parmak izi kullanılmaz. Yalnızca sayfa-URL düzeyinde veri toplanır.
Sayfa adresleri sorgu dizisi olmadan (yalnızca alan adı + yol) kaydedilir — URL'lerde taşınabilecek oturum token'ı, e-posta gibi parametreler hiç toplanmaz.
Panel önizlemesindeki widget hiçbir attribution toplamaz — önizleme trafiği gerçek ziyaretçi verisi sayılmaz.
Tüm değerler uzunluk sınırıyla kırpılır.

Sorun Giderme

Belirti	Kontrol
Widget görünmüyor	Snippet `</body>` öncesinde mi? Tarayıcı konsolunda hata var mı?
Widget açılıyor ama bot yanıt vermiyor	Ayarlar → Model'de API anahtarı girili ve Test Et başarılı mı?
Renk değişikliği yansımadı	60 sn önbelleği bekleyin; sayfayı yenileyin.
Mesaj Chatwoot'a düşmüyor	Panel → Webhook Olayları ekranından olay akışını inceleyin.