Web sitesi sohbeti

Web sitesi sohbeti, agent'ınızı kendi sitenize koyar. Ziyaretçiler onunla her sayfanın köşesindeki bir balonda ya da bir sayfanın içindeki sohbet kutusunda konuşur. Agent'ın Channels sayfasında bir kez kurarsınız, sitenize tek satır kod yapıştırırsınız ve her konuşma Inbox'ta görünür.

Kurulum

1. Agent'ı en az bir kez yayınlayın. Müşteriler her zaman yayınlanmış sürümle konuşur. Bkz. Yayınlama ve sürümler.
2. Agent'ı açın ve Channels → Web sitesi sohbeti'ne gidin.
3. Sohbeti web sitenizde göster'i açın.
4. Bir Görünüm, bir Renk ve bir Karşılama mesajı seçin. Sağdaki Önizleme sonucu kaydetmeden önce gösterir.
5. İzin verilen web siteleri altına sitenizi ekleyin; örneğin https://magaza.example.com.
6. Kaydet'e basın. Yerleştirme kodu görünür.
7. Kopyala'ya basın ve kodu sitenize yapıştırın.
8. Gerçek widget'ınızla bir test sayfası açmak için Dene'ye basın.

Kartın başlığının yanındaki durum ilk kayda kadar henüz kurulmadı, sonra Açık ya da Kapalı olur.

Ayarlar

Ayar	Ne yapar	Varsayılan
Sohbeti web sitenizde göster	Kapatıldığında widget sitenizden kalkar ve adresi yanıt vermez. Ayarlarınız ve yerleştirme kodunuz korunur.	Kapalı
Görünüm	Balon: her sayfanın köşesinde bir düğme; sohbet sayfanın üzerinde açılır. Sohbet kutusu: kodu yapıştırdığınız yerde, sayfanın içinde her zaman açık duran bir sohbet kutusu.	Balon
Renk	Balonun, başlığın, ziyaretçi mesajlarının ve düğmelerin rengi. Seçin ya da #E5482D gibi bir hex kodu yazın. Üzerindeki yazı, hangisi daha iyi okunuyorsa otomatik olarak siyah ya da beyaz olur.	#1C1A17 (siyaha yakın)
Karşılama mesajı	Ziyaretçilerin agent'tan gördüğü ilk mesaj. İngilizce ve Türkçe yazın; her sürüm en fazla 500 karakter.	"Hi! How can we help you today?" / "Merhaba! Size nasıl yardımcı olabiliriz?"
İzin verilen web siteleri	Sohbeti gösterebilecek siteler. En fazla 20. Boşsa her site gösterebilir.	Boş (her site)

Sohbetin başlığında agent'ın ayarlarındaki adı görünür.

Her değişiklik Kaydet'e bastığınız anda, widget'ın zaten yerleştirildiği her sayfada uygulanır. Yayınlamak gerekmez, sitenizdeki kodu da değiştirmeniz gerekmez.

not

Karşılama mesajını yalnızca widget gösterir. Agent onu görmez ve gösterildiğini bilmez.

Yerleştirme kodu

İlk kayıttan sonra Yerleştirme kodu kutusu kodunuzu gösterir. Kendi anahtarınızla şuna benzer:

<script src="https://peki.ai/widget.js" data-key="pw_xxxxxxxxxxxxxxxxxxxxxxxx" async></script>

Kodu her zaman Channels sayfasından kopyalayın: data-key bu agent'a özeldir. Anahtar tasarım gereği herkese açıktır. Bir tarayıcının yalnızca bu agent'ın sohbetini açmasını sağlar, başka bir şeyi değil.

Nereye yapıştırılır:

• Balon: sohbetin görüneceği her sayfada </body> etiketinden önce. Çoğu site oluşturucuda kodu tüm sayfalara birden ekleyen bir "özel kod" ya da "alt bilgi betikleri" ayarı vardır.
• Sohbet kutusu: sohbet kutusunun sayfanızda görünmesini istediğiniz yerin tam olarak kendisine; örneğin bir "Bize ulaşın" bölümüne. Kutu bulunduğu alanın tüm genişliğini kaplar.

Script etiketindeki seçenekler

Script etiketine bu nitelikleri ekleyebilirsiniz. Yalnızca bulundukları sayfayı değiştirirler.

