1.Ticimax Entegrasyonu Giriş
Supsis, Ticimax entegrasyonu sayesinde e-ticaret sitenizdeki müşteri ve sipariş bilgilerini otomatik olarak çekebilir. Bu entegrasyon, chatbot ve yapay zeka destekli hizmetler sunarak, müşteri sadakatini artırmaya, anlık veri takibi yapmaya ve satış artırma kampanyaları oluşturmanıza yardımcı olur. Ticimax ile yapılan entegrasyon, e-ticaret süreçlerinizi daha verimli hale getirir ve müşteri etkileşimini güçlendirir.
2. Otomasyonun Amacı
Bu modülün amacı, Ticimax verilerini kullanarak otomatik toplu mesaj gönderim süreçlerini yönetmektir. Entegre edilen sistemle şu üç ana işlem gerçekleştirilebilir:
- Yeni Üyeleri Getirme: Mağazanıza belirli bir tarih aralığında kaydolan yeni üyeleri listeleyebilirsiniz. Bu fonksiyon, özellikle "hoş geldin" mesajları göndermek veya günlük yeni üye raporlaması yapmak için idealdir.
- Üye Olup Alışveriş Yapmayanları Getirme: Sisteme üye olmuş ancak belirtilen zaman dilimi içerisinde hiç sipariş vermemiş pasif üyeleri tespit edebilirsiniz. Bu özellik, reaktivasyon kampanyaları ve ilk alışveriş için indirim kuponları gibi stratejilerde kullanılır.
- Sepette Ürün Unutanlar / Terk Edilmiş Sepetler: Sepete ürün ekleyip ödeme adımını tamamlamadan siteyi terk eden müşterilerin sepet bilgilerini çekebilirsiniz. Bu özellik, sepette ürün unutan müşterilere yönelik hatırlatma mesajları göndermek ve alışverişi tamamlamalarını sağlamak için kullanılabilir.
3. Genel Bakış
Bu doküman, Supsis platformu üzerinden Ticimax e-ticaret mağazanızdaki verileri çekerek yukarıda belirtilen otomasyon akışlarında kullanmanızı sağlayan güncel API altyapısını açıklar.
Önemli Not: Tüm işlemler okuma (read-only) prensibiyle çalışır. Supsis, Ticimax tarafındaki verileri yalnızca analiz ve otomasyon amacıyla çeker; mağazanızda herhangi bir veri değişikliği veya silme işlemi yapmaz.
4. Ön Koşullar ve Kurulum
Fonksiyonların çalışabilmesi için Supsis üzerinde mağazanıza ait Ticimax kanalının kurulu ve aktif olması gerekmektedir.
- Kanal Tipi:
ticimax-v2 - Gereksinim: Ticimax yönetim panelinden (Ayarlar > WS Yetki Kodu Yönetimi) oluşturulmuş geçerli bir API Yetki Kodu. (Test ve erişim kolaylığı için IP adresi alanı
*olarak tanımlanabilir).
5. API Fonksiyonları: İstek ve Dönüş Detayları
Aşağıda, Supsis ile Ticimax entegrasyonu üzerinden kullanılan üç temel API fonksiyonunun teknik detayları, istek parametreleri ve dönüş veri şemaları yer almaktadır. (Tüm isteklerde channelId sistemi tarafından otomatik olarak iletilmektedir.)
5.1. Yeni Üyeleri Getirme (getNew)
Belirli bir tarih aralığında (genellikle bulunulan gün) mağazaya kayıt olan üyeleri listelemek için kullanılır. "Hoş geldin" mesajları ve günlük yeni üye raporlamaları için idealdir.
İstek (Request) Parametreleri:
startDate(String): İsteğin başlangıç tarihi ve saati.endDate(String): İsteğin bitiş tarihi ve saati.kayitSayisi(Integer): Çekilecek maksimum kayıt limiti (Varsayılan:100).
Örnek İstek (Request Body):
Örnek Dönüş (Response Body):
5.2. Üye Olup Alışveriş Yapmayanlar (getNonBuying)
Sisteme üye olmuş ancak belirtilen zaman dilimi içerisinde hiç sipariş oluşturmamış pasif üyeleri tespit etmek için kullanılır. Reaktivasyon ve ilk alışveriş indirim kuponu kampanyaları için tasarlanmıştır.
İstek (Request) Parametreleri:
period(String): Geriye dönük sorgulanacak zaman dilimi. (Örn:7d= Son 7 gün)kayitSayisi(Integer): Çekilecek maksimum kayıt limiti (Varsayılan:100).
Örnek İstek (Request Body):
Örnek Dönüş (Response Body):
5.3. Sepette Ürün Unutanlar / Terk Edilmiş Sepetler (getAbandoned)
Sitede sepete ürün ekleyen ancak ödeme adımını tamamlamadan ayrılan müşterilerin ön sipariş durumunda kalan sepetlerini çekmek için kullanılır.
İstek (Request) Parametreleri:
period(String): Sepetin terk edildiği kabul edilen zaman dilimi. (Örn:7d= Son 7 gün)kayitSayisi(Integer): Çekilecek maksimum kayıt limiti (Varsayılan:100).
Örnek İstek (Request Body):
Örnek Dönüş (Response Body):
