WhatsApp Kargo Bildirimi Kurulumu: Hangi Olayda Ne Mesajı Gitmeli?

Bir e-ticaret mağazasında destek kanallarına düşen mesajların büyük bölümü tek bir soruya indirgenebilir: siparişim nerede? Sektörde bu talep türüne WISMO (Where Is My Order) deniyor ve çoğu mağazada gelen kutusunun en kalabalık başlığıdır. İşin can sıkıcı yanı, bu soruların neredeyse tamamının cevabının zaten sistemde hazır olmasıdır. Kargo firması paketi taramıştır, takip numarası siparişe işlenmiştir, durum bilgisi API üzerinden dönmektedir. Eksik olan tek şey, bu bilginin müşteriye o bilgi oluştuğu anda gitmesidir. Bu yazının tek konusu da bu boşluğu kapatmak: WhatsApp kargo bildirimi nasıl kurulur, hangi olay hangi mesajı tetikler ve akış hangi sırayla ayağa kaldırılır.

Bu yazı, WhatsApp kargo bildirimi akışını sıfırdan kurmak isteyen bir mağaza sahibi ya da geliştirici için yazıldı. Hangi sipariş olaylarında mesaj atılması gerektiğinden kargo firmalarının durum kodlarının nasıl normalize edileceğine, Meta tarafındaki utility şablon onayından KVKK ve İYS tarafındaki gerçek yükümlülüklere kadar uçtan uca ilerliyoruz. Ayrıca çoğu rehberde geçmeyen kısımlar da var: şablonun neden reddedildiği, hangi Cloud API hata kodunun ne anlama geldiği, aynı bildirimin iki kere gitmesini engelleyen kurgu ve 2026 sonunda devreye girecek fiyatlandırma değişikliği.

WhatsApp kargo bildirimi nasıl kurulur: akış hangi üç parçadan oluşur?

Kuruluma girmeden önce neyin kurulduğunu netleştirmek gerekiyor. WhatsApp kargo bildirimi, bir siparişin yaşam döngüsündeki belirli olaylar gerçekleştiğinde müşteriye WhatsApp üzerinden otomatik mesaj gönderen sistemdir. Teknik olarak üç parçadan oluşur ve kurulumun her adımı bu üç parçadan birine hizmet eder:

1. Olay kaynağı: E-ticaret altyapısı (sipariş oluştu, hazırlanıyor, kargolandı) ve kargo firması (teslimat şubesinde, dağıtımda, teslim edildi).
2. Kural motoru: Hangi olayda kime, hangi şablonla, ne zaman mesaj gideceğine karar veren katman. Tekrar gönderimi, saat kısıtını ve dil seçimini burası yönetir.
3. Gönderim kanalı: WhatsApp Business Platform (Cloud API) üzerinden, Meta tarafından önceden onaylanmış şablon mesajlar.

Üçüncü maddedeki şablon zorunluluğu kritiktir. WhatsApp üzerinde işletme, müşteri kendisine yazmadığı sürece serbest metin gönderemez. Müşterinin son mesajından itibaren açılan 24 saatlik müşteri hizmetleri penceresi kapalıysa, gönderilebilecek tek şey önceden onaylanmış bir şablondur. Kargo bildirimi doğası gereği işletme tarafından başlatılan bir mesajdır; dolayısıyla şablon kaçınılmazdır.

Kargom nerede sorusunun gerçek maliyeti

Uydurma yüzdelerle konuşmaya gerek yok; kendi rakamınızı çıkarmak birkaç dakikalık iş. Şu üç veriyi toplayın:

• Son 30 günde destek kanallarına (WhatsApp, telefon, mail, canlı destek) gelen toplam talep sayısı.
• Bunların içinde sipariş durumu / kargo takibi ile ilgili olanların oranı. Konu etiketiniz yoksa 100 talepten manuel örneklem alın.
• Bir talebin ortalama kaç dakika sürdüğü ve destek personelinin dakika başına maliyeti.

