Wapix

Web Sitesi Widget'ını Bağlama Panel gerekmez

Web sitesi widget'ı, Wapix'in kanalları arasında farklı bir konumda: üçüncü taraf bir geliştirici hesabı yok, uygulama incelemesi yok ve başka bir yerde yapılandırılacak bir panel yok — her şey Wapix'in kendi yönetim paneli içinde gerçekleşir ve başka bir yere yapıştırmanız gereken tek şey, kendi sitenizdeki tek bir HTML satırıdır.

Basitçe

Bu nedir. Kendi web sitenizin köşesinde bir sohbet balonu. Ziyaretçiler buna tıklayıp, sitenizi terk etmeden ve hiçbir şey yüklemeden AI ile sohbet ederler.

Çözümlediği sorun. Birçok ziyaretçi hızlı bir soru sormak ister ve bunu yapamadıklarında ayrılırlar. Herkes WhatsApp açmak ya da telefon numarası vermek istemez. Widget, onlara orada sorma imkanı tanır.

Nasıl çalışır. Web sitenize bir kod satırı yapıştırırsınız. O satır sohbet balonunu yükler. Mesajlar, diğer tüm kanallarınızla aynı Gelen Kutusuna gider.

Ne kadar sürer. Web sitenizi düzenleyebiliyorsanız, yaklaşık 5 dakika.

Bir kanalın ne olduğu ve sonrasında nasıl yönetileceği hakkında daha fazla bilgi için Kanallar sayfasına bakın.

1. Wapix'de kanalı oluşturun

  1. Wapix'de Kanallar → Kanal ekle seçeneğine gidin.
  2. Web sitesi widget'ı seçeneğini seçin, bir isim verin (örneğin "Web Sitesi Sohbeti").
  3. İsterseniz şimdi bir asistan seçin veya bunu daha sonra kanal kartından yapın — kimlik bilgisi gerekmiyor, bu nedenle bu her kanalın kurulumu için en kısa olanıdır.
  4. Kaydedin.

2. Gömme kodunu kopyalayın

Yeni kanal sayfasında, Wapix aşağıdaki gibi bir gömme kodu gösterir:

<script src="https://yourdomain.com/widget.js" data-channel="wc_8f3kQ2..." async></script>

Bunu, sohbet balonunun görünmesini istediğiniz her sayfanın kapanış </body> etiketinin hemen öncesine yapıştırın — eğer sitenizin ortak bir alt bilgi/şablonu varsa, genellikle oraya eklenir, böylece sadece bir kez eklemeniz yeterlidir.

  • data-channel bu kanalın kendi anahtarıdır — tam olarak gösterildiği gibi kopyalayın, başka bir kanalın kodunu yeniden kullanmayın.
  • Script async ile yüklenir ve yükleme tamamlanana kadar sayfanıza hiçbir şey eklemez, bu nedenle sitenizin kendi render işlemini engellemez.
  • Widget dili. Balonun butonları her ziyaretçinin tarayıcı dilinde görünür. Bunun yerine tek bir dili ayarlamak için, kodun üstündeki Widget dili kısmından seçin; kod daha sonra bir data-lang niteliği alır (örneğin data-lang="es"). AI, her zaman ziyaretçinin yazdığı dilde yanıt verir.

3. Test edin

Web sitenizi normal (veya gizli) bir tarayıcı sekmesinde açın. Sağ alt köşede yuvarlak bir sohbet başlatma butonu görünür. Buna tıklayın, bir mesaj gönderin ve birkaç saniye içinde Wapix'in Gelen Kutusu'nda görünmelidir ve eğer bir bilgi bankası bağlıysa, yaklaşık 5 saniye içinde bir AI yanıtı almalıdır — widget yeni yanıtları kısa bir anketle kontrol eder, anında değil.

Eğer bir dakika içinde hiçbir şey gelmezse, Sorun Giderme & SSS sayfasına bakın.

Sohbetinizi spamdan koruyun

Kod, sayfanızın kaynağında görünür, bu nedenle herkes bunu kopyalayabilir. Bir kopyanın kötüye kullanılmasını durdurmak için, kanal sayfasını açın ve Sohbetinizi koruyun seçeneğini kullanın:

  • İzin verilen web siteleri. Web sitenizin alan adını, her satıra bir tane olacak şekilde girin (örneğin shop.com). Sohbet, yalnızca bu web sitelerinde ve alt alan adlarında çalışır (help.shop.com da dahil). www.shop.com girişi shop.com olarak sayılır, bu nedenle site www ile ve www olmadan çalışır. Başka birinin sitesinde kodunuzun bir kopyası balonu gösterir, ancak her mesaj reddedilir. Herhangi bir web sitesine izin vermek için listeyi boş bırakın; sayfa boş olduğunda sizi uyarır. Kendi bilgisayarınızda test yapıyorsanız localhost ekleyin.
  • Yeni bir anahtar oluşturun. Eğer biri kodunuzu kötüye kullanıyorsa, yeni bir anahtar oluşturun. Eski kod hemen her yerde çalışmayı durdurur, bu nedenle yeni olanı hemen web sitenize yapıştırın. Ziyaretçiler değişiklikten sonra yeni bir sohbet başlatır.
  • Kimlik sırrı (isteğe bağlı). Sadece web sitenizin kendi sunucusu varsa gereklidir. O sunucu, identify()'ye geçirdiği e-postayı imzalamak için bu sırrı kullanır, böylece başka kimse sizin müşteriniz olduğunu iddia edemez. Cihazlar Arasında Ziyaretçiyi Tanıma sayfasına bakın. Eğer sızarsa, Yeni bir sır oluşturun seçeneğini seçin ve yenisini sunucunuza koyun; eski ile yapılan imzalar hemen eşleşmeyi durdurur.

