İçeriğe geç
OmniChannels.ai

WhatsApp Marketing Messages API (MM Lite): 2026 Rehberi

WhatsApp Marketing Messages API nedir, Cloud API pazarlama şablonlarından farkı, 2027 sonlandırma tarihleri, kimlerin kullanabileceği ve ölçüm metrikleri.

Güncelleme 9 dk okuma

Yazar: OmniChannels.ai Editorial Team · İnceleyen: BroadNet Messaging Solutions Team

WhatsApp

Kısa yanıt

WhatsApp için Marketing Messages API, Meta'nın pazarlama şablonları için sunduğu yalnızca gönderim yapan API'dir ve pazarlama mesajlarını Cloud API üzerinden göndermenin halefidir. Kaliteye dayalı iletim, mesaj geçerlilik süresi (TTL), kıyaslamalar ve dönüşüm metrikleri ekler. Meta, Cloud API'nin pazarlama mesajlarını 13 Ekim 2027'de kabul etmeyi bırakacağını söylüyor; bu yüzden promosyon gönderen işletmelerin bunları yeni uç noktaya yönlendirmesi gerekir. Bilgilendirme, kimlik doğrulama ve hizmet mesajları Cloud API'de kalır.

Bu sayfada
  1. WhatsApp için Marketing Messages API nedir?
  2. Değişikliğin önemli tarihleri nelerdir?
  3. Cloud API'deki pazarlama şablonlarından farkı nedir?
  4. WhatsApp pazarlama maliyetini değiştirir mi?
  5. Kimler kullanabilir ve özellikler nerede sınırlı?
  6. Yeni API ile pazarlama mesajı nasıl gönderilir?
  7. Şablonun yeniden sınıflandırılması şimdi neden önemli?
  8. Çalışıp çalışmadığını nasıl ölçersiniz?
  9. Önce kimler geçmeli?
  10. Hangi hatalardan kaçınmalısınız?
  11. OmniChannels.ai nasıl yardımcı olur?

Öne çıkan noktalar

  • WhatsApp için Marketing Messages API (çoğunlukla MM Lite denir), MARKETING kategorisindeki şablonlar için ayrı bir gönderim uç noktasıdır; gelen mesajlar dahil geri kalan her şey Cloud API'de kalır.
  • Meta'nın belgeleri değişikliği tarihlendirir: genel kullanıma 19 Kasım 2025'te açıldı, 13 Nisan 2027 veya sonrasında oluşturulan yeni hesaplar Cloud API üzerinden pazarlama gönderemez ve Cloud API ile pazarlama gönderimi 13 Ekim 2027'de sona erer.
  • Kaliteye dayalı iletim, 12 saatten 30 güne özelleştirilebilir mesaj geçerlilik süresi, kıyaslamalar, öneriler ve dönüşüm metrikleri yeni API'nin özellikleridir; medya, carousel ve flow şablonları gibi temel pazarlama biçimleri ikisinde de çalışır.
  • Meta, faturalama modelinin Cloud API ile aynı olduğunu söylüyor; işletmeler isteğe bağlı olarak iletilen pazarlama mesajı başına azami bir fiyat belirleyebilir ve Meta bu tutarı veya daha azını ücretlendirir.
  • Bazı özellikler her yerde etkin değil. Meta, Avrupa Ekonomik Alanı, Birleşik Krallık, Japonya, Güney Kore, Nijerya, Güney Afrika ve Tayland'da iletim optimizasyonu olmadığını belirtiyor; ABD numaralarına pazarlama mesajları iletilmiyor.

Bu rehber, WhatsApp promosyonları gönderen ve Meta'nın pazarlama mesajlarını yeni bir API'ye taşıdığını duyan pazarlama liderleri, CRM sahipleri ve geliştiriciler için hazırlandı. Marketing Messages API'nin ne olduğunu, hangi tarihlerin önemli olduğunu, Cloud API'deki pazarlama şablonu göndermekten nasıl ayrıldığını ve şimdi ne yapılacağını anlatır. Meta'nın 6 Kasım 2026 tarihli geliştirici belgelerini izler; bir plana girişmeden önce ayrıntıları orada teyit edin.

WhatsApp için Marketing Messages API nedir?

WhatsApp için Marketing Messages API, Meta'nın pazarlama şablon mesajları için sunduğu yalnızca gönderim yapan API'dir. Meta bunu, bir mesajı en alakalı bulması olası kişilere ulaştırmak üzere tasarlanmış optimizasyonlarla, Cloud API'deki pazarlama mesajlarının halefi olarak tanımlar.