Çoğu mağazada bu hesabın sonucu, aylık bir kişinin tam zamanlı mesaisinin ciddi bir bölümüne denk gelir. Ancak asıl maliyet personel saati değildir. Görünmeyen kalemler şunlardır:

• Başarısız teslimat denemeleri: Müşteri paketin bugün geleceğini bilmiyorsa evde olmaz. İkinci deneme veya şubeye aktarım hem kargo maliyeti hem gecikme demektir.
• Erken iade talebi: Kargo süreci hakkında bilgi alamayan müşteri, endişeyle iade veya iptal talebi açar. Oysa paket yoldadır.
• Ödeme itirazı (chargeback): Özellikle kredi kartıyla yapılan ve uzun süre haber alınamayan siparişlerde müşteri bankaya döner.
• Tekrar satın alma kaybı: Satın alma sonrası sessizlik, marka güveninin en hızlı eridiği yerdir. İkinci siparişi engelleyen genelde ürün değil, süreç belirsizliğidir.

Hangi olaylarda mesaj atılmalı, hangilerinde atılmamalı?

Bildirim kurgusunda en sık yapılan hata, her kargo hareketinde mesaj göndermektir. Kargo firmalarının transfer merkezi hareketleri günde 3-4 kayıt üretebilir. Bunların hepsini müşteriye iletmek, bildirimlerin okunmadan kapatılmasına ve engellemeye yol açar. Aşağıdaki tablo, olay bazında önerilen davranışı özetliyor.

Pratik bir kural: bir bildirim, müşterinin yapabileceği bir eylemi tetiklemiyorsa göndermeyin. Dağıtıma çıktı bilgisi evde olmayı tetikler, transfer merkezi bilgisi hiçbir şeyi tetiklemez.

Teslim sonrası mesajlar ayrı bir kategoridir

Teslimattan 2-3 gün sonra gönderilen ürün değerlendirme daveti veya çapraz satış önerisi, kargo bildirimi değil pazarlama mesajıdır. Hem Meta tarafında marketing kategorisine girer hem de Türkiye mevzuatında ticari elektronik ileti sayılır. Bu ikisini aynı akışta karıştırmak, hem şablon onayınızı hem yasal konumunuzu riske atar. Ayrı akış, ayrı şablon, ayrı izin.

Kargo firması takip entegrasyonu: webhook mu, polling mi?

Türkiye'deki kargo firmalarının teknik olgunluğu birbirinden ciddi biçimde farklıdır. Bazıları modern REST servisleri sunarken, köklü firmaların bir bölümü hâlâ SOAP tabanlı servisler üzerinden çalışır. Bir kısmı durum değişiminde webhook gönderebilirken, çoğunda tek yol takip numarasını periyodik olarak sorgulamaktır.

Polling yapıyorsanız sabit aralık kullanmayın; kademeli sorgulama hem sunucu hem kota açısından çok daha sağlıklıdır:

• Kargoya verildikten sonraki ilk 48 saat: saatte bir sorgu.
• 3-7. günler: günde 2-3 sorgu.
• 7 günden eski ve hâlâ teslim edilmemiş gönderiler: günde 1 sorgu ve operasyon ekibine uyarı.
• Teslim edildi veya iade tamamlandı durumuna gelen gönderiler: sorgulamayı tamamen durdur.

Durum kodlarını normalize edin

Her firmanın kendi durum sözlüğü vardır ve aynı gerçek dünya olayını farklı kodlarla ifade ederler. Bildirim kurallarınızı doğrudan firma koduna bağlarsanız, yeni bir kargo anlaşması yaptığınız gün tüm akış bozulur. Doğru yaklaşım, araya kanonik bir durum modeli koymaktır:

CREATED          -> barkod oluşturuldu, henüz teslim alınmadı
PICKED_UP        -> kargo firması paketi teslim aldı
IN_TRANSIT       -> transfer / aktarma hareketleri (bildirim yok)
OUT_FOR_DELIVERY -> dağıtıma çıktı
DELIVERY_FAILED  -> adreste bulunamadı / teslim edilemedi
DELIVERED        -> teslim edildi
RETURNING        -> göndericiye iade sürecinde
RETURNED         -> göndericiye iade tamamlandı

Her kargo firması için sadece bir eşleme tablosu yazarsınız; kural motoru yalnızca kanonik durumları bilir. Eşlenemeyen kodlar için varsayılan davranış IN_TRANSIT olmalı, yani sessiz kalmalıdır. Bilinmeyen bir kodu yanlış yorumlayıp müşteriye teslim edildi demek, hiç mesaj atmamaktan çok daha kötüdür.

Sipariş ile gönderiyi eşleştirme problemi

Kurulumun en çok vakit alan kısmı genellikle burasıdır ve rehberlerde neredeyse hiç anlatılmaz. Dikkat edilmesi gereken durumlar:

• Kısmi gönderim: Bir siparişin ürünleri farklı depolardan ayrı paketler halinde çıkabilir. Bu durumda tek sipariş için birden fazla takip numarası olur. Müşteriye üç ayrı kargoya verildi mesajı atmak yerine, paket 1/2 gibi bir ifade kullanın.
• Takip numarasının geç yazılması: Bazı akışlarda sipariş kargolandı olarak işaretlenir ama takip numarası dakikalar hatta saatler sonra sisteme düşer. Mesajı duruma değil, takip numarasının varlığına bağlayın.
• Numara değişimi: Yanlış barkod iptal edilip yenisi basıldığında eski numarayla sorgu yapmaya devam eden sistemler sonsuza kadar bulunamadı döner. Takip numarası değiştiğinde eski kaydı kapatın.
• Pazaryeri siparişleri: Pazaryerinden gelen siparişlerde müşteri telefonu çoğu zaman maskelenmiş veya sanal numaradır. Bu numaralara WhatsApp gönderilemez; bu siparişleri akıştan hariç tutun.

E-ticaret altyapısı tarafında veri kaynağı

Sipariş olaylarını yakalamak için kullanılan yollar altyapıya göre değişir. Genel çerçeve şöyledir:

• Shopify: Sipariş ve gönderi olayları webhook ile dinlenir. Kargolama bilgisi sipariş nesnesinde değil, fulfillment kaydında tutulur; takip numarası, kargo firması ve takip bağlantısı buradan okunur. Kısmi gönderimde birden fazla fulfillment oluşur, bu yüzden mesaj kurgusunu sipariş değil gönderi bazlı yazmak gerekir.
• Ikas: Sipariş durumu değişimlerini webhook ile alabilir, eksik alanları Admin API üzerinden tamamlayabilirsiniz.
• Ticimax: Entegrasyon SOAP servisleri üzerinden yürür. Burada kritik bir tuzak vardır: istek gövdesindeki alan sırası servisin beklediği düzende değilse filtreler sessizce yok sayılır ve beklediğinizden farklı bir sipariş kümesi döner. Hata almazsınız, yanlış veri alırsınız.
• T-Soft: REST servisleri üzerinden sipariş ve kargo bilgisi çekilir; token yenileme döngüsünü kurgunuza dahil edin.

Hangi altyapıda olursanız olun, telefon numarasını E.164 formatına normalize etmeden kuyruğa koymayın. Türkiye numaraları için hedef format 905XXXXXXXXX şeklindedir; başında sıfır, artı işareti, boşluk veya parantez bulunan kayıtlar teslim edilmeyen mesajlar üretir.

WhatsApp Business API tarafı: utility şablon onayı

Meta, şablonları üç kategoriye ayırır: marketing (kampanya, duyuru, indirim), utility (devam eden bir işlem veya sipariş hakkında bilgilendirme) ve authentication (tek kullanımlık doğrulama kodları). Kargo ve sipariş durumu bildirimleri tam olarak utility kategorisine girer.

