Dokümanlar

Widget Stili ve Özelleştirme

Widget görünümünü init seçenekleri veya Dashboard arayüzü aracılığıyla kontrol edin.

Boyut Ön Ayarları#

chatSize ve launcherSize aracılığıyla üç yerleşik boyut ön ayarından birini seçin:

chatSizeSohbet Penceresi
compact340 x 460 px
default380 x 520 px
large420 x 600 px

launcherSize, yüzen düğmeyi chatSize’dan bağımsız olarak kontrol eder:

launcherSizeBaşlatıcıSimge
small48 px22 px
default60 px28 px
large68 px32 px
Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  chatSize: 'large',        // daha geniş ve daha uzun sohbet penceresi
  launcherSize: 'small'     // daha küçük yüzen düğme
});

Konumlandırma#

Widget konumunu offsetBottom ve offsetSide (piksel cinsinden) ile ince ayarlayın. position (bottom-right veya bottom-left) ile birleştirildiğinde, bu yerleşim üzerinde tam kontrol sağlar.

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  position: 'bottom-left',
  offsetBottom: 40,          // alttan 40px (varsayılan: 20)
  offsetSide: 30             // sol kenardan 30px (varsayılan: 20)
});

Köşe Yarıçapı ve Z-Index#

borderRadius sohbet penceresinin köşe yuvarlamasını kontrol eder (varsayılan: 20px).zIndex yığın sırasını ayarlar (varsayılan: 999999).

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  borderRadius: 12,    // daha keskin köşeler
  zIndex: 100000       // çakışmaları önlemek için daha düşük z-index
});

Özel CSS#

Yerleşik seçeneklerin ötesinde gelişmiş stil için bir customCSS dizesi geçirin. Widget’ın Shadow DOM’una enjekte edilir — herhangi bir widget stilini geçersiz kılabilir ancak sayfanızı etkileyemez.

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  customCSS: `
    .respondoai-chat {
      border-radius: 24px;
      box-shadow: 0 12px 48px rgba(0,0,0,0.2);
    }
    .respondoai-launcher {
      box-shadow: none;
      border: 2px solid #e5e7eb;
    }
    .respondoai-header {
      backdrop-filter: blur(10px);
    }
    .respondoai-message.assistant {
      background: #f0f9ff;
    }
    /* Duyuru kartlarındaki CTA düğmesini biçimlendir */
    .respondoai-announcement-cta-button {
      border-radius: 999px;
      font-weight: 600;
      letter-spacing: 0.2px;
    }
    /* Duyuru CTA düğmelerini varsayılan yığın yerine bir satırda yerleştir */
    .respondoai-announcement-ctas {
      flex-direction: row;
    }
  `
});
Özel CSS, Shadow DOM içinde çalışır — sayfa stillerinizden tamamen izole edilmiştir. Herhangi bir widget sınıfını yan etki olmadan güvenle geçersiz kılabilirsiniz.

Kullanılabilir CSS sınıfları:

SınıfÖğe
.respondoai-widgetKök kapsayıcı (konum, z-index)
.respondoai-launcherYüzen düğme
.respondoai-chatSohbet penceresi
.respondoai-headerSohbet başlık çubuğu
.respondoai-messagesMesaj listesi kapsayıcısı
.respondoai-message.userKullanıcı mesajı balonu
.respondoai-message.assistantBot mesajı balonu
.respondoai-input-areaGiriş çubuğu kapsayıcısı
.respondoai-inputMetin giriş alanı
.respondoai-sendGönder düğmesi
.respondoai-suggestion-btnHızlı soru düğmeleri
.respondoai-announcement-cta-buttonDuyuru kartındaki CTA düğmesi
.respondoai-announcement-ctasDuyuru kartındaki CTA düğmelerini saran kapsayıcı (hedef yerleşim)
Tüm stil seçeneklerini Dashboard’dan da yapılandırabilirsiniz — Channels → Widget → Appearance bölümüne gidin. Panoda yapılan değişiklikler, config API aracılığıyla widget’a otomatik olarak sunulur.