UISAP Docs

Siteler ve Widget Tasarımcısı

Site oluşturma, doğrulama, yayınlama ve widget'ın her sekmesinin ayar ayar anlatımı.

Site, ürünün temel birimidir: her sitenin kendi widget tasarımı, bilgi bankası, akışları, WhatsApp bağlantısı ve dilleri vardır. Tek kurumda birden çok site tutabilirsiniz (farklı markalar, alan adları, ülkeler).

Site listesi ve oluşturma

Siteler ekranında her satır bir siteyi ve durumunu gösterir:

DurumAnlamı
DoğrulandıWidget, kayıtlı alan adından en az bir kez el sıkıştı.
DoğrulanmadıKod henüz yüklenmedi ya da yanlış alan adından yüklendi.
Yayında / Yayında değilWidget ziyaretçilere gösteriliyor mu?

Yeni site oluştururken yalnızca ad ve alan adı girilir. Alan adı normalize edilir (protokol ve www. gerekmez) ve kurum içinde tekildir.

Site detayı sekmeleri

Sekmeİçerik
Genel bakışDurum, doğrulama anahtarı, AI ajanı ve sohbet modu anahtarları, yayın anahtarı.
PromptlarBu sitenin AI ajanının sistem prompt'u (Prompt Studio şablonlarından beslenir).
WidgetTasarımcı: görünüm ve dört alt sekme.
Gömme koduSiteye yapıştırılacak tek satırlık kod ve kurulum doğrulaması.

Widget tasarımcısı

Sağ tarafta canlı bir önizleme vardır; ana sayfa, sohbet, çevrimdışı ve ön sohbet gibi durumlar arasında geçiş yapabilirsiniz.

Görünüm

  • Marka rengi — başlatıcı butonu, buton dolguları ve vurgular.
  • Arka plan rengi — widget başlığının rengi.
  • Köşe yuvarlaklığı — panelin ve balonların yarıçapı.

Ana sayfa

Widget'ı açan ziyaretçinin ilk gördüğü ekran.

AyarAçıklama
Karşılama görseliTemsilci kolajı (ekip avatarları), Logonuz (yüklediğiniz görsel) veya Görsel yok.
BaşlıkBüyük karşılama başlığı (örn. "Merhaba 👋").
MesajBaşlığın altındaki kısa açıklama.
Sohbet başlatıcılarTek tıkla sohbeti açan hazır cümleler; sırası ve açık/kapalı durumu ayarlanabilir.
Mesaj alanı metniGiriş alanının yer tutucusu.

Temsilci kolajında ekibin ilk üç avatarı üst üste binmiş halkalar olarak gösterilir; üçten fazla üye varsa yanına +N rozeti gelir. Avatarı olmayan üyeler baş harfleriyle görünür.

Sohbet

AyarAçıklama
Çalışma saatleriHer zaman çevrimiçi ya da haftalık program + saat dilimi.
Çevrimdışı mesajıEkip müsait değilken gösterilen metin.
Çevrimdışıyken mesaj bıraksınKapalıysa çevrimdışı saatlerde gönderme kapatılır.
Gizlilik politikası mesajıSohbet altında gösterilen bilgilendirme.

AI açıkken site çevrimdışı olmaz

Sitede AI ajanı yanıt veriyorsa program yok sayılır — yapay zekâ 7/24 cevaplar. Tasarımcı bu durumda bir bilgi notu gösterir.

Ön sohbet formu

Sohbet başlamadan önce ziyaretçiden bilgi toplar.

  • Alanlar: e-posta, ad, telefon, KVKK/GDPR onayı, departman.
  • Her alan tek tek açılıp kapatılabilir ve zorunlu yapılabilir.
  • Departman alanı seçilirse ziyaretçi konuyu kendisi seçer ve konuşma ilgili departmana etiketlenir.
  • Bülten izni kutusu isteğe bağlı olarak eklenir.

Küçültülmüş (başlatıcı) durumu

Widget kapalıyken görünen hâli: buton etiketi ve ziyaretçiyi sohbete davet eden kısa metin.

Bir akış veya temsilci mesaj gönderdiğinde başlatıcının üstünde küçük bir önizleme kartı açılır; kart mesajı, varsa görseli ve ilk butonu gösterir. Otomatik mesajlarda kartta gönderen adı yazmaz — mesaj bir kişiden gelmediği için. Gerçek bir temsilci yazdığında kartta o kişinin adı ve baş harfi görünür.

Çoklu dil

  • Varsayılan dil — ziyaretçinin tarayıcı dili yayınlanmamışsa kullanılır.
  • Yayınlanan diller — istediğiniz kadar dil ekleyin.
  • Widget her ziyaretçiye tek dilde görünür; dil karışımı olmaz.
  • Üstteki dil seçicisi hem içerik editörünü hem önizlemeyi o dile çevirir; kendi metinlerinizi (başlık, mesaj, başlatıcılar, çevrimdışı mesajı) dil başına ayrı yazarsınız.
  • Ürün metinleri (butonlar, yer tutucular) TR/EN/DE/FR hazır gelir; kuruma özel değişiklikler Ayarlar → Canlı Sohbet → Çeviriler'den yapılır.

Gömme kodu ve doğrulama

Sitenizin </body> etiketinden önce
<script src="https://app.uisap.dev/widget.js" data-site="SITE_TOKEN" async></script>
  • Kod tek satırdır ve data-site değeri siteye özeldir.
  • Widget yalnızca site kaydındaki alan adından yüklendiğinde çalışır; başka alan adlarından gelen istekler reddedilir.
  • İlk başarılı el sıkışmada site Doğrulandı durumuna geçer. Ayarlar → Canlı Sohbet → Kurulum ekranı, seçili site için durumu birkaç saniyede bir yeniler.
  • Widget dosyası 5 dakikalık önbellekle sunulur; yeni sürümler ziyaretçilere en fazla 5 dakika içinde ulaşır.

Yayın anahtarı

Site yayında değilken widget hiç mount edilmez — kodu sitede bırakıp widget'ı gizleyebilirsiniz. Bakım, sezon dışı veya test dönemleri için pratik bir anahtardır.

Sık sorulan sorular