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.

WordPress panelinde Eklentiler → Yeni Ekle → WPCode (eski adıyla "Insert Headers and Footers") eklentisini kurup etkinleştirin.
Code Snippets → Header & Footer bölümünü açın.
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 });

✅

Doğrulama: Kaydedip sitenizi açın; sağ altta sohbet balonu belirir. Görünmüyorsa ilk şüpheli önbellek eklentisidir (WP Rocket, LiteSpeed, W3 Total Cache…) — önbelleği temizleyin. Bir soru sorup cevap gelmesi widget'ın; sipariş/stok sorusuna gerçek veri gelmesi ise WooCommerce veri bağlantısının kurulu olduğunu gösterir.

🔑

data-tenant-id = SemAgent hesabınızın slug'ı (panelde görünür). data-type yazmazsanız tenant'ın varsayılan modu kullanılır. Renk/konum/karşılama için data-color, data-position, data-welcome, data-language nitelikleri eklenebilir.

2. Persona & görünüm

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

Ayar	Ne yapar
Asistan adı	Sohbet başlığında görünen isim (ör. "Ada — Destek").
Ton	Cevap üslubu (ör. samimi-profesyonel, resmi).
Ana renk	Balon ve vurgu rengi — markanıza göre.
Karşılama mesajı	Widget açıldığında ilk gösterilen metin.

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.

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.

Bu sayfa yardımcı oldu mu? Geri bildirim gönder

← Önceki Shopify & e-ticaret Sonraki → Widget Chat API