Kategori seçimi keyfi değildir. Şablonu utility olarak gönderseniz bile içerikte pazarlama unsuru varsa Meta kategoriyi kendisi marketing olarak değiştirir ve bunu bir kategori güncelleme bildirimi ile size iletir. Bu değişiklik hem maliyetinizi artırır hem de mesajın gönderilebilmesi için pazarlama izni gerektirir. Pratik sonuç: utility şablonun içine indirim kodu, kampanya cümlesi veya bir sonraki alışverişe teşvik koymayın.

Onaylanan bir kargo şablonu nasıl görünür?

Aşağıdaki gibi sade, işlemsel ve değişkenleri gerçek veriyle dolan bir şablon sorunsuz geçer:

Merhaba {{1}}, {{2}} numaralı siparişiniz kargoya verildi.
Kargo firması: {{3}}
Takip numarası: {{4}}
Gönderinizi takip etmek için aşağıdaki butonu kullanabilirsiniz.

Şablon oluştururken uyulması gereken biçim kuralları:

• Değişkenler {{1}}, {{2}} şeklinde ve kesintisiz sıralı olmalıdır. 1 ve 3 kullanıp 2 atlanamaz.
• Metin bir değişkenle başlayamaz veya bitemez; iki değişken art arda gelemez.
• Her değişken için gerçekçi bir örnek değer girilmesi zorunludur. Örnek vermezseniz şablon incelemeye bile alınmadan reddedilir.
• Değişken değerleri satır sonu, sekme karakteri veya arka arkaya dört boşluk içeremez. Adres alanını tek değişkene basanlar bu duvara sık çarpar.
• Takip bağlantısı için dinamik URL butonu kullanın. Bağlantıyı metin gövdesine gömmek hem tıklanabilirliği düşürür hem inceleme riskini artırır.

Sık görülen hata kodları ve anlamları

Ayrıca hesabınızın bir kalite derecesi vardır. Kullanıcılar mesajlarınızı engeller veya spam olarak işaretlerse şablon önce duraklatılır, tekrarında daha uzun süre duraklatılır ve ısrar hâlinde tamamen devre dışı bırakılabilir. Kargo bildirimlerinin kalite derecesini bozması nadirdir, çünkü müşteri o mesajı zaten bekler. Ancak aynı numaradan pazarlama mesajı da gönderiyorsanız, düşen kalite derecesi kargo şablonlarınızı da etkiler. Bu yüzden hacimli kampanyaları ayrı bir akışta ve dikkatli segmentasyonla yönetmek gerekir.

Maliyet: WhatsApp mı, SMS mi?

Karşılaştırmayı sadece birim fiyat üzerinden yapmak yanıltıcıdır. İki kanalın yapısal farkları şöyle:

Fiyatlandırma tarafında bilinmesi gereken güncel bir nokta var. Meta, Kasım 2024'ten itibaren açık müşteri hizmetleri penceresi içinde gönderilen utility şablonları ücretsiz saymıştı. Meta'nın duyurduğu değişiklikle 1 Ekim 2026 itibarıyla bu ücretsizlik sona eriyor; hem pencere içinde gönderilen utility şablonlar hem de serbest metin servis mesajları ücretlendirilecek. Yani sadece pencere içinde kalarak maliyeti sıfırlayan kurgular sonbaharda yeniden hesaplanmalı. Bütçe planı yaparken bunu şimdiden hesaba katın ve gereksiz ara bildirimleri (transfer merkezi hareketleri gibi) akıştan çıkarın.

KVKK ve İYS tarafı: neye izin gerekir, neye gerekmez?

Bu konuda sahada en çok karıştırılan mesele, kargo bildiriminin ticari elektronik ileti sayılıp sayılmadığıdır. Ayrımı net koyalım:

• Kişisel veri işleme (KVKK): Müşterinin telefon numarasını sipariş bildirimi için işlemek, sözleşmenin ifası için gerekli olma hukuki sebebine dayanır. Yani kargo bildirimi göndermek için ayrıca açık rıza almanız beklenmez. Buna karşılık aydınlatma yükümlülüğü devam eder: gizlilik metninizde numaranın sipariş ve teslimat bilgilendirmesi amacıyla WhatsApp üzerinden kullanılacağı açıkça yazmalıdır.
• Ticari elektronik ileti (6563 sayılı kanun ve İYS): Temin edilen mal veya hizmete ilişkin bilgilendirme nitelikli iletiler için ayrıca onay aranmaz. Sipariş durumu ve kargo bilgilendirmesi bu kapsamdadır. Ancak aynı mesajın içine bir indirim kuponu, kampanya duyurusu veya yeni ürün önerisi eklediğiniz anda ileti ticari nitelik kazanır ve İYS onayı gerekir.
• Meta politikası: Mevzuattan bağımsız olarak Meta, işletme tarafından başlatılan mesajlar için kullanıcının iletişim izni vermiş olmasını şart koşar. Bu izni sipariş formunda net bir ifadeyle almak ve kaydını (zaman damgası, kanal, metin sürümü) tutmak en sağlıklısıdır.

Uygulamada işleyen pratikler: sipariş formuna WhatsApp üzerinden sipariş ve kargo bilgilendirmesi almak istiyorum ifadesini eklemek, ilk bildirimin altına vazgeçmek için nasıl yazılacağını belirtmek, gelen çıkış taleplerini otomatik işaretleyip o numarayı akıştan çıkarmak, ve gönderim kayıtlarını saklama süresi belirlenmiş bir tabloda tutmak.

WhatsApp kargo bildirimi nasıl kurulur: adım adım kurulum sırası

Buraya kadarki başlıklar kararları anlatıyordu; aşağıdaki sıra ise fiilen yapılacak işler. Adımları atlamadan takip edin, çünkü her biri bir öncekinin çıktısını kullanıyor.

1. Meta Business hesabını ve işletme doğrulamasını tamamlayın. Doğrulanmamış hesaplarda hem numara limitleri hem günlük alıcı limitleri sizi kısıtlar.
2. WhatsApp Business Platform numarasını bağlayın. Bu numara kişisel WhatsApp veya WhatsApp Business uygulamasında aktif olamaz; kullanılan bir numarayı taşıyacaksanız önce uygulamadan çıkış yapılması gerekir.
3. Kanonik durum modelini ve eşleme tablosunu yazın. Kod yazmadan önce, çalıştığınız kargo firmalarının döndürdüğü tüm durum kodlarını gerçek gönderilerden toplayıp listeleyin.
4. Şablonları oluşturup onaya gönderin. En az beş şablonla başlayın: sipariş alındı, kargoya verildi, dağıtıma çıktı, teslim edilemedi, teslim edildi. Onay süresi genellikle birkaç saat ile bir iş günü arasındadır.
5. Sipariş ve gönderi verisini akıtın. Webhook varsa webhook, yoksa kademeli polling. Her gönderi için son bildirilen kanonik durumu veritabanında saklayın.
6. Tekrar gönderim korumasını kurun. (gonderi_id, kanonik_durum) ikilisi üzerinde tekil kısıt açın. Kargo firmaları aynı durumu birden fazla kez dönebilir; bu kısıt olmadan müşteri aynı mesajı üç kez alır.
7. Sessiz saat kuralını ekleyin. Gece yarısı düşen bir teslim edildi kaydı sabah 09:00'a kuyruklanmalıdır. Dağıtıma çıktı mesajı için ideal aralık sabah 08:00-10:00 arasıdır.
8. Test siparişiyle uçtan uca deneyin. Gerçek bir kargo gönderisiyle tüm akışı izleyin. Simülasyon, kargo firmasının gerçek dünyada ürettiği tuhaf kodları göstermez.
9. Ölçün ve budayın. İlk ayın sonunda hangi mesaj türünde okunma düşük, hangisinde engelleme var bakın; değer üretmeyen bildirimi kaldırın.