Nitelik	Ne yapar	Örnek
data-key	Hangi agent'ın sohbetinin açılacağı. Zorunlu.	data-key="pw_…"
data-layout	Bu sayfa için Görünüm ayarını geçersiz kılar: bubble (balon) ya da inline (sohbet kutusu).	data-layout="inline"
data-height	Sohbet kutusunun piksel cinsinden yüksekliği. 360 ile 2000 arası; belirtilmezse 560. Yalnızca sohbet kutusu için.	data-height="700"
data-lang	Widget'ın dili: en ya da tr. Yoksa ziyaretçinin tarayıcı dili belirler: Türkçe tarayıcılar Türkçe, diğer herkes İngilizce görür.	data-lang="tr"

Bir destek sayfasında 700 piksel yüksekliğinde, Türkçe bir sohbet kutusu:

<div class="destek-sohbet">
  <script src="https://peki.ai/widget.js" data-key="pw_xxxxxxxxxxxxxxxxxxxxxxxx" data-layout="inline" data-height="700" data-lang="tr" async></script>
</div>

Kod iki kez yapıştırılsa bile widget bir sayfada yalnızca bir kez yüklenir.

İzin verilen web siteleri

Varsayılan olarak her site sohbetinizi gösterebilir. Yalnızca kendi sitelerinizin gösterebilmesi için onları İzin verilen web siteleri altına ekleyin.

• Adresi yazın ve Enter'a ya da Site ekle'ye basın. https:// yazmazsanız sizin için eklenir.
• Yalnızca sitenin kökenini (origin) girin: protokol, alan adı ve varsa port. https://magaza.example.com doğrudur; https://magaza.example.com/iletisim "https://magaza.example.com gibi bir site adresi yazın" uyarısıyla reddedilir.
• Her adres tam olarak eşleşmelidir. https://example.com ile https://www.example.com farklı sitelerdir: siteniz ikisini de kullanıyorsa ikisini de ekleyin. http:// ile https:// ve farklı portlar da öyledir; örneğin yerel geliştirme için http://localhost:3000.
• En fazla 20 site.

Liste olduğunda başka bir sitedeki widget yüklenmeden reddedilir ("This website may not use this chat") ve orada hiçbir şey görünmez. Peki panelindeki Dene test sayfası listede ne olursa olsun her zaman çalışır.

ipucu

Yayına çıkmadan önce sitelerinizi ekleyin. Liste yokken yerleştirme kodunuzu kopyalayan herkes agent'ınızı kendi sitesinde gösterebilir ve onların ziyaretçilerinin mesajları sizin kullanımınızdan düşer.

Ziyaretçiler neler yapabilir

• Sohbet etmek. En fazla 2.000 karakterlik mesajlar. Enter gönderir, Shift + Enter satır ekler. Yanıtlar biçimlendirilmiş görünür (kalın yazı, listeler, bağlantılar, tablolar, kod).
• Dosya göndermek. Ataş simgesiyle fotoğraf (JPEG, PNG, WebP, GIF), PDF ve metin dosyası (TXT, MD, CSV), her biri en fazla 10 MB ve mesaj başına 5 adet. Bkz. Dosyalar ve ekler.
• Baştan başlamak. Başlıktaki + simgesi (Yeni konuşma) bir şey yazıldıktan sonra görünür. Yeni bir konuşma başlatır; eskisi Inbox'ınızda kalır.
• Konuşmayı değerlendirmek. Agent yanıt verdikten sonra konuşma 2 dakika sessiz kaldığında ya da ekibiniz konuşmayı çözüldü olarak kapattığında widget 👍 ve 👎 ile "Yardımcı oldu mu?" diye sorar. 👎'den sonra ziyaretçi en fazla 500 karakterlik bir yorum ekleyebilir. Değerlendirmeler Analytics'te görünür.
• Ekibinizi görmek. Bir ekip arkadaşınız devraldığında onun yanıtları adı ve Ekip yazısıyla görünür.

Widget'ın kendi düğmeleri ve mesajları ("Bir mesaj yazın…", "Peki ile" vb.) data-lang'e ya da tarayıcıya göre İngilizce veya Türkçedir. Agent ise ziyaretçi hangi dilde yazarsa o dilde yanıt verir.

Geri gelen ziyaretçiler

Widget bir ziyaretçiyi, her agent için ayrı olmak üzere tarayıcısında hatırlar. Ziyaretçi geri geldiğinde, konuşma çözülmediyse ya da agent'ın Yeni oturum başlat: ayarından (varsayılan 24 saat) daha uzun süre sessiz kalmadıysa mevcut konuşmasına devam eder. Bkz. Müşteriler.

