Yapılandırma

Widget görünümünü ve davranışını özelleştirin.

Init Seçenekleri#

Seçenek	Varsayılan	Açıklama
agentId	zorunlu*	Ajanınızın benzersiz kimliği. *Yalnızca insanlı (humans-only) widget’larda `channelId` tek başına yeterlidir.
channelId	—	Widget kanalının kimliği. Tek bir ajan birden fazla widget’ı beslediğinde hangi widget’ın ayarlarının (stil, giden ipuçları/afişler) uygulanacağını seçer ve yalnızca insanlı widget’larda tek tanımlayıcıdır. `agentId` / `channelId`’den en az biri zorunludur.
position	bottom-right	`bottom-right` veya `bottom-left`
primaryColor	#3B82F6	Widget düğmesi ve başlığı için marka rengi
title	Support	Başlık metni
greeting	auto	Karşılama mesajı (varsayılan olarak pano ayarlarından yüklenir)
language	page	Widget dili, BCP-47 kodu olarak (`de`, `pt-BR`). Arayüzü, karşılama mesajını ve hızlı soruları belirler. Belirtilmezse widget sayfanın `<html lang>` değerini izler: `lang` değeri `en` olmayan bir sayfa artık ziyaretçinin tarayıcısından bağımsız olarak o dilde başlar. Tek başına `<html lang="en">` şablon varsayılanı sayılır ve yok sayılır: ziyaretçi önceki davranışı korur (hatırlanan seçim, sonra tarayıcı dili). `<html lang>` değerini tamamen yok saymak ve yalnızca tarayıcı davranışına dönmek için `'browser'` geçin. Çalışma zamanında `Respondo.setLanguage('fr')` ile değiştirilebilir; sayfayı yeniden yüklemeyen dil değiştiriciler için kullanışlıdır.
placeholder	—	Özel giriş yer tutucu metni
quickQuestions	—	İlk mesajdan önce gösterilen önerilen sorular dizisi
logoUrl	—	Widget başlığında gösterilen logonuzun URL’si
avatarUrl	—	Mesajların yanında gösterilen yapay zeka ajanı avatarının URL’si
identity	—	Init sırasında önceden ayarlanmış kullanıcı kimliği ( `identify()` ile aynı alanlar)
localStorageKey	—	`userId` değerini otomatik okumak için localStorage anahtarı (GTM / kod gerektirmeyen kurulumlar için)
chatSize	default	`compact`, `default` veya `large` — sohbet penceresi boyutları
launcherSize	default	`small`, `default` veya `large` — başlatıcı düğme boyutu
offsetBottom	20	Alt kenardan uzaklık (px)
offsetSide	20	Sol/sağ kenardan uzaklık (px)
borderRadius	20	Sohbet penceresi köşe yarıçapı (px)
zIndex	999999	Widget kapsayıcısı için CSS z-index
customCSS	—	Gelişmiş stil için widget Shadow DOM’una enjekte edilen özel CSS
testMode	false	Konuşmaları test olarak işaretle (ana görünümlerden gizlenir)

Tam Yapılandırma#

Tam Yapılandırmajavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; varsayılan: <html lang> (en = zayıf sinyal), 'browser' onu yok sayar
  title: 'Help Center',
  greeting: 'How can we help?',
  placeholder: 'Ask anything...',
  logoUrl: 'https://yoursite.com/logo.png',
  avatarUrl: 'https://yoursite.com/avatar.png',
  quickQuestions: [
    'How do I get started?',
    'What are the pricing plans?',
    'How do I contact support?'
  ],
  testMode: false,
  localStorageKey: 'myapp_user_id', // userId değerini localStorage’dan otomatik oku (GTM / kod gerektirmez)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // alttan uzaklık (px)
  identity: {                      // isteğe bağlı: kullanıcı zaten biliniyorsa init sırasında ayarla
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // özel kişi özellikleri
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Çoğu ayar (renk, logo, karşılama, hızlı sorular) Channels panosundan yönetilir. Widget bunları yükleme sırasında getirir — yerleştirme kodundan yalnızca agentId/channelId çiftine ihtiyacınız vardır.