Widget kurulum & persona

Widget'ı sitenize gömdükten sonra markanıza uydurun: adı, tonu, rengi, karşılaması ve bilmediği sorularda ne yapacağı sizin elinizde. Değişiklikler anında yayına yansır.

1. Embed (özet)

Kurulum tek satırdır — ayrıntılı adımlar Quickstart'ta:

<script src="https://semagent.ai/static/widget.js"
        data-tenant-id="sirket-slug" defer></script>

WordPress & WooCommerce'e ekleme

WooCommerce bir WordPress eklentisidir; dolayısıyla widget'ı eklemek, WordPress'e yukarıdaki <script> satırını koymaktan ibarettir — WooCommerce'e özel bir eklenti gerekmez. İki ayrı işi karıştırmayın:

• Balonu siteye koymak — bu bölüm (script gömme).
• Canlı sipariş/stok verisine erişim — panelde Ayarlar → E-Ticaret → WooCommerce'e Consumer Key/Secret girmek (ayrı adım; anahtar üretirken "Okuma" izni yeterlidir). Bkz. Shopify & e-ticaret.

E-ticaret modunu (canlı mağaza cevapları) açmak için script'e data-type="ecommerce" ekleyin:

<script src="https://semagent.ai/static/widget.js"
        data-tenant-id="sirket-slug" data-type="ecommerce" defer></script>

Yöntem 1 — Header/Footer eklentisi (önerilen)

En sağlamı; tema güncellemesinden etkilenmez, kod bilmeyi gerektirmez.

1. WordPress panelinde Eklentiler → Yeni Ekle → WPCode (eski adıyla "Insert Headers and Footers") eklentisini kurup etkinleştirin.
2. Code Snippets → Header & Footer bölümünü açın.
3. Yukarıdaki script satırını Footer (Alt Bilgi) alanına yapıştırıp Kaydet deyin.

Yöntem 2 — Tema özel kod / Özel HTML alanı

Birçok tema (Astra, GeneratePress, Kadence, OceanWP…) kendi özel-kod alanını sunar: Görünüm → Özelleştir altında Özel HTML / "Footer Scripts" / "Custom Code" alanına aynı satırı yapıştırın. Site genelinde görünen bir Özel HTML bloğu/aracı da çalışır.

Yöntem 3 — Geliştiriciyseniz (functions.php)

Mutlaka child theme kullanın — aksi hâlde tema güncellemesi kodu siler.

add_action('wp_footer', function () { ?>
  <script src="https://semagent.ai/static/widget.js" data-tenant-id="sirket-slug" data-type="ecommerce" defer></script>
<?php });

2. Persona & görünüm

Widget → Görünüm altından:

“SemAgent” imzası: Pro ve üstü planlarda (Shopify App Store'dan gelen mağazalarda Showroom ve Flagship paketlerinde) widget'ın altındaki “Yanıtlar: SemAgent” satırını RAG Widget ya da E-Ticaret Widget ekranındaki “SemAgent” imzasını gizle anahtarıyla kaldırabilirsiniz; ayar iki widget için de geçerlidir. Plan düşerse imza yeniden görünür. Paketiniz imzayı gizlemiyorsa anahtarın altında hangi planlarda açık olduğu yazar.

Cevap dili

Widget ziyaretçinin diliyle açılır: Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, İtalyanca, Felemenkçe, Rusça ya da Portekizce; öteki dillerde İngilizce. Shopify mağazanızda mağazanın dilini kullanır. Tarih, saat ve fiyat o dilin biçimiyle yazılır. Karşılama mesajını boş bırakırsanız o dilde hazır bir karşılama görünür; yazarsanız her dilde yazdığınız gibi görünür.

Asistan müşterinin yazdığı dilde cevap verir; dil her mesajdan ayrı anlaşılır. Mesaj dili belli etmiyorsa (ör. yalnız bir sipariş numarası) widget'ın dili, o da yoksa hesabınızın dili kullanılır. Sunucudan gelen hazır cümleler (insana devir sözü, mesai dışında ekibin ne zaman döneceği dahil; hata metinleri; sessiz kalan müşteriye sorulan soru) widget'ın dokuz dilinde yazılmıştır: widget'ın dilinde gider, ziyaretçi Türkçe ya da İngilizce yazarsa o dilde. Sipariş sorgusunun hazır cümleleri (sipariş numarası, e-posta ve doğrulama kodu istemleri) şimdilik Türkçe ve İngilizcedir: konuşma Türkçeyse Türkçe, değilse İngilizce gider. Talimat alanınız boşsa İngilizce konuşmalarda İngilizce persona kullanılır. Asistanın hep tek bir dilde cevap vermesini istiyorsanız bunu talimatınıza yazın (ör. “Tüm yanıtları Türkçe ver”).

3. KB-dışı soru davranışı

Ziyaretçi bilgi tabanınızın kapsamı dışında bir şey sorduğunda widget'ın ne yapacağını seçersiniz:

• Kibarca reddet — "Bu konuda bilgim yok" (strict-KB varsayılanı; uydurmaz).
• Yönlendir — ilgili sayfaya/iletişime yönlendir.
• İnsana eskale et — konuşma özetiyle destek ekibine devret.

4. Pre-chat formu

İsterseniz sohbet başlamadan ad / e-posta / telefon toplayın. Hangi alanların isteneceği yapılandırılabilir (widget_prechat_fields); eskalasyonda bu bilgi insan desteğe iletilir. API tarafı: widget-settings.

5. Konuşma geçmişi & CSAT

• Sayfa yenilense de sohbet sürer — conversation_id ile geçmiş geri yüklenir.
• Konuşma sonunda memnuniyet puanı (CSAT) toplanır; kalite ölçümü için panelde birikir. 1–2 puanda ekibinize e-posta gidebilir: Düşük puanda haber ver.
• Görüşme bir insana geçtiğinde (devralındı ya da ekip bekleniyor) widget panele canlı bağlanır: temsilcinin yanıtı ve “yazıyor” işareti anında görünür.

Widget modları

Widget iki modda çalışır: RAG (bilgi tabanı cevapları) ve e-ticaret (canlı mağaza verisi). Varsayılan modu seçebilir veya type ile isteğe göre belirleyebilirsiniz — bkz. Shopify & e-ticaret.