Bu sayfa sohbet widget'ını sitenize eklemenin iki yolunu anlatır. Widget'ın ne olduğunu ve neler yaptığını web sitesi sohbet widget'ı sayfası açıklıyor; burada kurulum adımları ve dikkat edilmesi gereken teknik gereksinim var.
Hangi yolu seçmelisiniz
Yol
Kimin için
Gerektirdiği
Hazır platform eklentisi
WordPress veya CS-Cart kullananlar
Eklentiyi kurmak, Agent ID ve API anahtarını girmek
Gömme kodu
Diğer tüm siteler
Sunucu tarafında imzalı bağlantı üretecek küçük bir kod
WordPress veya CS-Cart kullanıyorsanız hazır eklentiler belirgin şekilde daha kolaydır: aşağıda anlatılan imzalı bağlantı adımını eklenti sizin yerinize, sunucu tarafında yapar.
Panelde widget'ı yapılandırma
Widget ayarları asistanın altındadır: Asistanlar → asistanı düzenle → Erişim Kanalları → Widget.
Yapılandırabileceğiniz ayarlar:
Sohbet düğmesi
- Düğme görünümü: simge veya avatar
- Düğme boyutu: küçük (60 px) veya büyük (72 px)
- Düğme rengi ve düğme metni rengi
Sohbet penceresi
- Pencere varyantı: modern, standart veya minimal
- Genişletilebilir pencere seçeneği
- Arka plan, metin, kenar, odak çerçevesi, başlık ve başlık arka planı renkleri
- Kart ve düğme köşe yarıçapı (0–32)
Konum ve metinler
- Alttan ve sağdan boşluk (0, 5, 10, 15 veya 20 px)
- Sohbeti başlatma düğmesi metni
- Karşılama çağrısı metni
Widget sekmesi açıkken sağ altta canlı bir önizleme yüklenir; renk ayarlarını kaydetmeden görebilirsiniz.
Panelde bulunmayan ayarlar
Bu ayarlar Widget ekranında yok, aramanıza gerek kalmasın:
- Açık/koyu tema seçici — tema yalnızca gömme kodundaki
themeniteliğiyle verilir - Sağ/sol konum seçimi — panelde yalnızca boşluk değeri var, taraf değişmez
- Karşılama mesajı metni — asistanın ilk mesajı asistan ayarlarından gelir
- Avatar yükleme — asistanın avatarı asistan ayarlarından gelir
- Çalışma saatleri
Gömme kodu ile kurulum
Widget ekranı size şu biçimde bir kod verir:
<giizo-convai agent-id="ASISTAN_ID" signed-url="signedURL"></giizo-convai>
<script src="https://cdn.giizo.ai/convai-widget/index.js" async type="text/javascript"></script>
Bu kodu olduğu gibi yapıştırırsanız widget açılır ama bağlantı kurulamaz. signed-url değerindeki signedURL gerçek bir adres değil, doldurmanız gereken bir yer tutucudur. Widget bağlantıyı yalnızca geçerli bir imzalı adresle kurar; yer tutucuyla denediğinde tarayıcı konsoluna bağlantı hatası yazar ve sohbet başlamaz.
Doğru kurulum üç parçadan oluşur:
1. Agent ID'yi alın. Gömme kodunun içindeki agent-id değeridir. Panelde Agent ID'yi tek başına gösteren bir alan bulunmuyor; değeri gömme kodundan kopyalamanız gerekiyor.
2. API anahtarınızı alın. PaneldeAyarlar ekranından üretilir. Bu anahtar hesabınızın tamamına erişim verir;tarayıcıya gönderilen koda yazılmamalıdır.
3. İmzalı bağlantıyı sunucu tarafında üretin. Sayfayı sunan kodunuz, API anahtarınızla imzalı bağlantı ucunu çağırır ve dönen adresi signed-url niteliğine yazar. Uç nokta ve dönen değerin biçimi widget gömme referansı sayfasında.
İmzalı bağlantı süre sınırlıdır. Uzun süre açık kalan sayfalarda bağlantı yenilenmesi gerekir; pratikte bu, sayfayı her yüklemede taze bir imzalı adres üretmek anlamına gelir.
İzinli alan adları
Widget'ın hangi sitelerde çalışacağı Widget ekranında değil, asistanın Güvenlik sekmesinde tanımlanır. En fazla beş alan adı girebilirsiniz.
Davranışı bilmeye değer:
- Liste boşsa widget tüm alan adlarında çalışır. Kısıtlama, liste doldurulduğunda başlar.
giizo.aive alt alan adları her zaman izinlidir.*.ornek.combiçiminde joker kullanımı desteklenir.- Tarayıcı
OriginveyaRefererbaşlığı göndermiyorsa istek reddedilir. - Asistan pasif durumdaysa widget yapılandırması bulunamaz ve widget açılmaz.
Sitenizi izinli listeye eklediğiniz halde widget açılmıyorsa ilk kontrol edilecek yer alan adının tam yazımıdır (port dahil değerlendirilir).
Sesli konuşma
Widget'ta mikrofon düğmesi bulunur. Sesli konuşmanın çalışması için üç koşul gerekir:
- Tarayıcının ses kaydı desteği
- Sayfanın mikrofon iznine izin veren bir
Permissions-Policybaşlığı taşıması - Ziyaretçinin tarayıcı isteminde mikrofon iznini vermesi
Sitenizde içerik güvenlik politikası (CSP) veya izin politikası kullanıyorsanız gereken izinler widget gömme referansı sayfasında listeli.
Sesli konuşma web widget, tek başına çalışan sayfa ve robot kanallarına özgüdür. WhatsApp, Instagram ve Messenger yazılı kanallardır.
Oturum davranışı
Ziyaretçinin sohbet oturumu tarayıcısında saklanır; sayfa yenilendiğinde konuşma kaldığı yerden devam eder. Belirli bir süre işlem yapılmazsa oturum düşer ve yeni konuşma başlar (varsayılan süre 10 dakikadır).
Aynı sayfada birden fazla widget çalıştırılamaz: sayfadaki ilk giizo-convai elementi kullanılır, diğerleri yok sayılır.
İlgili sayfalar
- Hazır platform eklentileri — WordPress ve CS-Cart için kod yazmadan kurulum
- Widget gömme referansı — nitelikler, imzalı bağlantı ucu ve CSP gereksinimleri
- Widget özelliği — yetenek anlatımı