İş ortaklarının ve önceki yazıların kullandığı adla çoğunlukla MM Lite denir. Üç nokta onu tanımlar:

  • Ayrı bir uç noktadır. Pazarlama şablonları /<PHONE_NUMBER_ID>/messages yerine /<PHONE_NUMBER_ID>/marketing_messages adresine gider.
  • Yalnızca MARKETING şablonları içindir. Meta, diğer kategorilerin olağan mesaj uç noktasına gittiğini söyler.
  • Cloud API'nin yanında yer alır. Müşteri mesajlarını ve webhook'ları almak ile hizmet, bilgilendirme ve kimlik doğrulama mesajlarını göndermek için Cloud API'yi kullanmaya devam edersiniz.

Temel parçalara yeniyseniz WhatsApp pazarlama mesajları nasıl gönderilir yazısıyla ve WhatsApp şablon kategorileri rehberimizle başlayın.

Değişikliğin önemli tarihleri nelerdir?

Meta'nın genel bakış sayfası dört tarih verir: 19 Kasım 2025'te genel kullanıma açılma, 13 Ekim 2026'da küresel duyuru, 13 Nisan 2027'de yeni hesaplar için kesme tarihi ve 13 Ekim 2027'de Cloud API'de pazarlamanın sonlandırılması.

Tarih Meta'ya göre ne olur
19 Kasım 2025 Marketing Messages API for WhatsApp, açık betanın ardından genel kullanıma açılır
13 Ekim 2026 Cloud API'nin pazarlama mesajlarını desteklemeyi bırakacağına dair küresel duyuru
13 Nisan 2027 Bu tarihte veya sonrasında oluşturulan yeni mesajlaşma hesapları Cloud API ile pazarlama mesajı gönderemez; önceki hesaplar sonlandırmaya kadar erişimini korur
13 Ekim 2027 Cloud API ile pazarlama mesajı göndermek hata döndürür; hizmet, kimlik doğrulama ve bilgilendirme etkilenmez

Meta ayrıca çoğu entegrasyonun yeni uç noktaya geçişinin yaklaşık iki hafta sürdüğünü belirtir. Bunu basit bir entegrasyon için tahmin sayın; birden çok sisteminiz, onay adımlarınız veya sizinle Meta arasında bir sağlayıcı varsa daha uzun süre ayırın.

Cloud API'deki pazarlama şablonlarından farkı nedir?

Şablonlar ve telefon numaraları aynıdır, ancak yeni API, Cloud API pazarlama mesajlarında bulunmayan iletim ve ölçüm özellikleri ekler. Meta, mevcut telefon numaralarının ve pazarlama şablonlarının yeniden kullanılabileceğini belirtir.

Meta'nın özellik tablosu ikisini karşılaştırır. Aşağıdaki satırlar günlük pazarlama işini değiştirenlerdir:

Yetenek Marketing Messages API Cloud API (pazarlama)
Kaliteye dayalı iletim Mesaj etkileşimini iletim kararlarına katar Hayır; kullanıcı başına pazarlama limitleri mesaj kalitesini dikkate almaz
Mesaj geçerlilik süresi (TTL) 12 saatten 30 güne; sonra iletilmeyen mesajların süresi dolar Kimlik doğrulama ve bilgilendirme ile sınırlı
Yaratıcı optimizasyonlar Pilot: otomatik görsel ve metin ayarlamaları Hayır
Hareketli GIF başlığı Evet Hayır
Android uygulama derin bağlantıları Evet Hayır
Kıyaslamalar ve öneriler Evet Hayır
Dönüşüm metrikleri Meta SDK veya App Events API ile sepete ekleme, ödemeye başlama ve satın alma gibi uygulama olayları Hayır
Temel biçimler (medya, carousel, katalog, flow, liste, yanıt) Evet Evet
Temel ve maliyet metrikleri (gönderilen, iletilen, okunan, tıklanan, hatalar, harcama) Evet Evet

Meta, kaliteye dayalı iletim için tek bir performans rakamı verir: iletilen mesajlarda yüzde 9'a kadar artış. Kendi dipnotu bunun, Ocak 2025'te Hindistan'daki reklamverenlerin gönderdiği yaklaşık 12 milyon iletilmiş pazarlama mesajı üzerindeki bir A/B testinden geldiğini söyler. Bu rakamı her pazarda veya her liste için beklemeyin.

WhatsApp pazarlama maliyetini değiştirir mi?

