İçeriğe geç
ClickFix

Kanallar

Web widget

Web sitenize tek satır kodla canlı destek balonu ekleyin, görünümünü ayarlayın ve giriş yapmış kullanıcılarınızı güvenle tanıtın.

Web widget, sitenize eklenen bir canlı destek balonudur. Ziyaretçiler balondan size yazar, yardım merkezinizde arama yapar ve randevu alır. Her widget ayrı bir gelen kutusudur; birden çok site için birden çok widget oluşturabilirsiniz.

Widget oluşturma

  1. Sol menüde Web widget sayfasını açın.
  2. Bir ad yazıp Widget oluştur'a basın.
  3. Sekmelerden ayarları yapıp Kaydet'e basın.
SekmeAyarlar
GörünümAna renk, konum (sağ alt / sol alt), dil, ekibi göster
SohbetKarşılama başlığı ve metni, sohbet öncesi form (ad ve e-posta), dosya gönderimi (en fazla 10 MB), memnuniyet puanı (CSAT)
Çalışma saatleriGün ve saatler, saat dilimi, çevrimdışı mesajı
Güvenlikİzin verilen alan adları, kimlik doğrulama anahtarı, yalnızca doğrulanmış kullanıcılar
KurulumKurulum kodu ve kullanıcı tanıtma örneği

Çalışma saatleri dışında widget çevrimdışı görünür ve e-posta adresi zorunlu olur.

Kurulum

Kurulum sekmesindeki satırı sitenizin tüm sayfalarına, </body> etiketinden önce ekleyin:

<script
  src="https://getclickfix.com/widget.js"
  data-widget="WIDGET_ID"
  async
></script>

WIDGET_ID yerine panelde gösterilen widget kimliği gelir; kodu doğrudan panelden kopyalamanız yeterlidir. Bu sayfada dene düğmesiyle widget'ı yayınlamadan önce panelde deneyebilirsiniz.

İzin verilen alan adları

Güvenlik sekmesinde her satıra bir alan adı yazın. *.ornek.com tüm alt alan adlarını kapsar. Liste boşsa widget her sitede çalışır.

JavaScript API

Widget yüklendikten sonra window.ClickFix üzerinden kontrol edilebilir. Script yüklenmeden önce yapılan çağrılar sıraya alınır:

<script>
  window.ClickFix =
    window.ClickFix ||
    function () {
      (window.ClickFix.q = window.ClickFix.q || []).push(arguments);
    };
  ClickFix("init", { widgetId: "WIDGET_ID", hideLauncher: true });
</script>
<script src="https://getclickfix.com/widget.js" async></script>
KomutNe yapar
ClickFix("open") / "close" / "toggle"Sohbet penceresini açar, kapatır veya değiştirir
ClickFix("identify", {...})Giriş yapmış kullanıcıyı tanıtır (aşağıda)
ClickFix("update", { name, email, phone })Ziyaretçi bilgilerini günceller
ClickFix("track", "olay_adi", {...})Sayfa olayı kaydeder; son 20 olay ziyaretçinin bir sonraki mesajına eklenir
ClickFix("on", "message", fn)Olay dinler: ready, open, close, message, message:sent, conversation, unread, identify, rating, track
ClickFix("reset")Ziyaretçiyi unutur (çıkış yaparken çağırın)
ClickFix("shutdown")Widget'ı sayfadan kaldırır

init seçenekleri: widgetId, locale (tr / en), position (left / right), color (#rrggbb), hideLauncher (balonu gizleyip kendi düğmenizle açmak için), user (başlangıçta kullanıcıyı tanıtmak için) ve debug.

TypeScript tipleri https://getclickfix.com/widget.d.ts adresinde yayınlanır.

Giriş yapmış kullanıcıları tanıtma

Sitenizde giriş yapmış kullanıcıları widget'a güvenli biçimde tanıtabilirsiniz. Böylece konuşmalar doğru kişiye ve şirkete bağlanır.

  1. Güvenlik sekmesinde Anahtar oluştur ile bir kimlik doğrulama anahtarı üretin. Anahtar yalnızca bir kez gösterilir; kopyalayıp sunucunuzda saklayın.

  2. Sunucunuzda her kullanıcı için user_hash üretin:

    user_hash = hex(HMAC-SHA256(kimlik_dogrulama_anahtari, user_id))

  3. Sayfada identify çağırın:

    <script>
  ClickFix("identify", {
    user_id: "USER_ID",
    user_hash: "USER_HASH",
    name: "Ada Yılmaz",
    email: "ada@example.com",
    company: { id: "acme", name: "Acme A.Ş.", domain: "acme.com" },
  });
</script>

Anahtarı asla tarayıcıya göndermeyin. Örneğin Node.js'te:

import crypto from "node:crypto";

const userHash = crypto
  .createHmac("sha256", process.env.CLICKFIX_IDENTITY_SECRET)
  .update(String(user.id))
  .digest("hex");

Yalnızca doğrulanmış kullanıcılar seçeneğini açarsanız anonim ziyaretçiler mesaj gönderemez. Bu, müşteri paneli gibi giriş gerektiren siteler için uygundur. Anahtarı Anahtarı yenile ile değiştirebilirsiniz; bu durumda sunucunuzdaki anahtarı da güncelleyin.

Yardım merkezi ve randevu

Bilgi bankanızda herkese açık yayınlanmış makaleler varsa ziyaretçiler widget içinden arama yapabilir. Randevular modülü açıksa widget herkese açık randevu sayfanıza bağlantı verir. Ayrıntılar: Bilgi bankası, Randevular.