Bu adımların tamamını kendi altyapınızda yazmak istemiyorsanız, hazır bir WhatsApp kargo bildirimi modülü kurulum süresini gün mertebesinden saat mertebesine indirir; şablon yönetimi, durum eşleme ve tekrar gönderim koruması hazır gelir.

Sık yapılan hatalar

• Her kargo hareketinde mesaj atmak. Bildirim yorgunluğu, engellenme ve kalite derecesi düşüşünün bir numaralı sebebi.
• Takip numarasını mesaja koymamak. Kargoya verildi demek ama numara vermemek, WISMO talebini engellemek yerine tetikler.
• Tek şablonu her duruma uydurmak. Durum adını değişkene basıp tek şablonla idare etmek okunabilirliği bozar ve utility kategorisinde inceleme riskini artırır.
• Test numaralarını canlıda unutmak. Geliştirme sırasında sabitlenmiş bir telefon numarası canlıya çıkarsa tüm bildirimler tek kişiye gider.
• Numara normalizasyonunu atlamak. Başında sıfır olan veya boşluk içeren kayıtlar sessizce teslim edilmez; hata kuyruğunu izlemiyorsanız aylarca fark etmezsiniz.
• Kargo firması değişimine hazırlıksız olmak. Kural motorunu firma koduna bağlayanlar, yeni anlaşmada baştan yazmak zorunda kalır.
• İptal ve iade edilen siparişlere bildirim göndermek. İptal edilmiş bir sipariş için dağıtıma çıktı mesajı gitmesi, güveni tek hamlede bitirir. Akışa iptal kontrolü koyun.
• Kupon ile bildirimi karıştırmak. Utility şablonun içine kampanya eklemek hem kategori değişimine hem yasal yükümlülüğe yol açar.
• Gelen cevapları kimsenin okumaması. Bildirim gönderdiğiniz numaraya müşteri cevap yazar. Bu kutuyu boş bırakmak, otomasyonun sağladığı kazancı geri verir.

Neyi ölçmeli?

Kurduktan sonra bakılması gereken metrikler şunlardır: bildirim başına teslim ve okunma oranı, kargo konulu destek talebinin toplam talep içindeki payındaki değişim, başarısız ilk teslimat denemesi oranı, teslimat sonrası açılan iade taleplerinin zamanlaması, ve bildirim akışından çıkma (opt-out) oranı. Son metrik en önemlisidir: çıkma oranı yükseliyorsa sorun kanalda değil, gönderdiğiniz mesajın gereksizliğindedir.

Kargo bildirimi çalışır hâle geldikten sonra aynı altyapı üzerine kurulan bir sonraki adım genellikle satın alma öncesi otomasyonlardır; terk edilen sepet hatırlatması bu kurgunun doğal devamıdır ve aynı şablon disiplinini gerektirir.

Özet

WhatsApp kargo bildirimi, doğru kurulduğunda destek yükünü düşüren ve satın alma sonrası deneyimi tahmin edilebilir hâle getiren en yüksek getirili otomasyonlardan biridir. Başarının anahtarı teknolojide değil disiplindedir: sadece eyleme dönüşen olaylarda mesaj göndermek, kargo durumlarını kendi kanonik modelinize çevirmek, utility şablonu pazarlamadan uzak tutmak ve tekrar gönderimi kod düzeyinde engellemek. Bu dördünü kuran bir mağazada kargom nerede sorusu, gelen kutusunun en kalabalık başlığı olmaktan çıkar.

Kurulumla ilgili teknik sorularınız için destek@stools.digital adresinden yazabilirsiniz.