Otomasyon - Ideasoft JavaScript SDK Fonksiyonları

1-) Ideasoft Entegrasyonu ve JS Fonksiyonları

Bu bölüm, Supsis Ai Otomasyon modülündeki JavaScript bloğu (Run JavaScript) içerisine Ideasoft e-ticaret entegrasyonu için eklenen yeni SDK fonksiyonlarının kullanımını içerir. Bu fonksiyonlar sayesinde otomasyon akışlarınızda terk edilmiş sepetleri (abandoned carts) listeleyebilir, sepet içindeki ürün detaylarını çekebilir ve üye bilgilerini farklı parametrelerle kolayca sorgulayabilirsiniz.

1.a – Ön Koşul: Ideasoft Kanal Bağlantısı

Bu fonksiyonları otomasyonda kullanabilmek için Ideasoft OAuth entegrasyonunun tamamlanmış olması gerekir.

  • a – Ideasoft Kanal Ayarları:
    Ayarlar > Entegrasyonlar sayfasından Ideasoft kanalınızın bağlı ve aktif durumda olduğundan emin olun. SDK fonksiyonlarında kullanılacak channelId bu kanalın ID'si olmalıdır.

1.b – Otomasyon Editörü ve Autocomplete Desteği

Otomasyon içerisinde bir JavaScript bloğu eklediğinizde, yazımı hızlandırmak ve hataları önlemek için otomatik tamamlama özelliği devreye girer.

  • b – SDK Namespace ve Öneriler:
    Editöre supsis.ideasoft. yazdığınız anda abandonedCart ve member modülleri autocomplete ile önerilir ve ilgili kod parçacıkları (snippet) sayfa/limit değişkenleriyle birlikte otomatik tamamlanır.

1.c – Terk Edilmiş Sepetleri Listeleme (Abandoned Cart)

Müşterilerin sepette bıraktığı ürünleri tespit etmek ve detaylarına ulaşmak için kullanılır.

  • c – abandonedCart.list Fonksiyonu:
    await supsis.ideasoft.abandonedCart.list('ideasoftKanalId', { page: 1, limit: 20 }) komutuyla çalışır. Limit maksimum 20 olabilir. Sistem arka planda sepetleri en yeniden en eskiye doğru (sort: -id) otomatik olarak sıralar.
  • d – Ürün Detayları ve URL:
    Dönen cart.items verisi içinde ürünün adı, SKU kodu, fiyatı, adeti ve müşteriye mesajla iletilebilecek doğrudan productUrl (ürün linki) bilgileri yer alır. (Not: Her sayfa için sepet detayı ve link bilgisi adına arka planda ek API istekleri atılır).

1.d – Üye Bilgisi Sorgulama (Member Get)

Belirli bir e-ticaret üyesinin profil detaylarına hızlıca ulaşmak için kullanılır.

  • e – member.get Fonksiyonu ve Otomatik Algılama:
    await supsis.ideasoft.member.get('ideasoftKanalId', 'identifier') komutuyla çalışır. identifier alanına üye ID'si ('270488'), e-posta adresi ('musteri@email.com') veya telefon numarası ('905551234567') yazabilirsiniz. Sistem veri tipini otomatik olarak analiz eder ve ilgili üyeyi bulur (Üye bulunamazsa null döner).

1.e – Örnek Kullanım Senaryoları

Ideasoft SDK fonksiyonları ile e-ticaret dönüşümlerinizi artıracak şu senaryoları uygulayabilirsiniz:

  • Terk Edilmiş Sepet Hatırlatmaları: Her gün sepetleri sorgulayıp, ürün adı ve linkini (productUrl) mesaj şablonuna dinamik olarak yerleştirerek WhatsApp üzerinden otomatik hatırlatma mesajları gönderebilirsiniz.
  • Filtreli Aksiyonlar: Dönen sepet verilerinde mailStatus === 0 (henüz mail gönderilmemiş sepetler) filtresi uygulayarak yalnızca ilgili müşterilere SMS veya mail atabilirsiniz.
  • Esnek Profil Doğrulama: Sepet hatırlatması öncesi veya sonrasında üyenin sadece e-posta adresiyle detaylı profilini sorgulayıp pazarlama izinlerini (KVKK/İYS) otomasyon akışında kontrol edebilirsiniz.