IdeaSoft WhatsApp Entegrasyonu: Kurulum Yolu ve Bakım Maliyeti

IdeaSoft kullanan bir mağazada WhatsApp bildirimlerini kurmak teknik olarak zor bir iş değil. Zor olan, kurulumun bir yıl sonra da çalışıyor olmasını sağlamak. Bu ayrımın sebebi, WhatsApp entegrasyonunun sessizce bozulabilen birkaç parçaya sahip olmasıdır: Meta tarafında bir şablon devre dışı bırakılabilir, telefon numarası biçimi mesajları görünmez şekilde düşürebilir ve IdeaSoft tarafında API jetonunun süresi dolabilir.

Bu yazı, kurulumun kendisinin yanında bu bakım kalemlerini de anlatıyor. Genel WhatsApp prensiplerini e-ticaret sitesi WhatsApp entegrasyonu rehberinde ele almıştık; buradaki odak IdeaSoft'a özgü kararlar.

Kurgunun üç parçası

Entegrasyonu tek bir bütün olarak düşünmek yerine üç parçaya ayırmak, hem kurulumu hem sonraki bakımı kolaylaştırır:

1. Olay kaynağı: IdeaSoft tarafındaki sipariş ve üye verisi. "Sipariş alındı", "kargoya verildi", "yeni üye kaydoldu" buradan okunur.
2. Karar katmanı: Hangi olayda, kime, hangi şablonla, ne zaman mesaj gideceği; izin kontrolü de burada.
3. Gönderim: WhatsApp Business API üzerinden onaylı şablonun gönderilmesi.

Bu ayrımın somut faydası şu: ikinci ve üçüncü parça platformdan bağımsızdır. Altyapı değiştirirseniz şablonlarınızı ve izin geçmişinizi baştan kurmanız gerekmez; yalnızca birinci parça, yani mağazadan veri okuyan bağlantı yeniden yapılandırılır.

IdeaSoft API ve jeton yönetimi

IdeaSoft tarafında API erişimi jeton tabanlıdır ve jetonun ömrü sınırlıdır. Bu, kurulum sırasında fark edilmeyen ama sonradan en çok soruna yol açan konudur.

Sorunun biçimi şudur: kurulum yapılır, test edilir, çalışır. Bir süre sonra jetonun süresi dolar ve yenileme kurgulanmamışsa entegrasyon durur. Panelde hata görünmez, mağaza sahibi için hiçbir şey değişmemiştir; yalnızca müşterilere mesaj gitmez. Bu sessizlik yüzünden durum günlerce fark edilmeyebilir ve fark edildiğinde geriye dönük gönderilemeyecek yüzlerce bildirim birikmiş olur.

Kurulumda iki şey şart:

• Yenileme otomatik olmalı. Jeton süresi dolmadan arka planda tazelenmeli.
• Yenileme başarısız olursa uyarı üretmeli. Sessizce geçilen bir başarısızlık, hiç denememekle aynı sonucu verir.

Sessizce başarısız olan bir adım, gürültülü şekilde başarısız olan bir adımdan her zaman daha pahalıdır.

Şablon onayı neden ilk iş?

WhatsApp Business API'de, müşteri size yazmadan önce gönderilen her mesaj onaylı bir şablon olmak zorundadır. Şablonlar Meta tarafından incelenir; onay birkaç dakikadan birkaç güne kadar sürebilir.

Planlamaya etkisi doğrudan: kampanya sabahı yazılan şablon o gün çalışmayabilir. Şablonlar kurulumun başında hazırlanıp onaya gönderilir, teknik bağlantı onay beklenirken kurulur.

İkinci ayrıntı: şablondaki değişkenlerin sayısı ve sırası onaydan sonra değiştirilemez. "Sayın {{1}}, {{2}} numaralı siparişiniz kargoya verildi" olarak onaylanmış bir şablona sonradan üçüncü değişken ekleyemezsiniz; yeni şablon açıp yeniden onaya göndermek gerekir. Hangi bilginin mesajda geçeceği baştan kararlaştırılmalıdır.