Bunlar kendi başlarına çalışır, herhangi bir ayar yapmaya gerek yoktur:

  • Yeni ziyaretçiler için sınırlamalar. Bir ağ (IP adresi) saatte yalnızca birkaç yeni sohbet başlatabilir ve her sohbet yalnızca saatte belirli sayıda yeni ziyaretçi alır. Zaten sohbet eden bir ziyaretçi asla kesilmez. Bir sınır aşıldığında, balon yeni ziyaretçilere daha sonra tekrar denemelerini söyler.
  • Yeni ziyaretçiler için hızlı bir kontrol. Platformunuz, yeni bir ziyaretçiden genellikle görünmez olan kısa bir kontrol geçmesini isteyebilir, bu da betimlenmiş spamı engeller. Zaten sohbet eden bir ziyaretçiden tekrar istenmez.
  • Engelleme. Gelen Kutusu'nda, konuşmanın menüsünü açın ve Kişiyi engelle seçeneğini seçin veya kişinin iletişim sayfasındaki aynı butonu kullanın. Yeni mesajları görmezden gelir ve konuşma kapatılır. Web sitesi sohbetinde, aynı ağdan gelen yeni sohbetler de reddedilir, bu da aynı ofisteki veya aynı mobil ağdaki diğer kişileri içerebilir. Aynı yerde Engeli kaldır seçeneğini seçerek bunu geri alabilirsiniz. Engelleme, her kanalda çalışır ve kişileri yönetme izni gerektirir.

Sohbetteki butonlar

Otomasyon hızlı yanıtlar, bir liste veya bir bağlantı butonu gönderdiğinde, sohbet bunları mesajın altında butonlar olarak gösterir. Bir ziyaretçi birine dokunur ve seçilen kelimeler yanıt olarak gönderilir. Bir bağlantı butonu, sayfayı yeni bir sekmede açar.

Ziyaretçi oturumları nasıl çalışır

Bir ziyaretçi asla giriş yapmaz veya kaydolmaz. Widget, ilk kez yüklendiğinde rastgele bir oturum kimliği oluşturur ve bunu tarayıcının localStorage'ında saklar, ardından aynı tarayıcıdan sonraki her ziyarette aynı kimliği yeniden kullanır — böylece geri dönen bir ziyaretçi, önceki konuşmasını devam ettirir, ancak farklı bir tarayıcı veya cihaz her zaman tamamen yeni bir sohbet başlatır. Site verilerini temizlemek veya özel bir pencerede gezinmek de yeni bir konuşma başlatır, çünkü oturum kimliğinin kalıcı olacağı bir yer yoktur.

Cihazlar Arasında Ziyaretçiyi Tanıma

