WhatsApp Marketing Messages API: pazarlama şablon mesajlarınız için neler değişiyor?

Meta, WhatsApp pazarlama şablon mesajlarını Cloud API’den Marketing Messages API for WhatsApp’a taşıyor. Cloud API 13 Ekim 2027’de pazarlama mesajı taşımayı bırakıyor; 13 Nisan 2027 ve sonrasında açılan WhatsApp Business hesapları ise Cloud API’den hiç pazarlama mesajı gönderemeyecek. Aynı dönemde müşteriler bir işletmenin kampanya mesajlarını WhatsApp içinden durdurup yeniden açabiliyor ve bunu yaptıklarında işletmeye haber veriliyor.

Numaranız, onaylı şablonlarınız ve Meta’nın sizi faturalama şekli değişmiyor. Değişen; pazarlama şablonlarının hangi kanaldan gittiği, kime hâlâ kampanya gönderebileceğiniz ve kullanmaya başlamanız gereken birkaç yeni ayar. Bu yazıda Meta’nın takvimini, durdurma/yeniden açma özelliğini, 131049 hatasını, mesaj geçerlilik süresini ve MonoChat’teki adımları anlatıyoruz.

Marketing Messages API nedir?

Aynı WhatsApp Business numarası için ikinci bir gönderim kanalıdır. Meta’nın dokümantasyonundaki ayrım şöyle: Cloud API hizmet, bilgilendirme (utility) ve doğrulama mesajlarını göndermeye ve müşteri mesajlarını almaya devam eder; Marketing Messages API ise pazarlama şablonlarını aynı numaradan “optimizasyonlarla” gönderir.

Meta’ya göre getirdikleri:

• Teslimat optimizasyonu: Pazarlama mesajı, ilgilenme ihtimali en yüksek kişilere öncelikli ulaştırılır. Meta’nın Ocak 2025’te Hindistan’da yaklaşık 12 milyon teslim edilmiş pazarlama mesajıyla yaptığı testte, yüksek etkileşimli mesajlarda optimize teslimat standart Cloud API’ye göre daha fazla okunma ve tıklama getirdi.
• Karşılaştırma ve öneriler: Okunma ve tıklama oranlarınızın bölgenizdeki benzer şablonlarla kıyası.
• GIF başlık desteği.
• Pazarlama şablonları için mesaj geçerlilik süresi (TTL).
• Cloud API ile aynı faturalama modeli; mevcut numara ve mevcut pazarlama şablonları kullanılır.

Bazı özellikler ülkeye göre değişir. AEA (EEA), Birleşik Krallık, Japonya, Güney Kore, Nijerya, Güney Afrika ve Tayland için geçiş mümkün, ancak teslimat optimizasyonu ve tıklama/dönüşüm raporu yok. Yaptırım uygulanan bölgelerdeki işletmeler geçiş yapamaz.

Meta’nın takvimi

Tarih	Ne oluyor?
19 Kasım 2025	Marketing Messages API açık betadan çıkıp herkese açıldı.
13 Ekim 2026	Meta, Cloud API’de pazarlama mesajlarının sona ereceğini duyurdu.
13 Nisan 2027	Bu tarihte ve sonrasında açılan hesaplar Cloud API’den pazarlama mesajı gönderemez.
13 Ekim 2027	Cloud API’den gönderilen pazarlama mesajları hata döner.

Meta’nın tavsiyesi: koşulları onaylayın, entegrasyonunuzun pazarlama şablonlarını yeni uç noktaya gönderdiğinden emin olun ve kategorisi değişen şablonları kontrol edin. Utility olarak onaylanmış ama içeriği tanıtım kokan bir şablonu Meta Marketing kategorisine taşıyabilir; o andan itibaren pazarlama mesajı olarak gitmesi gerekir.

Geçiş nasıl yapılır?

Teknik bir proje değil, bir onay işlemi. İş ortağıyla çalışan işletmeler için Meta’nın tarif ettiği yol:

1. Meta işletme portföyünüzde tam yetkiye sahip kişi WhatsApp Manager › Overview sayfasını açar.
2. Alerts bölümünde Marketing Messages API for WhatsApp için Accept terms’e tıklar.
3. Adımları izleyip koşulları imzalar.

Bundan sonra mesaj durumu olayları (teslim, okunma, tıklama) kampanya optimizasyonu için Meta ile paylaşılır; bu paylaşımı WhatsApp Business hesap ayarlarından kapatabilirsiniz.

Müşteri artık kampanya mesajlarınızı durdurabiliyor

WhatsApp’ta her işletme için Offers and announcements (teklifler ve duyurular) adlı bir ayar var. Müşteri burada kampanyalarınızla ilgilenip ilgilenmediğini belirtebilir, pazarlama mesajlarınızı tamamen durdurabilir ya da sonra yeniden açabilir.

• İlgilenmiyorum seçimi o kişiye giden pazarlama mesajı sayısını azaltabilir ama engellemez; size bildirim de gelmez.
• Durdur seçildiğinde pazarlama şablonlarınız o kişiye teslim edilmez. Yine de gönderirseniz API isteği kabul eder ama mesaj 131050 hatasıyla düşer.
• Durdur ve yeniden aç işlemleri stop ya da resume değeriyle user_preferences webhook’unu tetikler.

Bunun opt-in’den farklı olduğunu unutmayın. Kampanyaları durduran müşteri, sipariş ve randevu bildirimlerini almaya devam etmek istiyor olabilir; bilgilendirme şablonları ona ulaşır. Türkiye’de ticari elektronik ileti için İYS kaydı ve 6563 sayılı Kanun’daki ret hakkı ayrıca geçerli: WhatsApp’taki durdurma, İYS’deki onayın yerini tutmaz, ama müşterinin “artık kampanya istemiyorum” dediğinin açık bir işaretidir. İzin toplamayı WhatsApp opt-in rehberimizde anlatıyoruz.

131049 hatası: kişi başına pazarlama sınırı

WhatsApp, bir kişinin tüm işletmelerden aldığı pazarlama şablonu sayısını, kişinin son dönemdeki okuma oranına ve gelen kutusunun yoğunluğuna göre sınırlayabilir. Bu yüzden teslim edilmeyen mesaj 131049 hatası alır.

• O kişiye tekrar göndermeden önce en az 24 saat bekleyin. 24 saat içinde tekrar tekrar denemek, gönderimi bir güne kadar kapatabilir.
• Müşteri yanıt verdikten sonra açık 24 saatlik müşteri hizmetleri penceresi içinde gönderilen pazarlama mesajları sınıra sayılmaz.

Kampanyaların ulaşmamasının diğer nedenleri WhatsApp toplu mesajı neden iletilmiyor yazısında, numaranızı sağlıklı tutan alışkanlıklar ise ban yemeden WhatsApp toplu mesaj rehberinde.

Pazarlama şablonlarında mesaj geçerlilik süresi

WhatsApp bir mesajı teslim edemezse (telefon kapalıysa örneğin) belirli bir süre denemeye devam eder; buna geçerlilik süresi (time-to-live, TTL) denir. Marketing Messages API’den giden pazarlama şablonlarında varsayılan 30 gündür ve 12 saat ile 30 gün arasında ayarlanabilir. Süre içinde teslim edilemeyen mesaj düşürülür.

Varsayılan süre, süreli kampanyalar için risklidir: “Efsane Cuma bu gece bitiyor” mesajının üç gün sonra gelmesi markanıza zarar verir. Süreyi kampanyanın ömrüne göre ayarlayın:

Kampanya	Saniye
12 saatlik flaş indirim	43200
24 saatlik indirim kodu	86400
Hafta sonu kampanyası (3 gün)	259200
Bir hafta sonraki etkinlik daveti	604800
Süresiz duyuru	boş bırakın (30 gün)