Meta, Marketing Messages API'nin Cloud API ile aynı faturalama modelini kullandığını söyler: iletilen mesaj başına ödersiniz ve ücret kategoriye ve alıcının pazarına bağlıdır. Meta'nın fiyatlandırma sayfası yeni API için isteğe bağlı bir kontrol ekler.

  • Azami fiyat. 2026'dan itibaren bir işletme, Marketing Messages API'deki her pazarlama mesajı iletimi için azami bir fiyat belirleyebilir. Meta bu azami tutarı veya daha azını ücretlendirir. Bu, pazarlama mesajları yayımlanmış ücretle ücretlendirilen Cloud API için geçerli değildir.
  • Pazarlamada hacim kademesi yok. Meta hacim kademelerini yalnızca bilgilendirme ve kimlik doğrulamaya uygular.
  • Ücretsiz giriş noktası penceresi. Bir kullanıcı Click to WhatsApp reklamına yanıt verdiğinde açılan ücretsiz giriş noktası penceresi içinde gönderilen pazarlama mesajları ücretlendirilmez.

Yazılarda ücret yazmıyoruz. Meta'nın güncel ücret tarifesini, ülkeye göre WhatsApp fiyatlarımızı ve WhatsApp fiyat hesaplayıcısını kullanın. WhatsApp için kendi şartlarımız, Meta'nın ücretiyle ve sıfır kâr marjıyla ücretlendirilmesidir. Daha geniş bir maliyet resmi için 2026'da WhatsApp Business API fiyatlandırması yazısını okuyun.

Kimler kullanabilir ve özellikler nerede sınırlı?

Meta'nın başlangıç sayfası, uygun bir ülkede etkin bir mesajlaşma hesabı, onaylı bir pazarlama şablonu ve mesajlar webhook'una abonelik ister. Bazı optimizasyonlar birkaç bölgede kapalıdır.

Bölge Meta'nın belgelediği
Avrupa Ekonomik Alanı, Birleşik Krallık, Japonya, Güney Kore, Nijerya, Güney Afrika, Tayland İletim optimizasyonu yok, kullanıcı başına şablon limitleri etkin değil, tıklama ve dönüşüm metrikleri kullanılamıyor
Amerika Birleşik Devletleri Meta, 1 Nisan 2025'ten beri ABD WhatsApp numaralarına pazarlama mesajı iletmiyor (hata 131049); bu, tüm Business Messaging API'leri için geçerli
Küba, İran, Kuzey Kore, Suriye, Venezuela ve Ukrayna'nın bazı bölgeleri İşletmeler kayıt olamaz ve bu bölgelere mesaj gönderilemez
Rusya ve Belarus İstisnalarla izinli; iletim optimizasyonları ile tıklama ve dönüşüm metrikleri geçerli değil

Pratik sonuç şudur: erken benimsemenin ana nedeni olan kaliteye dayalı iletim, alıcılarınızın nerede olduğuna bağlıdır. Kitlenizin çoğu Körfez'deyse iletim artışı üzerine plan yapmadan önce Meta'nın güncel coğrafi tablosunu kontrol edin. Meta listeyi değiştirebilir.

Yeni API ile pazarlama mesajı nasıl gönderilir?

Aynı şablonu farklı bir uç noktaya gönderirsiniz ve her şablonu en güncel kategorisine göre yönlendirirsiniz. İstek gövdesi bilinen şablon yapısını izler.

Meta'nın belgelerindeki adımlar şunlardır:

  1. App Dashboard'da WhatsApp, ardından Quickstart bölümünü açın, pazarlama mesajlarıyla yatırım getirisini artırma modülünü bulun ve hizmet şartlarını kabul edin.
  2. Telefon numarası ID'nize ait marketing_messages uç noktasına bir POST isteğiyle kendi numaranıza test pazarlama şablonu gönderin.
  3. Her şablonun ID'sini, adını, dilini ve en güncel kategorisini içeren önbelleğe alınmış bir eşleme tutun; MARKETING şablonlarını marketing_messages uç noktasına, diğerlerinin hepsini messages uç noktasına gönderin.
  4. Şablon kategori güncelleme webhook'una abone olun ve tamamlandı bildirimi geldiğinde eşlemeyi güncelleyin. Yaklaşan (impending) bildirime göre hareket etmeyin.
  5. Kayıt sonrasında disable_marketing_messages_on_cloud_api değerini true yapın. Cloud API bundan sonra pazarlama şablonlarını 131063 hatasıyla reddeder; siz de kategoriyi yenileyip pazarlama uç noktası üzerinden yeniden denersiniz.
  6. Yeniden denemeleri idempotent yapın ve yalnızca doğrulanmış bir başarısızlıktan sonra yeniden deneyin.