Bir kez Wapix, bir ziyaretçinin e-posta adresini bildiğinde, bunu onların iletişim bilgilerine kaydeder, böylece ekibiniz kim olduklarını görebilir. Bu, herhangi bir web sitesinde, hatta basit bir HTML sitesinde bile çalışır. İsteğe bağlı olarak, eğer web sitenizin kendi sunucusu varsa, o e-postayı da imzalayabilir ve Wapix, ziyaretçinin farklı tarayıcılardaki ve cihazlardaki sohbetlerini birleştirir.

  • Bir lead formundan. Bir ziyaretçi, lead formu içindeki E-posta alanına geçerli bir adres yanıtladığında, e-posta onların iletişim bilgilerine kaydedilir. Yazılı bir yanıt, birinin kim olduğunu kanıtlamaz, bu nedenle başka bir cihazdan gelen konuşmaları geri getirmez.

  • Kendi sitenizden. Eğer ziyaretçileriniz web sitenize giriş yapıyorsa, zaten e-postalarını biliyorsunuzdur. Gömme kodundan sonra, çağrıyı yapın:

    window.ChatWidget &&
       window.ChatWidget.identify('visitor@example.com', { name: 'Jane Doe' });
    

    giriş yapan kullanıcının gerçek e-postasıyla (sitenizin şablonu bunu doldurur) çağrıyı yapın. Kanal sayfası, İsteğe bağlı: bilinen bir ziyaretçiyi tanımlama altında kopyalanacak tam satırı gösterir; window.'dan sonraki isim ChatWidget'dan farklı olabilir ve ChatWidget her iki şekilde de çalışır. Widget async olarak yüklendiği için, sayfa yüklendikten sonra çalıştırın (örneğin window'ın load olayında); eğer widget henüz hazır değilse, çağrı basitçe hiçbir şey yapmaz.

E-postayı imzalama

Bu adım isteğe bağlıdır ve kendi sunucunuza ihtiyaç duyar: bunun olmaması durumunda, identify() yine de e-postayı ve ziyaretçi bilgilerini kaydeder. user_hash, e-postanın sizin web sitenizden geldiğini kanıtlar ve başka biri bunu tarayıcıya yazarak geçemez. Sunucunuz, kanal sayfasındaki Kimlik sırrı ile bunu oluşturur ( Sohbetinizi koruyun altında): geçirdiğiniz e-postanın tam HMAC-SHA256'sidir, hex olarak yazılmıştır.

// PHP
$userHash = hash_hmac('sha256', $user->email, 'YOUR_IDENTITY_SECRET');
// Node.js
const userHash = require('crypto')
   .createHmac('sha256', 'YOUR_IDENTITY_SECRET')
   .update(user.email)
   .digest('hex');
# Python
user_hash = hmac.new(b'YOUR_IDENTITY_SECRET', user.email.encode(), hashlib.sha256).hexdigest()

Sonucu, e-postanın yanına user_hash ile birlikte koyun: identify(email, { name: 'Jane Doe', user_hash: 'SIGNED_ON_YOUR_SERVER' }). Ayrıca bunu üçüncü bir argüman olarak da geçebilirsiniz: identify(email, details, userHash).

  • İmzalı: eğer siteniz, bu kanalda daha önce aynı e-postayı imzaladıysa, Wapix o önceki konuşmaları, lead formu yanıtlarını ve yayın geçmişini mevcut oturuma taşır. Sohbet penceresi tam geçmişlerini gösterir ve Gelen Kutunuz bir müşteri gösterir, iki değil. Eşleşme kanal bazındadır: iki farklı widget kanalında aynı e-posta, iki ayrı müşteri olarak kalır.
  • İmzalanmamış: e-posta (ve herhangi bir detay) yalnızca bu ziyaretçiye kaydedilir. Önceki konuşmaları olduğu gibi kalır ve bu tarayıcıda asla gösterilmez, daha sonra yapılan imzalı bir çağrı, bu ziyaretçinin sohbetini başka birinin geçmişine dahil etmez.
  • Yanlış imzalanmış: çağrı reddedilir ve hiçbir şey kaydedilmez. Tarayıcı konsolu bunu belirtir. Geçirdiğiniz e-postayı tam olarak imzaladığınızdan emin olun, mevcut sır ile.

Sadece sunucunuzda imzalayın. Kimlik sırrı asla sayfanızda, JavaScript'inizde veya uygulamanızda görünmemelidir: bunu elinde bulunduran herkes, herhangi bir e-postayı imzalayabilir ve o müşterinin sohbet geçmişini okuyabilir.

Daha fazla detay geçme

Ziyaretçi hakkında bildiğiniz başka bilgileri de geçebilirsiniz, böylece iletişim bilgileri doldurulmuş olarak gelir:

window.ChatWidget &&
   window.ChatWidget.identify('visitor@example.com', {
      name: 'Jane Doe',
      phone: '+1 555 010 0200',
      country: 'US',
      language: 'en',
      plan: 'Pro',
   });
  • name ve phone, iletişimdeki bilgilerin yerini alır. country (iki harf) ve language, yalnızca iletişimde henüz yoksa doldurulur, çünkü widget bunları zaten algılar.
  • Diğer herhangi bir anahtar, o anahtarla özel iletişim alanı doldurur, yukarıdaki gibi plan. Tanımlamadığınız anahtarlar yok sayılır.
  • Uymayan bir değer (çok kısa bir telefon numarası, bir seçim alanında olmayan bir seçenek) atlanır; geri kalanları yine de kaydedilir.

Sadece kendi sitenizin giriş yapmış kullanıcısı hakkında bildiği bilgileri geçin, asla bir ziyaretçinin bir forma yazdığı bir şeyi geçmeyin.

Her widget konuşması, WhatsApp, Telegram, Instagram ve Messenger konuşmalarıyla aynı yönetim Gelen Kutusu'nda görünür — kontrol edilecek ayrı bir şey yoktur.

Widget hiç görünmüyor mu? Web sitenizdeki katı bir İçerik Güvenlik Politikası (CSP) başlığı, widget'ın <script> etiketini veya Wapix'e geri yapılan istekleri sessizce engelleyebilir. CSP'nize ne eklemeniz gerektiği için Sorun Giderme sayfasına bakın.