Hangi olaylarda mesaj gitmeli?

Teknik olarak her sipariş durumu değişikliğinde mesaj gönderebilirsiniz; pratikte bu müşteriyi rahatsız eder ve engellenmeye yol açar. Anlamlı eşikler:

Telefon numarası: en sık görülen sessiz hata

Kurulumdan sonra "mesajlar gitmiyor" şikâyetlerinin büyük çoğunluğu numara biçiminden kaynaklanır. Müşteriler numarayı olabilecek her biçimde girer: başında sıfırla, boşluklu, parantezli, ülke kodsuz.

WhatsApp uluslararası biçim bekler ve normalize edilmemiş numaralar için gönderim hata vermeden başarısız olur. Numaralar gönderim öncesi tek biçime çevrilmelidir.

Kurulumdan sonra bakılacak ilk sayı gönderim sayısı değil, teslim oranıdır; gönderilen ile ulaşan arasındaki fark bu sorunun büyüklüğünü gösterir.

İzin: metin değil, kayıt ve geri alma

İzin konusunda sık yapılan hata, izin metnini yazıp bırakmaktır. Asıl önemli olan kaydın kendisidir: hangi müşteri, hangi tarihte, hangi metinle, hangi kanaldan onay verdi. Sonradan bir itiraz geldiğinde dayanağınız bu kayıttır.

Çoğu zaman atlanan taraf ise geri almadır. Müşteri "artık mesaj istemiyorum" dediğinde bunun otomatik işlenmesi gerekir. Elle işlenen bir opt-out er ya da geç unutulur; unutulduğu anda gönderilen mesaj hem şikâyete hem gönderici numaranın kalite puanının düşmesine yol açar. Kalite puanı düştüğünde günlük gönderim limitiniz kısılır — yani tek bir unutulan opt-out, bütün bildirim akışınızı etkileyebilir.

Mesaj bedeli modül ücretine dahil değildir

Baştan netleşmesi gereken ayrım: modül bedeli yazılımın kullanım ücretidir. Mesajın kendisini Meta faturalandırır ve ayrıca mesaj paketi alınması gerekir.

Bu söylenmediğinde fatura beklenenden yüksek görünür; satış sonrası en sık yaşanan anlaşmazlık budur. Bütçe için basit bir hesap yeterli: aylık sipariş sayısı × senaryo başına mesaj adedi, artı kampanya gönderimleri.

Kurulumdan sonra sessizce bozulan dört şey

• Jeton süresi. Yenileme kurgulanmamışsa entegrasyon bir gün durur ve panelde hata görünmez.
• Şablon reddi. Meta bir şablonu sonradan devre dışı bırakabilir; o senaryodaki mesajlar durur. Fark etmenin tek yolu gönderim raporudur.
• Numara kalitesi. Çok sayıda engellenme veya şikâyet kalite puanını düşürür ve günlük limiti kısar. Bildirim sıklığını abartmamak teknik bir gerekliliktir.
• Durum adı değişikliği. Sipariş durumları IdeaSoft tarafında yeniden adlandırıldığında o duruma bağlı otomasyon eşleşmeyi kaybedebilir. Durum adları değiştiğinde kurallar gözden geçirilmelidir.

Özet

IdeaSoft'ta WhatsApp entegrasyonunun kurulumu üç parçaya ayrılarak sağlamlaşır: olay kaynağı, karar katmanı, gönderim. Şablonlar onay süresi öngörülemediği için ilk işte hazırlanır; telefon numaraları normalize edilir, aksi halde mesajlar hata vermeden ulaşmaz.

IdeaSoft'a özgü asıl konu jeton yönetimidir: yenileme otomatik olmalı ve başarısız olduğunda uyarı üretmelidir. Bu yazıdaki bakım kalemlerinin ortak özelliği, hepsinin sessizce bozulmasıdır — hiçbiri ekranda hata göstermez, yalnızca mesajlar gitmez. Bu yüzden kurulumun bir parçası olarak gönderim raporunun düzenli izlenmesi gerekir.