Skip to main content
Bu rehber, widget’ı sitenizde çalışır hale getirmenin en kısa yolunu gösterir. Panelden site oluşturarak başlayın.
1

Sitenizi ekleyin

Panelde site ekleme akışını başlatın ve site adını (site_name) girin. Site oluşturulduğunda size özel bir public key atanır ve panelde görünür; anahtar sp_pub_ ile başlar.Panel kurulumu iki adımda izler: install_script (betiği ekleyin) ve verify_widget (kurulumu doğrulayın).
2

Widget betiğini sitenize ekleyin

Aşağıdaki kodu sitenizin ortak şablonuna ekleyin; data-supportly-id değerini kendi public key’inizle değiştirin.
Widget /checkout, /odeme, /payment ve /cart/checkout sayfalarında kendini başlatmaz; ödeme adımlarında sohbet penceresi görünmez.Sitenizde izinli origin listesi (allowed_origins) tanımlıysa widget yalnızca bu domainlerde açılır; listeye sitenizin kendi domainini de eklemeyi unutmayın.
3

Kurulumu doğrulayın

Panelde doğrulamayı çalıştırın. Sunucu sitenizi ziyaret eder; betik içinde anahtarınızı bulursa kurulum completed durumuna geçer.Doğrulama başarısızsa: WIDGET_NOT_FOUND anahtarın sayfada bulunamadığını, SITE_UNREACHABLE siteye erişilemediğini gösterir. Ayrıntılar için Widget Kurulumu sayfasına bakın.
4

İlk sohbeti deneyin

Sitenizi açın; sağ altta widget düğmesi görünür. Pencereyi açın ve bir soru yazın; asistan yanıt verir.Mesajınızda “insan” veya “temsilci” gibi bir ifade geçerse asistan canlı desteğe devir önerir (suggest_handoff: true).
Günlük mesaj kotası planınıza göre değişir (Free ve Basic 20, Growth 500, Pro sınırsız). Kullanım %80’e ulaştığında widget uyarı gösterir. Limit tabloları için API Temelleri sayfasına bakın.

Sonraki adımlar

Widget Özelleştirme

Renk, konum, karşılama ve logo ayarlarıyla widget’ı markanıza uydurun.

API Temelleri

Yanıt biçimi, anahtar türleri ve hız limitleri.

Widget Davranışı

Yapılandırma yükleme, proaktif mesaj ve origin doğrulama ayrıntıları.

ikas Entegrasyonu

Mağazanızı bağlayın; asistan ürün sorularında katalogdan yararlanır.