Bu yolla gönderilen mesajların durum webhook'ları pricing.category alanında marketing_lite taşır; böylece raporlarınız bunları ayırabilir. Olay işleme için WhatsApp webhook rehberini, şablon ifadeleri için WhatsApp şablon örneklerini kullanın.

Şablonun yeniden sınıflandırılması şimdi neden önemli?

Meta, onaydan sonra bir şablonun kategorisini değiştirebilir ve tanıtım içeriği taşıyan bir bilgilendirme şablonu pazarlamaya dönüşebilir. Sonlandırmadan sonra bu şablon yalnızca pazarlama uç noktasından gönderilebilir.

Meta'nın kategorilendirme belgeleri, bilgilendirme (Utility) şablonlarının tanıtım içermemesi ve bir kullanıcı eylemine ya da temel bir güncellemeye bağlı olması gerektiğini söyler. Sipariş ve hesap mesajları tanıtım yapmamalı, ek satış veya çapraz satış yapmamalıdır. "Siparişiniz kargoya verildi" şablonuna indirim kodu eklemek klasik örnektir. Bilgilendirme kitaplığınızı şimdi gözden geçirin, tanıtım satırlarını kaldırın ve yönlendirme kodunuzun kategoriyi varsaymak yerine güncel kategoriyi okumasını sağlayın.

Çalışıp çalışmadığını nasıl ölçersiniz?

Başlıktaki artışa güvenmek yerine kontrollü bir karşılaştırma yapın. Aynı kitle, aynı şablon ve aynı zaman penceresi üzerinde ölçün.

  1. Bölün. Eski rota hâlâ çalışırken karşılaştırılabilir bir grubu Cloud API'de tutun veya geçişten önceki ve sonraki eşleştirilmiş kampanyaları karşılaştırın.
  2. Kabul edilen değil iletilen oranı karşılaştırın. İletilen mesajları gönderilen mesajlara bölün.
  3. Okunma ve tıklama oranlarını karşılaştırın; Meta'nın durum webhook'larını ve bölgenizde varsa tıklama metriklerini kullanın.
  4. İletilen mesaj başına ve dönüşüm başına maliyeti hesaplayın. Gönderim sayısını değil, iletim ücretini kullanın.
  5. Kendi dönüşüm verilerinizi kullanın. Uygulama olaylarını gönderemiyorsanız bağlantıları kampanya parametreleriyle etiketleyin ve sonuçları CRM'inizde sayın.
  6. Sıklığı izleyin. Kaliteye dayalı iletim opt-in ve alaka ihtiyacını ortadan kaldırmaz; engellemelerdeki artış hangi uç noktayı kullanırsanız kullanın hesap kalitesine zarar verir.

Sentetik rakamlarla uygulamalı örnek: Riyad'daki bir elektronik perakendecisi 100.000 pazarlama şablonu gönderiyor ve Meta eski rotada 90.000'ini iletiyor. Yeni uç noktadaki başka 100.000 şablondan 92.000'i iletiliyor. İletim oranı yüzde 90'dan yüzde 92'ye çıktı; bu, müşterilere ulaşan 2.000 mesaj daha demektir. Bunun bir değeri olup olmadığı o ek alıcıların tıklama ve satın alma oranlarına bağlıdır; bu yüzden yalnızca iletimi değil, satın alma başına maliyeti karşılaştırın.

Önce kimler geçmeli?

Pazarlama şablonu gönderen herkes Meta'nın sonlandırma tarihine kadar geçmek zorunda kalacak, ancak aciliyet farklıdır.

Durum Önerilen öncelik
2027 için planlanan yeni WhatsApp hesabı İlk günden Marketing Messages API üzerine kurun; çünkü 13 Nisan 2027 veya sonrasında oluşturulan hesaplar pazarlama için Cloud API'yi kullanamaz
Optimizasyonların etkin olduğu pazarlara büyük promosyon hacmi Erken pilot yapın ve ölçün
Çoğunlukla bilgilendirme ve kimlik doğrulama trafiği Düşük aciliyet, ancak yeniden sınıflandırma riskini denetleyin
Click to WhatsApp reklamlarının yoğun kullanımı Ücretsiz giriş noktası pencerelerinin ve faturalamanın raporlarınızda nasıl göründüğünü kontrol edin
Bir sağlayıcı veya CRM kullanımı Sağlayıcıdan geçiş tarihini ve neleri desteklediğini isteyin

