Widget API — Keyda Business docs

Geliştiriciler veya sohbetin kendi butonlarından açılmasını isteyen herkes için.

Yükleme

<script src="https://keyda.in/business/widget.js"
        data-key="kb_live_your_key_here" async></script>

Komut dosyası etiketi yalnızca src ve data-key gerektirir. Renkler, konum, karşılama mesajı ve diller gibi diğer her şey kontrol panelinizden yönetilir; böylece değişiklik yapmak için sitenizi asla yeniden dağıtmanız gerekmez.

Modlar

Yüzen (varsayılan). Köşede yer alan ve sohbet panelini açan bir başlatıcı düğme.

Satır içi. Sayfaya boş bir kapsayıcı yerleştirin, sohbet penceresi oraya yerleşecektir:

<div data-keyda-bot style="height:520px"></div>

Kapsayıcının bir yüksekliğe ihtiyacı vardır. Satır içi modda sohbet her zaman görünür durumdadır, bu nedenle açılacak veya kapanacak bir şey yoktur.

JavaScript API

Komut dosyası yüklendiğinde window.KeydaBot üzerinde kullanılabilir:

Ara	Ne işe yarar
`KeydaBot.open()`	Sohbet panelini açar
`KeydaBot.close()`	Kapatır
`KeydaBot.toggle()`	Açar veya kapatır
`KeydaBot.expand()`	Paneli pencere yüksekliğinde ve 760 piksele kadar genişlikte yapar
`KeydaBot.shrink()`	Standart karta dön
`KeydaBot.isOpen`	`true` sohbet görünür olduğunda
`KeydaBot.isExpanded`	`true` panel genişletilmişken
`KeydaBot.clientId`	Bu sayfanın kullandığı Client ID

Örnek — sohbeti kendi "Bizimle sohbet edin" düğmenizden açın:

<button onclick="KeydaBot.open()">Chat with us</button>

Script asenkron olarak yüklendiğinden, sayfa yüklendikten hemen sonra window.KeydaBot mevcut olmayabilir. Sayfa ayrıştırılırken çağırmak yerine, işleyicileri bir tıklamaya bağlayın.

Sayfanızda nasıl davranır

Panel, yerinde kalan ve kapatma kontrolü haline gelen başlatıcı butonunun üzerinde açılır. Butona tekrar dokunmak, başlıktaki ✕ işaretine basmak veya Escape tuşuna basmak sohbeti kapatır.
Bir ziyaretçi paneli başlıktan genişletebilir — panel pencere yüksekliğine ve 760 piksel genişliğe kadar büyür — ve bu tercih tarayıcılarında hatırlanır. Telefonlarda panel zaten tam ekran olduğu için bu kontrol orada gösterilmez.
Logo boyutu ayarınız butonu değil, logonun kendisini değiştirir: başlatıcı sabit 52 piksel boyutunda bir hap şeklindedir (yuvarlak ve kare şekiller için 58 piksel) ve logo bunun içinde büyür.
Her şey bir shadow root içinde oluşturulur, böylece CSS'iniz widget'ı bozamaz ve widget'ın CSS'i sitenize müdahale edemez.
Panel yalnızca bir ziyaretçi açtığında yüklenir, bu nedenle sayfanızı yavaşlatmaz.
Bir ziyaretçinin konuşması, geri dönerse 24 saat boyunca devam eder, ardından sıfırdan başlar.
Asistan'a ulaşılamazsa, widget kısa bir mesaj gösterir ve sayfanızda asla hata vermez.