Widget JavaScript API
Sitenizden özel olaylar gönderin — akışları kendi iş olaylarınızla tetikleyin.
Widget kodu sayfanıza eklendiğinde, sayfada global bir uisapApi nesnesi hazır olur.
uisapApi.track(name, data?)
Sitenizde gerçekleşen bir iş olayını widget'a bildirir. Adı, akışlardaki Özel olay tetikleyicisinde yazdığınız adla eşleşen (büyük/küçük harf duyarsız) her olay, ilgili akışı o ziyaretçinin sohbetinde başlatır.
<script>
// Sipariş onay sayfanızda:
uisapApi.track('order_created', { orderId: 'SO-10021' });
</script>name(zorunlu) — olay adı. Akış düzenleyicideki Özel olay düğümüne aynı adı yazın.data(isteğe bağlı) — olayla ilgili ek bilgi. Şimdilik eşleştirmede kullanılmaz; ileriye dönük alan olarak gönderilebilir.
Erken çağrılar kaybolmaz
uisapApi.track widget yüklenmeden önce bile çağrılabilir — olaylar tamponlanır ve widget hazır olduğunda sırayla işlenir. Kod sıranız önemli değildir.
Tipik kullanım senaryoları
| Olay | Akış |
|---|---|
order_created | "Siparişiniz alındı 🎉 Kargo bilgilendirmesi ister misiniz?" |
cart_abandoned | Sepette ürün bırakan ziyaretçiye indirim kodu öner |
signup_completed | Yeni üyeye ürün turu teklif et |
payment_failed | Ödeme sorununda anında destek başlat |
Özel olay tetikleyicisinin akış tarafındaki kurulumu için Tetikleyiciler sayfasına bakın.
Kurulum kodu
Widget'ın kendisi tek satırla yüklenir; ayrıntılar için Başlarken sayfasına bakın:
<script src="https://app.uisap.dev/widget.js" data-site="SITE_TOKEN" async></script>