Hangi hatalardan kaçınmalısınız?

  • Her şey için tek uç nokta varsaymak. Kategoriye göre yönlendirin ve güncel tutun.
  • Yüzde 9 rakamını söz saymak. Bu, bölgesel bir test sonucudur.
  • Desteklenmeyen pazarları unutmak. ABD numaraları pazarlama mesajı almaz ve optimizasyonlar birkaç bölgede kapalıdır.
  • Bilgilendirme şablonlarında tanıtım metni bırakmak. Yeniden sınıflandırma bunları pazarlama uç noktasına ve pazarlama fiyatlandırmasına iter.
  • Sıklığı ve onayı göz ardı etmek. İletim optimizasyonu izni ikame etmez.
  • Son aya kalmak. Test, onay ve raporlama değişikliklerini Ekim 2027'den çok önce planlayın.

OmniChannels.ai nasıl yardımcı olur?

BroadNet resmî bir Meta Business Solution Provider'dır ve OmniChannels.ai, medya, değişken ve düğmeli WhatsApp pazarlama şablonlarını kampanyalar üzerinden, iletim raporları ve CSV dışa aktarımıyla gönderir. WhatsApp, Meta'nın ücretiyle ve sıfır kâr marjıyla ücretlendirilir. Bu yazıda Marketing Messages API desteği iddia etmiyoruz: hesabınızı ve takviminizi ekibimize sorun; şablon kategorilerinizi sizinle birlikte gözden geçirebiliriz. Konuşmak için demo planlayın.

Sık sorulan sorular

WhatsApp için Marketing Messages API nedir?

Meta'nın WhatsApp'ta pazarlama şablon mesajlarını ek optimizasyonlarla göndermek için sunduğu API'dir. Onaylı pazarlama şablonlarını standart mesaj uç noktası yerine özel bir marketing_messages uç noktasına gönderirsiniz. Meta, bunu Cloud API'deki pazarlama mesajlarının halefi olarak tanımlar ve aynı faturalama modelini kullandığını söyler.

MM Lite nedir?

MM Lite, Marketing Messages Lite'ın kısaltmasıdır; iş ortağı belgelerinin ve önceki yazıların bu API için kullandığı addır. Meta'nın güncel belgeleri ürüne WhatsApp için Marketing Messages API der ve durum webhook'ları bu tür mesajları marketing_lite olarak etiketler; yani adlar aynı ürünü ifade eder.

Cloud API pazarlama mesajlarını ne zaman desteklemeyi bırakacak?

Meta'nın genel bakış sayfasına göre Cloud API, pazarlama mesajlarını 13 Ekim 2027'de desteklemeyi bırakır; o tarihte Cloud API ile pazarlama mesajı göndermek hata döndürür. 13 Nisan 2027 veya sonrasında oluşturulan hesaplar Cloud API ile hiç pazarlama gönderemez. Tarihler ve istisnalar değişebileceğinden Meta'nın sayfasını kontrol edin.

Bilgilendirme veya kimlik doğrulama şablonlarını gönderme biçimimi değiştirmem gerekir mi?

Hayır. Meta, hizmet, kimlik doğrulama ve bilgilendirme (Utility) mesajlarının Cloud API'de kaldığını belirtir. Değişiklik, kategorisi MARKETING olan şablonları etkiler. Tek tuzak yeniden sınıflandırmadır: Meta bir bilgilendirme şablonunu pazarlama olarak yeniden kategorize ederse o şablon artık pazarlama uç noktasından gönderilmelidir.

Marketing Messages API, Cloud API'den daha mı ucuz?

Meta, Cloud API ile aynı faturalama modelini kullandığını söyler ve ücretler Meta'nın alıcının pazarına göre ücret tarifesinden gelir. İsteğe bağlı azami fiyat özelliği, iletilen pazarlama mesajı başına Meta'nın alacağı tutarı sınırlamanızı sağlar. Tasarruf varsaymayın; kendi kampanyalarınızın iletim sonuçlarını ve ücretlerini Meta'nın güncel fiyatlandırma belgelerinde karşılaştırın.

OmniChannels.ai, Marketing Messages API'yi destekliyor mu?

Ekibimize sorun. BroadNet resmî bir Meta Business Solution Provider'dır ve bugün WhatsApp pazarlama şablonları gönderir; ancak bu belirli API'nin ve optimizasyonlarının desteği, geçişinizi buna göre planlamadan önce hesabınız için bizimle teyit edilmelidir.

Kaynaklar

  1. Marketing Messages API for WhatsApp: overview, Meta for Developers
  2. Marketing Messages API for WhatsApp: features, Meta for Developers
  3. Marketing Messages API for WhatsApp: get started and geographic availability, Meta for Developers
  4. Route template messages, Meta for Developers
  5. WhatsApp Business Platform pricing, Meta for Developers