MonoChat 3.8.41 ile neler yapılıyor?

1 Kasım 2026’da çıkan MonoChat 3.8.41, WhatsApp Business (Cloud) kanallarında bu değişikliklerin hepsini karşılıyor:

• Kategoriye göre yönlendirme: Her şablon kategorisiyle gönderilir. Hesabınız geçiş yaptıysa Pazarlama şablonları Marketing Messages API’den, diğerleri Cloud API’den gider. Geçiş yapılmadıysa Pazarlama şablonları eskisi gibi Cloud API’den gider. MonoChat hesap durumunu düzenli kontrol ettiği için yeni geçiş yapan hesap bir saat içinde yeni kanala alınır.
• Görünür geçiş durumu: Kanalın Profil Ayarları ekranında Marketing Messages API bölümü hesabın geçiş yapıp yapmadığını gösterir.
• Durdurma kaydı: Müşteri pazarlama mesajlarınızı durdurduğunda WhatsApp pazarlama durduruldu profil alanı Evet olur. Bu alan müşterinin genel İzin Durumu alanından ayrıdır. Ayrıca müşterinin o kanaldaki son konuşmasına yalnızca ekibinizin gördüğü bir fısıltı notu eklenir. Müşteri yeniden açtığında alan Hayır olur. CRM’de bu alana göre filtreleme yapabilirsiniz.
• Boşa gönderim yok: Şablonun kategorisi Pazarlama ise toplu mesajlar bu müşterileri atlar ve alıcının durumunda nedeni yazar. Şablon Mesaj Gönder akış düğümü Pazarlama şablonunu göndermez, Başarısız Olduğunda çıkışından devam eder.
• Anlaşılır hata: 131049 hatası gelen kutusunda ve toplu mesaj kayıtlarındaki Mesaj Durumu sütununda “Müşteri WhatsApp’ın pazarlama mesajı sınırına ulaştı; 24 saat sonra tekrar deneyin” olarak görünür.
• Şablon oluşturucuda süre: Geçiş yapmış hesaplarda Pazarlama şablonlarında Mesaj geçerlilik süresi (saniye) alanı vardır; 43200 ile 2592000 arası değer alır.

MonoChat’te adım adım

1. Geçiş durumunu kontrol edin. Ayarlar › Sohbet › Kanallar ekranında WhatsApp Business (Cloud) kanalınızın ⋮ menüsünü açıp Profil Ayarları’nı seçin. Marketing Messages API bölümü hesabın geçiş yaptığını ya da henüz yapmadığını (13 Ekim 2027 tarihiyle birlikte) gösterir.

2. Gerekirse Meta koşullarını onaylatın. İşletme portföyünde tam yetkisi olan kişiden WhatsApp Manager’da koşulları onaylamasını isteyin. Bir saat içinde Profil Ayarları hesabı geçiş yapmış olarak gösterir.

3. Süreli Pazarlama şablonlarına geçerlilik süresi ekleyin. Ayarlar › Sohbet › Kanallar › ⋮ › Şablon Mesajlar’da yeni şablon oluştururken Pazarlama kategorisini seçin ve Mesaj geçerlilik süresi (saniye) alanını doldurun. Müşteri engellemek yerine daha kolay bir yol bulsun diye “Kampanya istemiyorum” gibi bir hızlı yanıt butonu da ekleyin.

4. Segmentleri yeni alana göre kurun. CRM’de WhatsApp pazarlama durduruldu alanına göre filtreleyip bu müşterileri kampanya kitlelerinden baştan çıkarın; İzin Durumu alanını diğer kanallar için kullanmaya devam edin.

5. Akışlara yedek yol ekleyin. Pazarlama şablonu gönderen her Şablon Mesaj Gönder düğümünün Başarısız Olduğunda çıkışını bağlayın; akış sessizce bitmesin.

