İkas WhatsApp Entegrasyonu: Olay Kaynakları, SPA Tema Farkı ve Kurulum

İkas kullanan bir mağazada WhatsApp kurulumu ilginç bir asimetri taşır. API tarafı modern ve rahat çalışılan bir yüzeydir: sipariş ve müşteri verisine ulaşmak, olay bildirimi kurmak zahmetli değildir. Tema tarafı ise React ile yazılmış bir tek sayfa uygulamasıdır ve klasik "siteye bir script yapıştır" mantığı burada beklendiği gibi davranmaz.

Sonuç şu: ikas'ta sipariş ve kargo akışlarını kurmak, kapalı kaynak altyapılara göre belirgin biçimde kolay. Buna karşılık sepet terki ve stok talebi gibi tarayıcı içinde doğan olaylar, temanın çalışma biçimini bilmeyi gerektiriyor. Bu yazı ikisini de anlatıyor.

İkas WhatsApp entegrasyonu nasıl çalışır?

Entegrasyon iki katmandan oluşur ve bu ayrım ileride altyapı değiştirmeyi düşünüyorsanız önemlidir.

• Mesaj katmanı ikas'ı tanımaz. Şablonlar, izin havuzu, ret listesi, bekleme süreleri ve akış kuralları modülün kendi tarafındadır. Altyapı değişse bu katman olduğu gibi kalır.
• Bağlantı katmanı ikas'a özeldir. Uygulama panelden yetkilendirilir, olay abonelikleri tanımlanır, eksik alanlar GraphQL sorgusuyla tamamlanır. Kurulum emeği burada yoğunlaşır.

Yani modül ikas'ın içine gömülmez, dışında çalışır. Bu, mağazanın gelecekteki kararlarını serbest bırakır: altyapı değiştirirseniz mesaj kurgunuz sıfırlanmaz, yalnızca olayın okunduğu kaynak yeniden bağlanır.

İkas'ta olay iki kaynaktan gelir

Sağlıklı bir kurulum tek kaynağa yaslanmaz. Bildirim tetikler, sorgu doğrular.

Pratikte kurgu şöyle olur: bildirim düştüğünde mesaj hazırlanır, ama gönderimden hemen önce siparişin güncel hali sorgulanır. Bu ikinci adım, iptal edilmiş veya iade sürecine girmiş siparişe kargo mesajı gitmesini engeller. Ek olarak günde bir kez çalışan bir tarama, bildirimi kaçmış kayıtları yakalar; bu tarama olmazsa kısa bir kesinti kalıcı bir boşluğa dönüşür.

Jeton ömrü: sessiz kopmanın bir numaralı sebebi

İkas bağlantısında erişim jetonu süreklidir sanılır, oysa ömrü sınırlıdır ve düzenli yenilenmesi gerekir. Yenileme bir gün başarısız olduğunda hiçbir hata ekranı görmezsiniz. Sipariş verilmeye devam eder, mesaj gitmez ve bu genelde bir müşteri "kargo bilgisi gelmedi" diye yazdığında fark edilir.

Kurulumun ayrılmaz parçası, jeton yenilemesinin izlenmesi ve başarısız olduğunda uyarı üretmesidir. Aynı ilke akış bazında da uygulanır: belirli bir süre hiç olay gelmediğinde tetiklenen basit bir kontrol, hem jeton hem abonelik kaynaklı kesintileri birlikte yakalar.

İkas WhatsApp bildirimi hangi olaylarda gider?

Sipariş durumu ile paket durumu aynı şey değildir

İkas'ta bir siparişin genel durumu ile o siparişe ait gönderi paketinin durumu ayrı ayrı tutulur. Kargo bildirimini siparişin genel durumuna bağlayan kurulumlar iki tür hata üretir: mesaj ya erken gider (sipariş hazırlanıyor durumuna geçti ama paket henüz kargoya verilmedi) ya da hiç gitmez (paket kargoya verildi ama sipariş durumu operasyon tarafından güncellenmedi).

Doğru davranış, paket durumunu ve takip numarasının dolmasını birlikte beklemektir. Çok paketli siparişlerde ise bir karar vermeniz gerekir: her paket için ayrı mesaj mı, yoksa ilk hareket edende tek mesaj mı? Müşteri tarafında ikincisi daha iyi karşılanıyor; parça parça giden bildirimler kargo takibini kolaylaştırmıyor, sadece bildirim sayısını artırıyor. Kargo mesajının içeriğini nasıl kurguladığımızı kargo bildirimi kurulumu yazısında ayrıntılandırdık.

İkas sepet hatırlatma WhatsApp akışı: SPA temanın getirdiği fark

İkas temaları React tabanlıdır ve mağaza bir tek sayfa uygulaması gibi çalışır. Kategori listesinden ürüne, oradan sepete geçerken tarayıcı sayfayı baştan yüklemez; bileşenler yeniden çizilir. Bu davranış, klasik yöntemle yazılmış bir izleme kodunu işlevsiz bırakır: kod ilk açılışta bir kez çalışır ve sonraki gezinmelerde hiç tetiklenmez.

Doğru kurulum üç şey yapar:

1. Rota değişimini izler. Sayfa yükleme olayına değil, uygulama içi gezinmeye bağlanır. Aksi halde müşterinin ikinci üründe sepete attığı ürün hiç kaydedilmez.
2. Sepet içeriğini değil değişimini gönderir. Her ekranda tüm sepeti göndermek gereksiz istek üretir; yalnızca değişiklik anında bildirim yeterlidir.
3. Hedef bulunamazsa sessizce çekilir. Tema sürümü yükseltildiğinde bileşen yapısı değişebilir. Kod, beklediğini bulamadığında sayfayı bozmadan devre dışı kalmalıdır; sepet akışının durması, mağazanın ürün sayfasının kırılmasından çok daha ucuz bir sorundur.

Kodun mağazaya nasıl sokulacağı ayrı bir karar. Etiket yöneticisi üzerinden eklemek tema sürümünden bağımsız kalmayı sağlar ve bir sorunda etiketi duraklatarak geri dönmeyi kolaylaştırır; temanın kaynak koduna bileşen olarak eklemek ise daha temiz ve daha hızlı sonuç verir ama her tema güncellemesinde taşınması gerekir. İkas tema mimarisinin ayrıntılarını ve bu iki yolun karşılaştırmasını ikas Trendyol yorum aktarma yazısında da ele almıştık; oradaki kısıtlar burada da geçerli. Sepet mesajının kendisini nasıl yazdığımızı ise sepet hatırlatıcı modülü sayfasında anlattık.

İzin verisi ikas'ta nerede durur?

İkas müşteri kaydında pazarlama izni için alanlar bulunur, ancak kanal bazında WhatsApp'a karşılık gelen yerleşik bir alan beklemeyin. İzni doğru saklamanın yolu, onu tek bir doğru-yanlış değeri olarak değil bir kayıt olarak tutmaktır: numara, onay tarihi ve saati, onayın alındığı ekran, o gün gösterilen metnin sürümü.

İzin toplamanın pratik yerleri şunlar:

• Üyelik formu: En temiz yer burasıdır, ama forma yeni bir onay kutusu eklemek ikas'ta tema tarafında iş demektir. Etiket yöneticisiyle sonradan kutu enjekte etmek çalışır görünse de kırılgandır ve denetimde savunması zordur.
• Ödeme adımı: Sipariş sırasında alınan onay, hem işlem bildirimleri hem pazarlama için ayrı ayrı sorulmalıdır. Kutular varsayılan olarak işaretli gelmemelidir.
• Sipariş sonrası: Teşekkür sayfasında veya ilk WhatsApp mesajında verilen açık onay seçeneği, form uzatmadan izin toplamanın en az sürtünmeli yoludur.

İşlem bildirimi ile pazarlama mesajının izin gereksinimi farklıdır ve bu ayrım veri modeline yansımalıdır. Ayrımın hukuki dayanağını ticari mesaj, İYS ve KVKK rehberinde ele aldık.

Yerli altyapı olmasının entegrasyondaki gerçek karşılığı

İkas'ın Türkiye'de geliştirilmiş bir altyapı olması pazarlama söyleminde sık geçiyor; entegrasyon tarafında ise somut ve ölçülebilir üç karşılığı var.

• Kargo firmaları ve durum adları yerel pratiğe göre kurulu. Türkiye'deki kargo firmalarının durum akışı altyapıya tanımlı geldiği için mesaj tetikleyicilerini bu adlara eşlemek, uluslararası bir altyapıda aynı işi yapmaktan daha az uğraştırır.
• Saat dilimi ve tatil takvimi aynı. Gönderim saatlerini planlarken kaynak veri ile mesaj katmanı arasında saat dilimi dönüşümü yapmak gerekmez. Bu, gece yarısı gönderilen doğum günü mesajı gibi klasik hataların bir kaynağını baştan kapatır.
• Destek aynı gün ve aynı dilde. Entegrasyon sorunlarının önemli bir kısmı platform tarafındaki bir ayarla çözülür. Yetkinin açılması ya da bir davranışın teyit edilmesi için beklenen sürenin kısalması, kurulum takvimini doğrudan etkiler.

Buna karşılık yerli olmak, tema tarafındaki SPA kısıtını ortadan kaldırmaz. İki hazır altyapı arasında karar veriyorsanız ikas mı Shopify mi karşılaştırmamız bu tür farkları başlık başlık ele alıyor.

İkas WhatsApp entegrasyonu kurulumu adım adım

1. Akış listesini çıkarın. Hangi olaylar için mesaj gideceğine karar verin; abonelikler ve şablonlar bu listeden türetilir.
2. Uygulamayı yetkilendirin. Sipariş, müşteri ve gönderi okuma yetkileri verilir; kullanılmayan yetki istenmez.
3. Jeton yenilemesini ve izlemesini kurun. Bu adım atlanırsa entegrasyon çalışır, sonra bir gün sessizce durur.
4. Durum eşleme tablosunu yazın. Sipariş durumu ve paket durumu ayrı ayrı ele alınır; hangi durumun hangi mesajı tetiklediği belgelenir.
5. Telefon verisini temizleyin. Müşteri kartı ve teslimat adresi numaraları tek biçime çevrilir; hangi akışın hangisini kullanacağı yazılır.
6. Sepet kodunu bağlayın. Rota değişimini izleyen kod etiket yöneticisi ya da tema bileşeni olarak eklenir.
7. İzin kaydını kurun. Onay tarihi ve metin sürümü birlikte saklanır; ret listesi merkezî tutulur.
8. Çakışan ikas bildirimlerini düzenleyin. Aynı olay için iki kanaldan bildirim gitmemelidir.
9. Tekilleştirme anahtarını tanımlayın. Sipariş kimliği ile olay türünün birleşimi, tekrar gelen bildirimlerde ikinci mesajı engeller.
10. Test siparişiyle doğrulayın. Sipariş verin, paketi kargoya verin, sonra iptal edin; kuyruktaki mesajın durduğunu görün.

İkas WhatsApp entegrasyonu fiyatları neye göre belirlenir?

Tek bir rakam vermek doğru olmuyor; aynı modül iki mağazada farklı büyüklükte bir kuruluma dönüşebiliyor. Fiyatı belirleyen kalemler:

Teklif alırken hangi akışları açacağınızı listeleyip fiyatı onun üzerinden sormak, paket adı üzerinden sormaktan daha isabetli sonuç verir. İkas tarafında tema ve tasarım ihtiyacınız da varsa ikas lisans ve tasarım hizmeti kapsamında birlikte planlanabilir.

Kurulumdan sonra sessizce bozulan üç şey

• Jeton yenilemesinin durması. En sık görülen ve en geç fark edilen kesinti. İzleme kurulmadıysa günlerce sürebilir.
• Tema sürümü yükseltmesi. Sepet kodu yeni bileşen yapısında hedefini bulamaz. Sipariş ve kargo çalışmaya devam ettiği için sorun gözden kaçar.
• Operasyon akışının değişmesi. Depo ekibi paket oluşturma sırasını değiştirdiğinde kargo mesajının tetiklendiği an kayar. Bu teknik bir arıza değildir, ama sonuç aynıdır: mesaj yanlış zamanda gider.

Özet

İkas'ta WhatsApp entegrasyonunun API tarafı rahat, tema tarafı dikkat ister. Sipariş ve kargo akışları olay bildirimiyle anlık beslenir; kargo mesajı sipariş durumuna değil paket durumuna bağlanmalıdır. Sepet ve stok talebi gibi tarayıcı içi olaylar, tek sayfa uygulaması davranışını hesaba katan bir kodla toplanır. Jeton yenilemesi izlenmediğinde entegrasyon hata vermeden durur; bu yüzden sessizlik alarmı kurulumun ayrılmaz parçasıdır. Kurulumu STools yapar, mağaza tarafında kod yazmanız gerekmez. Kendi mağazanız için hangi akışların anlamlı olduğunu konuşmak isterseniz destek@stools.digital adresinden ya da 0547 007 54 24 numarasından ulaşabilirsiniz.