Ideasoft JavaScript SDK Fonksiyonları

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 SDK fonksiyonlarının kullanımını içerir. Terk edilmiş sepetler, üye profili ve misafir sipariş sorgularını otomasyon akışlarında kullanabilirsiniz.

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, member ve order modülleri önerilir. order.listByGuestQuery için Monaco snippet henüz eklenmemiş olabilir; metot mevcuttur — aşağıdaki kod örneğini kullanın.

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 – Misafir Sipariş Sorgulama (order.listByGuestQuery)

Üye kaydı olmayan (misafir checkout) siparişleri otomasyonda sorgulamak için kullanılır. Chatbot tarafındaki Misafir Sipariş / Kargo Sorgula bloğu ile aynı Ideasoft GET /api/orders uç noktasını kullanır.

var channel = await supsis.channel.getByType("ideasoft");
var orders = await supsis.ideasoft.order.listByGuestQuery(channel._id, {
  customerEmail: "musteri@ornek.com"
});
// veya yalnızca referans id:
// transactionId: "REFERANS_ID"

• query: { customerEmail?: string, transactionId?: string } — en az biri zorunlu; ikisi doluysa transactionId önceliklidir.
• Dönüş: Zenginleştirilmiş sipariş dizisi (kargo takip URL, shipment detayı vb.).
• Chatbot karşılığı: Misafir Sipariş / Kargo Sorgula (8.e).

1.f – Ö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.
• Misafir sipariş takibi: listByGuestQuery ile e-posta veya ödeme referans id üzerinden sipariş listesi alıp SMS/mail/ticket adımlarına bağlayabilirsiniz.