Web Widget

Web sitenize canlı destek widget'ı ekleyerek ziyaretçilerinizle iletişim kurun.

Genel Bakış

Web Widget özellikleri:

• Canlı sohbet
• AI destekli yanıtlar
• Dosya paylaşımı
• Çoklu dil desteği
• Mobil uyumlu tasarım
• Özelleştirilebilir görünüm

Kurulum

1. Widget Kodu Alma

1. Ayarlar > Kanallar > Widget'a gidin
2. Widget ayarlarını yapılandırın
3. Kodu Kopyala butonuna tıklayın

2. Web Sitesine Ekleme

Kodu sitenizin </body> etiketinden önce ekleyin:

<script>
  (function(d, w) {
    var s = d.createElement('script');
    s.src = 'https://widget.dolu.ai/loader.js';
    s.async = true;
    s.dataset.widgetId = 'YOUR_WIDGET_ID';
    d.body.appendChild(s);
  })(document, window);
</script>

3. Doğrulama

Web sitenizi ziyaret ederek widget'ın göründüğünü doğrulayın.

Özelleştirme

Renkler

• Ana renk
• Arka plan rengi
• Metin rengi
• Buton rengi

Konum

Widget konumunu seçin:

• Sağ alt (varsayılan)
• Sol alt
• Sağ üst
• Sol üst

Boyut

• Küçük (320px)
• Orta (380px)
• Büyük (420px)

Dil

Widget dilini belirleyin:

• Türkçe
• İngilizce
• Arapça
• Otomatik (tarayıcı diline göre)

Widget Özellikleri

Karşılama Mesajı

Sayfa açıldığında gösterilecek mesaj:

Merhaba! Size nasıl yardımcı olabiliriz?

Pre-chat Formu

Sohbet öncesi bilgi toplama:

• Ad Soyad
• E-posta
• Telefon
• Konu

Çevrimdışı Formu

Çalışma saatleri dışında form:

• Mesaj bırakma
• Geri arama talebi
• E-posta ile iletişim

AI Entegrasyonu

Widget'ta AI Agent aktif olabilir:

AI Yanıtları

• Otomatik karşılama
• SSS yanıtları
• Ürün bilgileri
• Yönlendirme

İnsan Aktarımı

AI yanıtlayamazsa:

• "Temsilci ile görüşme" butonu
• Otomatik aktarım
• Bildirim gönderme

Proaktif Mesajlar

Ziyaretçilere otomatik mesaj gönderin:

Tetikleyiciler

• Sayfa açıldığında (X saniye sonra)
• Belirli sayfada
• Çıkış niyetinde
• Scroll yüzdesi

Örnek Senaryolar

// 30 saniye sonra mesaj göster
{
  trigger: 'time',
  delay: 30000,
  message: 'Yardıma mı ihtiyacınız var?'
}

// Fiyat sayfasında
{
  trigger: 'page',
  url: '/pricing',
  message: 'Fiyatlar hakkında soru sormak ister misiniz?'
}

Ziyaretçi Takibi

Widget üzerinden ziyaretçi bilgileri:

• Bulunduğu sayfa
• Ziyaret süresi
• Tarayıcı bilgisi
• Konum (IP bazlı)
• Referans kaynak

Mobil Uyumluluk

Widget mobil cihazlarda:

• Tam ekran mod
• Touch-friendly butonlar
• Mobil klavye desteği
• Responsive tasarım

Gelişmiş Ayarlar

JavaScript API

Widget'ı programatik olarak kontrol edin:

// Widget'ı aç
DoluWidget.open();

// Widget'ı kapat
DoluWidget.close();

// Mesaj gönder
DoluWidget.sendMessage('Merhaba!');

// Ziyaretçi bilgisi set et
DoluWidget.setVisitor({
  name: 'Ahmet',
  email: '[email protected]'
});

// Olay dinle
DoluWidget.on('message', function(msg) {
  console.log('Yeni mesaj:', msg);
});

Özel Olaylar

Widget olaylarını takip edin:

• widget:open - Widget açıldı
• widget:close - Widget kapandı
• message:sent - Mesaj gönderildi
• message:received - Mesaj alındı
• conversation:started - Konuşma başladı

Performans

Widget performans ipuçları:

• Asenkron yükleme
• Lazy loading
• Minimum bundle boyutu
• CDN kullanımı

Sorun Giderme

Widget Görünmüyor

• Kodun doğru yere eklendiğini kontrol edin
• JavaScript hatalarını kontrol edin
• Widget ID'sinin doğru olduğundan emin olun

Mesajlar İletilmiyor

• İnternet bağlantısını kontrol edin
• Firewall ayarlarını kontrol edin
• Konsol hatalarını inceleyin

Stil Çakışması

• CSS specificity sorunlarını kontrol edin
• Widget'a özel container kullanın
• !important ile geçersiz kılın

En İyi Uygulamalar

1. Hızlı yüklenme: Widget performansı önemlidir
2. Doğru konum: Müşterinin kolay erişebileceği yer
3. Markaya uygun: Renkleri sitenize uyumlu yapın
4. Proaktif mesajlar: Ama spam yapmayın
5. Mobil test: Tüm cihazlarda test edin

SSS

S: Widget sitenin yüklenme hızını etkiler mi? C: Widget asenkron yüklenir, yani sitenizin ana içeriğinin yüklenmesini engellemez. Performans etkisi minimumdur.

S: Widget'ı belirli sayfalarda gizleyebilir miyim? C: Evet, JavaScript API ile belirli sayfalarda widget'ı gizleyebilirsiniz. Alternatif olarak widget kodunu sadece istediğiniz sayfalara ekleyin.

S: Widget'ta dosya paylaşımı destekleniyor mu? C: Evet, ziyaretçiler resim, PDF ve diğer dosya türlerini paylaşabilir. Dosya boyutu limiti 25 MB'dır.

S: Widget kaç dili destekliyor? C: Widget Türkçe, İngilizce, Arapça dahil 14 dili destekler. Otomatik dil algılama ile ziyaretçinin tarayıcı diline göre gösterim yapılır.

S: Çevrimdışıyken gelen mesajlar ne olur? C: Çalışma saatleri dışında gelen mesajlar çevrimdışı formuna yönlendirilir ve size e-posta bildirimi gönderilir.