Apex Bot kurulumu

Kurulum rehberi

1. Hesabınızı oluşturun ve e-postanızı doğrulayın. Çalışma alanınız ve asistanınız otomatik olarak oluşturulur.
2. Bilgi ekleyin. Apex'e web sitenizin adresini verin, sayfalarınızı okusun. İnternette olmayan bilgileri metin olarak ekleyin.
3. Panel → Widget altında widget'ı özelleştirin: isim, renkler, karşılama mesajı, üslup ve model.
4. Kurulum ve güvenlik altında web sitenize izin verin. Widget yalnızca orada listelenen adreslerde çalışır.
5. Yerleştirme kodunu sitenize yapıştırın ve bir konuşmayı denemek için sitenizi açın.

Panelinizdeki Kurulum kontrol listesi bu adımları sizin için takip eder.

Bilgi tabanı

Apex yalnızca ona verdiğiniz içerikten yanıt verir. Panel → Bilgi tabanı altında iki tür kaynak ekleyebilirsiniz:

• Web sitesi. Apex girdiğiniz sayfayı, site haritanızı ve bunların aynı alan adında bağlantı verdiği sayfaları, sayfa limitine kadar okur. robots.txt kurallarına uyar; menüleri, alt bilgileri ve çerez bannerlarını atlar. Siteniz değiştiğinde yeniden senkronize edin.
• Metin. Web sitenizde olmayan SSS'leri, politikaları veya ürün bilgilerini yapıştırın. Her birine açık bir başlık verin; bu başlık, o metni kullanan yanıtlarda kaynak olarak gösterilir.

Bilgi tabanınızdaki hiçbir şey bir soruyla yeterince eşleşmediğinde asistan tahmin yürütmek yerine bilmediğini söyler ve açtıysanız ekibinize devretmeyi önerir. Eşleşmenin ne kadar yakın olması gerektiğini Kişilik altındaki Yanıt güveni ayarı belirler.

Özelleştirme

Widget stüdyosundaki her ayarın canlı önizlemesi vardır. En önemlileri:

Değişiklikler, kaydettikten sonra yaklaşık bir dakika içinde canlı widget'ınıza yansır.

Widget'ı yükleyin

Yerleştirme kodunu Panel → Widget → Kurulum ve güvenlik ekranından kopyalayın. Kodda size özel site anahtarınız hazır olarak bulunur ve şöyle görünür:

<script src="https://api.apexbot.eu/widget.js" data-site-key="apex_pk_…" async></script>

Sohbetin görünmesini istediğiniz her sayfada kodu kapanış </body> etiketinin hemen önüne yapıştırın. Ardından ziyaretçilerin kullandığı her adresi, örneğin https://example.com ve https://www.example.com, İzinli web siteleri altına ekleyin.

Site anahtarı tasarım gereği herkese açıktır: yalnızca izin verdiğiniz web sitelerinde çalışır. Kötüye kullanıldığını düşünüyorsanız aynı ekrandan yenileyin ve sitenizdeki kodu güncelleyin.

Platformlar

WordPress

Bir header/footer kod eklentisi (örneğin WPCode) kullanarak kodu site genelindeki alt bilgiye ekleyin ya da temanızın footer.php dosyasında </body> öncesine yapıştırın.

Shopify

Online Mağaza → Temalar → Kodu düzenle yolunu izleyin, layout/theme.liquid dosyasını açın ve kodu </body> öncesine yapıştırın.

Webflow, Wix ve Squarespace

Kodu alt bilgiye site genelinde özel kod olarak ekleyin: Site settings → Custom code (Webflow), Ayarlar → Özel kod (Wix) veya Settings → Advanced → Code injection (Squarespace).

React, Next.js ve diğer tek sayfalı uygulamalar

Betiği bir kez, örneğin kök layout'unuzda yükleyin. Widget, istemci tarafı sayfa geçişlerinde konuşmayı kendiliğinden korur.

JavaScript API

Belirli bir sayfada birkaç ayarı geçersiz kılmak için isteğe bağlı olarak betik yüklenmeden önce window.Apex değerini tanımlayın:

<script>
  // İsteğe bağlı ayarlar; widget yüklenirken okunur
  window.Apex = {
    lang: "auto",                 // "auto", "tr" veya "en"
    greeting: "Merhaba! Mağazamızla ilgili her şeyi sorabilirsiniz.",
    suggestions: ["Kargo süreleri", "İade koşulları"],
    theme: { primary: "#312c85", position: "bottom-right" },
  };
</script>

Yüklendikten sonra window.Apex, widget'ı kendi kodunuzla yönetmenizi sağlar. Yüklenmeden önce yapılan çağrılar sıraya alınır ve sırayla çalıştırılır.

Apex.open()                          // sohbeti açar
Apex.close()                         // kapatır
Apex.toggle()                        // açar ya da kapatır
Apex.send("Siparişim nerede?")       // açar ve soruyu gönderir
Apex.identify({ name: "Ada", email: "ada@example.com" })

Apex.on("message", (m) => console.log(m.text, m.sources))
Apex.on("open", () => analytics.track("chat_opened"))

Gizlilik ayarları

• Konuşmalar, Kurulum ve güvenlik altında belirlediğiniz saklama süresinin sonunda otomatik olarak silinir (varsayılan 30 gün).
• Ziyaretçiler istedikleri zaman yeni bir sohbet başlatabilir; bu, eski sohbeti tarayıcılarından temizler. Kayıtlı herhangi bir konuşmayı Konuşmalar sayfasından silebilirsiniz.
• E-posta adresleri, telefon ve kart numaraları kayıtlarımızda maskelenir.
• Widget'ın alt kısmında göstermek için gizlilik politikanızın bağlantısını Mesajlar altına ekleyin.

Sorun giderme

Açılış düğmesi görünmüyor

• Sayfanın tam adresinin (www ve https dahil) İzinli web siteleri altında listelendiğini kontrol edin. Listelenmemişse tarayıcı konsolunda [Apex] Widget disabled: origin_not_allowed mesajı görünür.
• Sayfanın Davranış → Bu sayfalarda gizle altındaki yollardan birinde olmadığını kontrol edin.
• Koddaki src değerinin https://api.apexbot.eu/widget.js adresini gösterdiğinden ve site anahtarının paneldekiyle aynı olduğundan emin olun. Anahtarı yeniledikten sonra eski kod çalışmaz.

Çok sık “bilmiyorum” diyor

• Bilgi tabanı sayfasını kontrol edin: başarısız olan ya da az sayfa bulan bir web sitesi kaynağı nedenini gösterir.
• Eksik bilgileri metin kaynağı olarak ekleyin.
• Küçük bilgi tabanları için Kişilik → Yanıt güveni ayarını Esnek yapın.

Yanıtlar durdu

Kurulum ve güvenlik altındaki günlük token bütçesi dolmuş olabilir; bu durumda sohbet UTC gece yarısına kadar insana devir önerir. Sistem durumu sayfasına da göz atabilirsiniz.