Siteye gömme

Tek satır script ile sohbet penceresini web sitenize yerleştirin; ayrıca sayfada çağrılabilen yöntemler ve dil kuralları.

Aşağıdaki {API}, hizmet adresini ifade eder; arka paneldeki "Entegrasyon" sayfasında görebilirsiniz.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key herkese açık Key'dir; arka paneldeki "Entegrasyon" sayfasından kopyalayın.
  • "Entegrasyon" sayfasında, gömülmesine izin verilen web sitelerini kaydedin (örneğin https://shop.example.com); başka siteler herkese açık Key'inizi alsa bile kullanamaz. Yayına almadan önce mutlaka doldurun.
  • İsteğe bağlı data-theme="dark" ile koyu tema kullanılır.
  • İsteğe bağlı data-language="de": Siteniz çok dilli ise, o anki sayfanın dilini buraya aktarın; müşteri hizmetleri varsayılan olarak bu dili kullanır (ziyaretçi yine de değiştirebilir). Desteklenen dil kodları için bkz. Açık API'ye genel bakış.
  • İsteğe bağlı data-language="auto": Sayfanın <html lang> değeri varsayılan dil olarak alınır; sayfa dili sonradan değiştiğinde (lang özniteliği değişir, tek sayfa uygulamalarında sayfayı yenilemek gerekmez) müşteri hizmetleri penceresi otomatik olarak buna uyar.

Sayfada şu yöntemleri çağırabilirsiniz:

Yöntemİşlev
AICS.open() / AICS.close() / AICS.toggle()Müşteri hizmetleri penceresini açar, kapatır; örneğin "Bize ulaşın" düğmesine bağlayabilirsiniz
AICS.identify(userToken)Müşteri giriş yaptıktan sonra müşteri hizmetlerine kim olduğunu bildirir (bkz. Giriş yapan müşterileri tanımlama)
AICS.setLanguage(code)Site dil değiştirdiğinde çağırın; müşteri hizmetleri penceresi ve sonraki yanıtlar bu dile geçer, örneğin AICS.setLanguage("ja"); zh-Hans, pt-BR gibi yazımlar da kabul edilir
AICS.reset()Müşteri çıkış yaptığında çağırın: müşteri hizmetleri penceresini kaldırır, mevcut oturumu siler; betiği yeniden yüklediğinizde anonim yeni bir pencere açılır, sonraki kişi öncekinin konuşmasını göremez

Dil

  • Müşteri hizmetleri penceresi, ziyaretçinin bulunduğu yere (IP) göre ilgili dili gösterir; buna arayüz metinleri ve karşılama mesajı da dahildir. data-language ayarlanmışsa sayfa dili önceliklidir. Konum belirlenemezse arka panelde ayarlanan "Varsayılan dil" kullanılır.
  • AI, müşterinin kullandığı dilde yanıt verir; müşterinin yazdıklarından dil anlaşılamıyorsa (emoji, sipariş numarası) yukarıda belirlenen dil kullanılır.
  • Müşteri, pencerenin üst kısmındaki dil menüsünden dili değiştirebilir ya da doğrudan AI'ya "Lütfen İngilizce yanıtla" diyebilir. AI bundan sonra, müşteri başka bir dilde yazsa bile bu dili kullanmaya devam eder.
  • Sitenin dil değiştirmesi (AICS.setLanguage veya data-language="auto" kullanılırken <html lang> değerinin değiştirilmesi) de müşterinin seçimi sayılır; yukarıdaki yöntemlerde son yapılan geçerlidir; yalnızca sayfa açılırken gelen varsayılan dil, müşterinin daha önce seçtiği dili geçersiz kılmaz.
  • Arka panelde "Bot ayarları → Dil" bölümünden IP'ye göre dil belirlemeyi kapatabilir, varsayılan dili değiştirebilir ve hangi dillerin sunulacağını sınırlayabilirsiniz.
  • Ters proxy veya CDN arkasında dağıtım yapıyorsanız, sunucu tarafında TRUSTED_PROXIES veya COUNTRY_HEADER ayarlamanız gerekir; aksi halde ziyaretçinin gerçek IP'si alınamaz.

Bu sayfa yardımcı oldu mu?

Son güncelleme: