Ticimax WhatsApp Entegrasyonu: SOAP Servisleriyle Olay Taşıma ve Kurulum

WhatsApp akışları anlatılırken konu genelde mesajın kendisidir: kargo çıktı bildirimi nasıl yazılır, sepet hatırlatmasında kupon verilir mi, kaç saat beklenir. Ticimax kullanan bir mağazada ise ilk somut soru çok daha erken gelir ve teknik bir sorudur: panelin içinde olan bir şeyi dışarıdaki mesaj katmanı nereden öğrenecek?

Bu sorunun Ticimax'teki cevabı, Shopify veya WooCommerce'teki cevaptan yapısal olarak farklıdır. Ticimax barındırılan ve kapalı kaynak bir altyapıdır; sunucusuna kod koyamaz, sipariş kaydedildiği anda çalışacak bir tetikleyici yazamazsınız. Olay size gelmez, siz olayı almaya gidersiniz. Bu tek cümle, kurulumun şeklini, gecikme davranışını ve bakım maliyetini birlikte belirler. Aşağıda bu mimarinin nasıl kurulduğunu, hangi noktalarda sessizce bozulduğunu ve fiyatın hangi kalemlerden oluştuğunu anlatıyoruz.

Ticimax WhatsApp entegrasyonu nasıl çalışır?

Ticimax WhatsApp entegrasyonu, mağaza panelindeki üye, sipariş, kargo ve stok verisinin WhatsApp mesaj katmanına düzenli biçimde taşınmasıdır. Burada iki ayrı sistemin birbirine bağlanmasından söz ediyoruz ve ikisinin sınırı net:

• Mesaj katmanı Ticimax'ten bağımsızdır. Şablonlar, izin havuzu, ret listesi, gönderim zamanlaması ve akış kuralları modülün kendi tarafında durur. Bu katman altyapıyı hiç tanımaz.
• Bağlantı katmanı Ticimax'e özeldir. Hangi veriyi hangi servisten, hangi sıklıkla ve hangi filtreyle okuyacağınız burada tanımlanır. Kurulum emeğinin neredeyse tamamı buradadır.

Bu ayrımın pratik sonucu şudur: ileride altyapı değiştirirseniz mesaj kurgunuz sıfırlanmaz. Şablonlar, izinler ve akış kuralları yerinde kalır; yalnızca bağlantı katmanı yeniden kurulur. Buna karşılık bağlantı katmanı Ticimax'te diğer altyapılara göre daha fazla iş ister, çünkü altyapı olayı kendiliğinden dışarı itmez.

Ticimax'te olay taşımanın üç kanalı

Bir olayın modüle ulaşmasının Ticimax'te üç yolu vardır ve üçü farklı gecikme ile farklı kırılganlık taşır.

Ticimax webhook sunmaz, servis sorgusu esastır

Ticimax'in mağazaya açtığı entegrasyon yüzeyi SOAP tabanlı web servisleridir. Panelde bir web servis kullanıcı bilgisi tanımlanır ve sipariş, üye, ürün gibi servisler bu bilgiyle sorgulanır. Bu servisler veri okumak için tasarlanmıştır; olay gerçekleştiğinde sizi arayan bir bildirim mekanizması değildir.

Bu, çoğu kişinin sandığı kadar büyük bir dezavantaj değildir, çünkü e-ticarette gerçekten saniye hassasiyeti isteyen tek akış yoktur. Sipariş onayı bir dakika sonra gitse müşteri fark etmez; kargo bildirimi zaten kargo firmasının veri güncelleme hızına bağlıdır. Belirleyici olan, sorgunun ne kadar akıllı yazıldığıdır. Her turda bütün siparişleri çeken bir kurulum hem yavaştır hem de kaçınılmaz olarak mükerrer mesaj üretir. Doğru kurgu, güncelleme tarihi başlangıcı parametresiyle yalnızca değişen kayıtları alan bir delta sorgusudur ve turlar arasında yalnızca kısa bir örtüşme payı bırakır.

Ticimax web servisi sipariş çekme: alfabetik alan sırası tuzağı

Bu bölümü atlamayın; Ticimax entegrasyonlarında en çok zaman yakan hata burada.

Ticimax servisleri WCF üzerinde çalışır ve veri sözleşmesi alanlarını alfabetik sırada bekler. Filtre nesnesindeki alanları başka bir sırayla gönderirseniz servis size hata dönmez. HTTP 200 alırsınız, yanıt gelir, her şey çalışıyor görünür. Gerçekte olan şudur: sıranın bozulduğu alandan sonraki bütün filtreler sessizce yok sayılır.

WhatsApp tarafında bunun somut karşılığı şudur. Sipariş sorgunuza koyduğunuz tarih filtresi uygulanmazsa servis size mağazanın açılışından bugüne kadarki siparişleri döndürür. Tekilleştirme katmanınız zayıfsa iki yıl önce alışveriş yapmış bir müşteriye "siparişiniz hazırlanıyor" mesajı gider. Bu, teknik bir hata olarak değil itibar kaybı olarak geri döner.

Sahada doğruladığımız iki ek davranış daha var ve ikisi de bildirim akışlarını doğrudan etkiler:

• Tek kayıt nesne, çok kayıt dizi döner. Gecenin sonunda tek sipariş gelmişse yanıt dizi değil nesnedir. Diziye normalize etmeyen bir kod, en sakin gecede çöker ve o gecenin bildirimleri hiç gitmez.
• Mantıksal alanlar metin taşır. Aktiflik veya iptal durumu gibi alanlar doğru/yanlış değerini metin olarak getirir. Doğrudan mantıksal değere çevirirseniz "false" metni de doğru sonucunu verir; iptal edilmiş siparişe kargo mesajı gitmesinin en sık sebebi budur.

Bu tuzakların aynısı Trendyol yorumlarını Ticimax'e taşırken de karşımıza çıkıyor; katalog tarafındaki karşılıklarını Ticimax Trendyol yorum aktarma yazısında ayrıca ele aldık.

Ticimax WhatsApp bildirimi hangi olaylarda gider?

Aşağıdaki tablo, sık kurulan akışların Ticimax tarafında hangi veriden beslendiğini gösteriyor. Bir akışı kurabilmenin ön şartı, o satırdaki verinin sizde temiz olmasıdır.

Tablodaki en dikkat çekici satır sipariş durumudur. Ticimax'te sipariş durumları panelden özelleştirilebilir; "Hazırlanıyor" yerine "Depoda", "Kargoda" yerine "Yola Çıktı" yazan mağazalar var. Modül bu adları tahmin edemez. Bu yüzden kurulumun bir adımı, mağazanın kendi durum adlarını akış tetikleyicilerine bağlayan bir eşleme tablosu yazmaktır. Panelde yeni bir durum tanımlandığında bu tablonun güncellenmesi gerekir; güncellenmezse o duruma düşen siparişler için hiç mesaj gitmez ve kimse fark etmez.

Ticimax sepet hatırlatma WhatsApp akışı neden ayrı çalışır?

Sepet, sipariş değildir. Müşteri ürünü sepete attığında Ticimax tarafında dışarıdan sorgulanabilir bir sipariş kaydı oluşmaz; olay tarayıcının içinde kalır. Bu yüzden sepet hatırlatıcı akışı tek altyapı kanalını kullanamaz, tema tarafına bir parça kod ister.

Kod, Tasarım menüsü altındaki Tema Yönetimi ekranında temanın JavaScript alanına eklenir. Kurulumda uyulması gereken üç kural var:

1. Canlı temaya doğrudan yazmayın. Tema Yönetimi ekranında mevcut temanın kopyasını oluşturun, kodu kopyaya ekleyin ve kopyayı yayına alın. Bir sorun çıktığında geri dönüş süresi saniyelerle ölçülür.
2. Script'i defer ile yükleyin. Ticimax temaları zaten jQuery ve birkaç eklenti taşır; render engelleyici bir script eklemek sepet sayfasının açılışını doğrudan yavaşlatır.
3. Sipariş kontrolünü servisten yapın. Hatırlatma zamanı geldiğinde mesajı göndermeden önce o üyenin siparişi olup olmadığı sipariş servisinden teyit edilmelidir. Bu tek kontrol, alışverişini tamamlamış müşteriye "sepetiniz sizi bekliyor" mesajı gitmesini engeller.

Sepet akışının mesaj tarafındaki kurgusunu, kaç saat beklenmesi ve kupon verilip verilmemesi gerektiğini terk edilen sepet kurtarma yazısında ayrıca anlattık.

Telefon numarası Ticimax'te iki ayrı yerde durur

WhatsApp'ta adres telefon numarasıdır, dolayısıyla numaranın hangi kayıttan alındığı doğrudan bir doğruluk meselesidir. Ticimax'te iki kaynak vardır ve karıştırılmaları sık görülür:

• Üye kartındaki cep telefonu: Kişinin kendi numarasıdır ve pazarlama izni bu numaraya bağlanır. Doğum günü, toplu duyuru ve kampanya akışları buradan beslenir.
• Siparişin teslimat adresindeki telefon: Paketi teslim alacak kişinin numarasıdır. Hediye gönderimlerinde üye numarasından farklıdır. Sipariş ve kargo bildirimi buraya gitmelidir; annesine hediye gönderen müşteriye değil, paketi kapıda alacak kişiye.

Bu iki numaranın aynı kişiye ait olduğu varsayımıyla kurulan akışlar, yılın en yoğun hediye dönemlerinde en çok hata üretir. Doğru kurgu, her akışın hangi numara kaynağını kullanacağını baştan yazmak ve iki numarayı da tek biçime çevirerek saklamaktır.

İzin metnini Ticimax formlarına yerleştirmek

Pazarlama akışları izinsiz çalışmaz ve izin, sonradan eklenebilecek bir şey değildir. Ticimax'te izin toplamanın pratik yeri üyelik formu ile ödeme adımındaki sözleşme ve onay alanlarıdır. Bu alanlar panelden düzenlenebilir; teknik bir geliştirme gerektirmez.

Dikkat edilecek nokta, izni tek bir doğru-yanlış değeri olarak saklamamaktır. Kayıtta numara, onay tarihi, onayın alındığı ekran ve o gün gösterilen metnin sürümü birlikte durmalıdır. İşlem bildirimi ile pazarlama mesajının izin gereksinimi farklıdır; bu ayrımın hukuki dayanağını ve İYS tarafındaki karşılığını ticari mesaj, İYS ve KVKK rehberinde madde madde açıkladık.

Ödeme adımındaki onay kutusunu varsayılan olarak işaretli bırakmak, alınan iznin geçerliliğini tartışmalı hale getirir. Kutu boş gelmeli, kullanıcı kendisi işaretlemelidir.

Ticimax WhatsApp entegrasyonu kurulumu adım adım

Sahada uyguladığımız sıra şudur. Adımların sırası önemlidir; özellikle veri temizliği kurulumdan önce yapılmazsa sonradan kat kat pahalıya gelir.

1. Web servis erişimini açın. Panelde web servis kullanıcı bilgisi tanımlanır ve sipariş, üye, ürün servislerine yetki verilir. Paketinizde kapalıysa açılması Ticimax tarafındaki bir ayardır; ajans erişimiyle çözülmeye çalışılan sorunların bir kısmı aslında budur.
2. İki akışla başlayın. Genelde kargo bildirimi ve sepet hatırlatıcı ile başlamak doğru olur: biri servis tarafını, diğeri tema tarafını test eder. Yedi akışı aynı anda açmak, bir şey bozulduğunda hangisinin bozulduğunu bulmayı zorlaştırır.
3. Sipariş durum eşlemesini yazın. Mağazanın kendi durum adları akış tetikleyicilerine bağlanır. Bu tablo kurulumun kalıcı bir belgesidir, panelde durum değiştikçe güncellenir.
4. Delta sorgusunu ve alan sırasını kurun. Filtre alanları alfabetik gönderilir, güncelleme tarihi başlangıcı ile yalnızca değişen kayıtlar alınır.
5. Tema kopyasına sepet kodunu ekleyin. Kopya tema yayına alınır, orijinal birkaç gün silinmeden bekletilir.
6. Telefon ve izin verisini standartlaştırın. Numaralar tek biçime çevrilir, izin kaydı tarih ve metin sürümüyle saklanır.
7. Çakışan panel bildirimlerini kapatın. Aynı olay için e-posta, SMS ve WhatsApp birlikte gitmemelidir.
8. Tekilleştirme anahtarını tanımlayın. Sipariş kimliği ile olay türünün birleşimi tekil anahtar olur; aynı anahtarla ikinci kez gelen kayıt mesaj üretmez.
9. Test siparişiyle uçtan uca doğrulayın. Sipariş verin, kargoya verin, sonra iptal edin. İptal sonrası bekleyen mesajın durduğunu görmeden yayına almayın.
10. Sessizlik alarmı kurun. Belirli bir süre hiç olay gelmediğinde uyaran basit bir kontrol, servis yetkisi kapandığında akışın günlerce durmasını engeller.

Ticimax WhatsApp entegrasyonu fiyatları neye göre belirlenir?

Tek bir rakam vermek doğru olmaz, çünkü iki mağazanın kurulumu aynı çıkmıyor. Fiyatı belirleyen kalemler şunlar:

Pratik bir öneri: teklif alırken "WhatsApp entegrasyonu ne kadar" diye sormak yerine hangi akışları açacağınızı listeleyip onun üzerinden sorun. Aradaki fark, aynı işin iki katı kadar fiyat farkı yaratabilir. Modül kapsamlarını ve neyin dahil olduğunu kargo bildirimi modülü gibi tekil modül sayfalarında ayrıntılı yazdık.

Altyapı değiştirirseniz kurgunuz sıfırlanır mı?

Hayır. Bu, Ticimax'ten Shopify'a veya kendi altyapımız olan RapiSoft tarafına geçmeyi düşünen mağazaların en sık sorduğu sorulardan biri. WhatsApp modülleri mağaza yazılımının içine gömülmediği için taşınma sırasında kaybedilen şey mesaj kurgusu değildir. Şablonlarınız, izin havuzunuz, ret listeniz ve akış kurallarınız yerinde kalır.

Yeniden kurulması gereken tek katman bağlantıdır: yeni altyapıda olay hangi kaynaktan okunacak, sipariş durumları nasıl eşlenecek, sepet olayı nereden gelecek. Ticimax'ten webhook destekleyen bir altyapıya geçtiğinizde bu katman genelde basitleşir, çünkü sorgulama yerine anlık bildirim devreye girer. Altyapılar arası bu farkın genel çerçevesini e-ticaret sitesi WhatsApp entegrasyonu yazısında toparladık.

Kurulumdan sonra sessizce bozulan dört şey

Bu akışların en can sıkıcı özelliği, bozulduklarında hata vermemeleridir. Sadece mesaj gitmez ve bunu haftalar sonra fark edersiniz. Ticimax özelinde en sık gördüklerimiz:

• Web servis yetkisinin kapanması. Panelde kullanıcı yetkileri düzenlenirken servis erişimi kapatılabilir. Sorgular yetkisiz döner, akış durur.
• Yeni sipariş durumunun eşleme tablosuna eklenmemesi. Operasyon ekibi yeni bir durum tanımlar, o duruma düşen siparişler bildirim almaz.
• Tema değişimi. Yeni tema yayına alınırken JavaScript alanındaki sepet kodu taşınmaz. Sipariş ve kargo çalışmaya devam ettiği için kimse fark etmez, yalnızca sepet akışı ölür.
• Kargo takip numarasının geç dolması. Sipariş kargoya verilmiş görünür ama takip numarası bir sonraki turda yazılır. Boş takip numarasıyla gönderilen mesaj müşteride karşılık bulmaz; modül bir tur beklemelidir.

Dördünün de ortak çözümü aynı: akış bazında son gönderim zamanını izleyen ve beklenen süre aşıldığında uyaran bir kontrol. Bu, kurulumun en ucuz ama en çok işe yarayan parçasıdır.

Özet

Ticimax'te WhatsApp entegrasyonu teknik olarak zor değil, ama Shopify veya WooCommerce için yazılmış rehberlerin adımları burada birebir işlemez. Olaylar dışarı itilmez, siz almaya gidersiniz; sepet gibi tarayıcı içi olaylar tema JavaScript alanından toplanır; servis çağrılarında alan sırası alfabetik olmak zorundadır ve bu kural bozulduğunda sistem hata vermeden yanlış çalışır. Kurulumu STools yapar, mağaza tarafında kod yazılmaz. Kendi durumunuz için ne gerektiğini konuşmak isterseniz destek@stools.digital adresinden ya da 0547 007 54 24 numarasından ulaşabilirsiniz.