Tarayıcı verilerini temizleyen, başka bir tarayıcı ya da cihaz kullanan veya gizli pencerede gezen bir ziyaretçi yeni ziyaretçi olarak başlar.

Oturum açmış kullanıcıları tanımak

Web sitesi sohbeti, sitenizde oturum açmış bir kullanıcının kimliğini alamaz. Her ziyaretçi agent için anonimdir ve ekibiniz bir ad verene kadar Inbox'ta Ziyaretçi olarak görünür.

Agent'ın kiminle konuştuğunu bilmesi gerekiyorsa (örneğin bir müşterinin siparişlerine hesabı üzerinden bakmak için) sohbeti kendi uygulamanızda Sessions API ile kurun ve kullanıcının kimliğini customer.id olarak gönderin. Bkz. API'ye genel bakış.

Görünümü özelleştirmek

Widget'ın görünümü Renk ve Görünüm dışında sabittir. Sayfanın yalıtılmış kendi alanında (shadow root) çalışır; böylece sitenizin CSS'i onu değiştiremez, onun CSS'i de sitenize dokunmaz. Balon sağ alt köşeden 20 piksel içeride, diğer içeriğin üstünde durur.

Denemek

Dene, gerçek widget'ınızla yeni bir sekmede bir test sayfası açar; orada iki görünüm arasında geçiş yapabilirsiniz. Widget açık ve kaydedilmiş, agent da yayınlanmış olduğunda kullanılabilir; aksi halde düğmenin yanında "Denemek için widget'ı açın, kaydedin ve agent'ı yayınlayın." yazar.

warning

Dene sayfasındaki konuşmalar gerçektir: yayındaki agent'ı kullanır, gerçek konuşma sayılır ve Inbox'ta ve Analytics'te Widget tester müşterisiyle görünür. Bir taslağı denemek için Test paneli'ni kullanın.

Sınırlar

Agent'ınızı ani yüklenmelere karşı korumak için widget'ın hız sınırları vardır. Bir sınıra takılan ziyaretçi kısa bir mesaj görür ve biraz sonra yeniden deneyebilir.

Sınır	Değer
Ziyaretçi başına mesaj	Dakikada 20
Tek bir ağdan bu sohbete mesaj	Saatte 200
Bu sohbete toplam mesaj	Dakikada 120
Tek bir ağdan yeni konuşma	Saatte 20
Ziyaretçi başına dosya	Saatte 20
Tek bir ağdan bu sohbete dosya	Saatte 60
Ziyaretçi başına değerlendirme	Dakikada 10

Sorun giderme

Sorun	Nedeni ve ne yapmalı
Widget hiç görünmüyor	Sohbeti web sitenizde göster'in açık ve kaydedilmiş olduğunu kontrol edin. data-key'in Channels sayfasındakiyle aynı olduğunu kontrol edin. İzin verilen web siteleri kullanıyorsanız sitenizin tam adresinin listede olduğunu kontrol edin (www ile ya da olmadan, http ya da https).
"Bu sohbet şu anda kullanılamıyor." görünüyor	Agent henüz yayınlanmadı. Yayınlayın.
Sohbet kutusu yanlış yerde	Sohbet kutusu görünümünde widget tam olarak script etiketinin olduğu yerde çıkar. Etiketi istediğiniz alanın içine taşıyın. Etiket <head> içindeyse kutu sayfanın sonuna eklenir.
Sohbet kutusu yerine balon çıkıyor (ya da tersi)	Görünüm ayarına ve etikette öncelikli olan bir data-layout niteliği olup olmadığına bakın.
Ziyaretçiler her sayfada konuşmalarını kaybediyor	Tarayıcıları site depolamasını engelliyor (bazı gizlilik ayarları bunu yapar); her yüklemede yeni ziyaretçi oluyorlar.
Widget yanlış dilde	Etikete data-lang="tr" ya da data-lang="en" ekleyin.
"Gönderilemedi. Lütfen tekrar deneyin."	Bir ağ sorunu ya da bir hız sınırı. Biraz bekleyip yeniden gönderin.
Ziyaretçiler "This assistant is very busy right now. Please try again later." görüyor	Çalışma alanınızın günlük yanıt sınırına ulaşıldı.

İlgili sayfalar

• Kanallara genel bakış
• Telegram
• Inbox
• Dosyalar ve ekler
• Yayınlama ve sürümler
• Analytics