6. Her kampanyadan sonra raporlara bakın. Sistem › Toplu Mesaj altında kayıtları açın. Durum sütunundaki “Müşteri WhatsApp pazarlama mesajlarını durdurdu; pazarlama şablonları bu müşteriye gönderilmez” notu ve Mesaj Durumu’ndaki 131049 metni, kitlenin hangi kısmını neden kaybettiğinizi gösterir.

Uygulamada nasıl görünür?

İstanbul’daki bir spor mağazasının 24 saatlik kampanyası, geçerlilik süresi 86400:

Merhaba {{1}}, 24 saatlik indirimimiz başladı: tüm koşu ayakkabılarında yarın gece yarısına kadar %25 indirim. Baktığınız trail modelde numaranız hâlâ stokta.

[Kampanyaya git]  [Kampanya istemiyorum]

Müşterinin telefonu kampanya bitene kadar kapalı kalırsa WhatsApp süresi geçmiş teklifi teslim etmez.

Müşteri daha sonra kampanyaları durdurduğunda ekibin konuşmada gördüğü fısıltı notu:

Müşteri WhatsApp pazarlama mesajlarını durdurdu.

Ertesi haftaki kargo bildirimi (bilgilendirme şablonu) yine gider:

Merhaba {{1}}, {{2}} numaralı siparişiniz Yurtiçi Kargo'ya teslim edildi. Takip: {{3}}

Kontrol listesi

• Profil Ayarları hesabı Marketing Messages API’ye geçmiş gösteriyor; 2027’yi beklemeyin.
• Her şablonun kategorisi doğru; Meta’nın Marketing’e taşıdığı Utility şablonları artık pazarlama kurallarına tabi.
• Süreli Pazarlama şablonlarında kampanyaya uygun geçerlilik süresi var.
• Kampanya segmentleri WhatsApp pazarlama durduruldu = Evet olanları dışarıda bırakıyor.
• Pazarlama şablonu gönderen her akış adımının Başarısız Olduğunda dalı var.
• 131049 hatası alan kişilere 24 saat dolmadan tekrar gönderilmiyor.
• Büyük gönderimlerden önce maliyeti toplu mesaj hesaplayıcı ile kontrol ediyorsunuz; faturalama modeli değişmiyor.

Kampanya stratejisi için WhatsApp pazarlama rehberimize, numaranın Cloud API ile nasıl bağlandığı için WhatsApp Cloud API yazımıza göz atın. MonoChat resmi bir Meta Business Partner’dır; Meta mesaj ücretlerini doğrudan size faturalar, MonoChat bunun üzerine ek ücret koymaz. Ücretsiz Basic planla app.monochat.ai üzerinden başlayabilirsiniz.

Kaynaklar

• Meta for Developers: Marketing Messages API for WhatsApp, genel bakış ve takvim (2 Kasım 2026’da erişildi)
• Meta for Developers: Marketing Messages API’ye geçiş (2 Kasım 2026’da erişildi)
• Meta for Developers: Başlarken, ülkelere göre özellikler (2 Kasım 2026’da erişildi)
• Meta for Developers: Marketing Messages API özellikleri (2 Kasım 2026’da erişildi)
• Meta for Developers: Şablonları kategoriye göre yönlendirme (2 Kasım 2026’da erişildi)
• Meta for Developers: Pazarlama şablonları, kullanıcı tercihleri (2 Kasım 2026’da erişildi)
• Meta for Developers: user_preferences webhook başvurusu (2 Kasım 2026’da erişildi)
• Meta for Developers: Kişi başına pazarlama şablonu sınırları (2 Kasım 2026’da erişildi)
• Meta for Developers: Mesaj geçerlilik süresi (2 Kasım 2026’da erişildi)
• MonoChat yardım merkezi: Şablon Mesajlar, WhatsApp’ta pazarlama şablonları (2 Kasım 2026’da erişildi)
• MonoChat yardım merkezi: Toplu Mesajlar (2 Kasım 2026’da erişildi)
• MonoChat sürüm notları 3.8.41 (2 Kasım 2026’da erişildi)