UISAP Docs

Başlarken

Site oluşturma, widget kurulumu, doğrulama, yayına alma ve ilk yapılandırma listesi.

Bu sayfa sıfırdan canlıya çıkma yolunu adım adım anlatır. Toplam süre: 5-10 dakika.

Başlamadan önce

  • Widget kodunu ekleyebileceğiniz bir web siteniz (HTML'e script satırı ekleme yetkisi) olmalı.
  • Sitenizin alan adını bilmeniz gerekiyor (örn. www.ornek.com).
  • Ekibinizi davet edecekseniz e-posta adreslerini hazırlayın.

1. Site oluşturun

Siteler ekranından Yeni site deyin, sitenizin adını ve alan adını girin. Her site kendi:

  • widget tasarımına (renkler, karşılama başlığı, konuşma başlatıcılar),
  • bilgi bankası konularına,
  • akışlarına, dillerine ve WhatsApp bağlantısına

sahiptir. Birden fazla web siteniz varsa her biri için ayrı site açın. Ayrıntı: Siteler ve Widget Tasarımcısı.

2. Widget kodunu ekleyin

Kurulum kodunu iki yerden alabilirsiniz: Site detayı → Gömme kodu sekmesi veya Ayarlar → Canlı Sohbet → Kurulum. Kod tek satırdır:

Sitenizin </body> etiketinden hemen önce
<script src="https://app.uisap.dev/widget.js" data-site="SITE_TOKEN" async></script>

data-site değeri siteye özel doğrulama anahtarıdır; kod sizin için hazır üretilir, kopyala-yapıştır yeterlidir. Kodu ekibinize göndermek isterseniz kurulum ekranındaki Talimatları e-posta ile gönder düğmesini kullanın.

Alan adı eşleşmesi

Widget yalnızca site kaydında yazan alan adından yüklendiğinde çalışır. Farklı bir alan adından gelen istekler reddedilir — bu, anahtarınızın başka sitelerde kullanılmasını engeller. Test/staging ortamı için ayrı bir site açın.

3. Kurulumu doğrulayın

Kodu ekledikten sonra sitenizi ziyaret edin. Widget ilk kez doğru alan adından el sıkıştığında site otomatik olarak Doğrulandı durumuna geçer. Kurulum ekranı doğrulamayı birkaç saniyede bir kontrol edip yeşil onayı gösterir.

Doğrulanmıyorsa: Sorun Giderme → Site doğrulanmıyor.

4. Yayına alın

Doğrulama tamamlandığında widget hâlâ yayında değildir — hazır olduğunuzda Sitemde yayına al demeniz gerekir. Böylece kodu erkenden ekleyip tasarımı bitirdikten sonra açabilirsiniz.

5. Widget'ı tasarlayın

Site detayındaki Widget sekmesinden:

  • Görünüm — marka rengi, arka plan rengi, köşe yuvarlaklığı.
  • Ana sayfa — karşılama görseli (temsilci kolajı / logo / görsel yok), başlık, mesaj, sohbet başlatıcılar.
  • Sohbet — çalışma saatleri takvimi, çevrimdışı mesajı, gizlilik metni.
  • Ön sohbet formu — e-posta, ad, telefon, KVKK onayı, departman.
  • Küçültülmüş — başlatıcı butonunun etiketi ve davet metni.
  • Diller — varsayılan dil ve yayınlanan ek diller. Widget her ziyaretçiye tek dilde görünür.

6. Bilgi bankasına ilk konuları girin

AI Agent → Bilgi bankası'na en sık sorulan 10 soruyu ve yanıtını girin. Yapay zekâ yalnızca bu içerikle konuşur; boş bir bilgi bankasıyla AI ajanı yanıt üretemez.

Yanıtı test et aracıyla bir soru yazıp AI'ın hangi konularla nasıl yanıt verdiğini canlıya çıkmadan görebilirsiniz. Ayrıntı: AI Agent.

7. İlk akışınızı kurun

En hızlı kazanç, ziyaretçi sohbeti açtığında devreye giren bir karşılama akışıdır:

Akışlar → Yeni akış (veya şablon galerisinden bir karşılama şablonu).
Sohbet simgesine tıklandı tetikleyicisini ekleyin.
Bir Mesaj gönder ve ardından Karar (Hızlı Yanıtlar) düğümü ekleyin.
Test et ile deneyin, sonra Etkinleştir deyin.

Ayrıntı: Akışlara Genel Bakış.

8. Ekibi davet edin

Ayarlar → Üyeler ekranından e-posta ile davet gönderin ve rolleri belirleyin. Kurum alan adınızla kayıt olan kişiler ayrıca katılma isteği gönderebilir. Ayrıntı: Roller ve Yetkiler.

Kontrol listesi

AdımTamamlandı mı?
Site oluşturulduAlan adı doğru mu?
Kod eklendiCanlı sayfada widget.js yükleniyor mu?
Site doğrulandıKurulum ekranı yeşil mi?
Widget yayındaZiyaretçiler görebiliyor mu?
Karşılama metinleriKendi dilinizde ve markanızın tonunda mı?
Bilgi bankasıEn az 10 konu var mı?
CSATAnketler açık mı?
EkipÜyeler davet edildi, roller atandı mı?

Sık sorulan sorular