Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

WhatsApp webhook fiyatlandırma nesnesi: type, category ve billable (2026)

Fiyatlandırma nesnesi durum webhook'larında yer alır ve Meta'nın bir mesajı nasıl sınıflandırdığını gösterir: billable (kullanımdan kaldırılıyor), pricing_model PMP, type (regular, free_customer_service, free_entry_point veya free_group_customer_service), category (marketing, utility, authentication veya service gibi) ve isteğe bağlı subtype (paid_exempt). 1 Ekim 2026'dan itibaren regular, hizmet mesajları dahil ücretlendirilen her mesajı işaretler.

easyCoexistence, WhatsApp Business uygulamanızdaki numarayı Coexistence üzerinden Meta'nın Cloud API'sine bağlar ve bu nesneyi taşıyan durum webhook'larını sunucunuza iletir; böylece kendi sisteminiz kullanımı sayabilir.

PMP

Güncel webhook'larda pricing_model, mesaj başına fiyatlandırmadır; CBP yalnızca 1 Temmuz 2025'ten önce gönderilen webhook'larda görünür.

1,000

1 Ekim 2026'dan itibaren, işletme telefon numarası başına aylık Meta ücretsiz katmanı içinde teslim edilen hizmet mesajları.

regular

Numaranın ücretsiz katmanı kullanıldıktan sonra teslim edilen hizmet mesajları dahil, ücretli bir mesajın type değeri.

paid_exempt

Kuruluşun uygun bir devlet veya kâr amacı gütmeyen kuruluş olması nedeniyle ücretsiz olan hizmet mesajlarındaki subtype.

0

Webhook'lardaki kademeleme ayrıntıları; hacim kademesi bilgisi için Meta, pricing_analytics alanına işaret eder.

Fiyatlandırma nesnesi nerede görünür?

Yalnızca durumlarda ve bunların bazılarında görünür: Meta, nesneyi sent durumu ile delivered veya read durumlarından biriyle birlikte gönderir. Meta'nın referansındaki v24.0 örneği, nesnenin sent durumunda eksik olduğunu, çünkü delivered webhook'unda geldiğini gösterir. Failed durumları hiçbir zaman taşımaz. Bu yüzden fiyatlandırmayı mesajın bir özelliği olarak ele alın, wamid ile anahtarlayın ve hangi durum getirirse getirsin bir kez kaydedin. Meta'nın, bir hizmet mesajı için aylık ücretsiz katman dolmadan önce ve sonra nesnenin örnekleri:

Meta's examples: a service message in the free tier, then a charged one
// Service message delivered while the number is within its free tier
"pricing": {
  "billable": false,
  "pricing_model": "PMP",
  "type": "free_customer_service",
  "category": "service"
}

// Service message delivered after the number's free tier has been used
"pricing": {
  "billable": true,
  "pricing_model": "PMP",
  "type": "regular",
  "category": "service"
}

1 Ekim 2026'dan itibaren type değerleri ne anlama geliyor?

type, Meta'nın ücret alıp almadığını yanıtlayan alandır. Anlamı 1 Ekim 2026'da değişti; o tarihte Meta, hizmet mesajları ile bir müşterinin yanıtı olarak gönderilen yardımcı şablonlar için mesaj başına ücretlendirmeye başladı. Bu tarihten önce yazılmış kod, free_customer_service değerini açık pencerede bir yanıt olarak okuyabilir; artık bu değer, numaranın aylık ücretsiz katmanı içindeki birebir bir hizmet mesajı anlamına gelir. billable hâlâ görünür ama Meta kullanımdan kaldırılacağını söylüyor ve type ile category'yi birlikte okumanızı istiyor.

Through 30 Sep 2026From 1 Oct 2026
regularA billable messageBillable, now including utility replies to customers and service messages past the number's monthly tier
free_customer_serviceA utility template or non-template message sent in an open windowA one-to-one service message within the number's monthly tier
free_group_customer_serviceGroup utility or non-template message in an open group windowA group service message within the number's monthly tier
free_entry_pointSent in an open free entry point windowUnchanged

Bir mesajın hangi kategorileri olabilir?

category, ücret alındığında Meta'nın uyguladığı oran adını verir; Meta faturasıyla uzlaşırken gruplandırmak için kullanılacak alan budur, bunun yanında müşterinin numarasının ülkesi de gerekir çünkü oranlar pazara göre değişir. Bir mesajın bir kategorisi ve yalnızca bir ücreti vardır: şablon olmayan, promosyon içerikli bir mesaj hâlâ bir hizmet mesajıdır, ek bir pazarlama ücreti değildir. Meta'nın listelediği değerler:

marketingMarketing template rate.
utilityUtility template rate.
authenticationAuthentication template rate.
authentication-internationalAuthentication-international rate.
serviceNon-template message sent in reply to a customer.
marketing_liteMarketing Messages API for WhatsApp pricing.
referral_conversionMessage in a free entry point window.
group_marketing, group_utility, group_serviceThe same categories for group messages.

Webhook'lardan ücretler nasıl sayılır?

Webhook'lar hangi mesajların ücretli olduğunu ve hangi kategoride olduğunu söyler, ne kadara mal olduklarını değil. Meta'nın faturalamasıyla eşleşen bir kullanım görünümü oluşturmak için mesajları ve kategorileri sayın, sonra her pazar için Meta'nın yayımlanmış oranlarını uygulayın ya da mesaj bazında dökümler ve kademeleme veren pricing_analytics alanını okuyun.

  • Wamid'e göre tekilleştirin; fiyatlandırma birden fazla durumda gelebilir ve yeniden denemeler webhook'ları tekrarlar.
  • type regular olduğunda bir mesajı ücretli sayın; kategoriye ve alıcının ülkesine göre gruplandırın.
  • Başarısız mesajları yok sayın: Meta yalnızca teslim edilen mesajlardan ücret alır.
  • v24.0'dan itibaren, her pencerede id'si benzersiz olan ücretsiz giriş noktası penceresi dışında conversation nesnesi beklemeyin.

Bu, Coexistence numarasındaki yapay zekâ yanıtları için ne anlama gelir?

API üzerinden yapay zekânızın veya bir otomasyonun gönderdiği her yanıt şablon olmayan bir mesajdır, dolayısıyla kategorisi service'tir: numaranın aylık ücretsiz katmanı içinde free_customer_service görünür, bundan sonra ise regular. Yapay zekânızın send_template ile gönderdiği şablonlar kendi kategorilerini taşır. Maliyet açısından önemli bir fark, Meta'nın Coexistence rehberinde belirtilir: WhatsApp Business uygulamasında sahibin yazdığı mesajlar müşteri hizmetleri penceresine tabi değildir ve Cloud API fiyatlandırmasını etkilemez.

Meta, mesajları işletmenin kendi WhatsApp Business Hesabına mesaj başına, kategoriye ve ülkeye göre faturalandırır; easyCoexistence bunlara asla kâr eklemez ve yapay zekâ kullanımı kendi anahtarınızla yapay zekâ sağlayıcınız tarafından faturalandırılır.

Yaygın hatalar

  • Fiyatlandırma nesnesini her göründüğünde saymak. Aynı mesajın birden fazla durumunda gelebilir; wamid başına bir kez sayın.
  • Yalnızca billable'a bakmak. Meta bunu kullanımdan kaldırıyor ve type ile category'yi birlikte kullanmanızı istiyor.
  • Ekim öncesi free_customer_service okumasını sürdürmek. 1 Ekim 2026'dan itibaren numaranın aylık ücretsiz katmanı içindeki bir hizmet mesajını işaretler.
  • Payload'da tutar beklemek. Nesne kategoriyi adlandırır; oranlar Meta'nın ücret tablolarından ya da pricing_analytics'ten gelir.
Bunu EasyCoexistence'la yapmak

Meta'nın ücretleri kendi WhatsApp Business Hesabınızda kalır ve asla kâr eklenmez. Numara başına aylık US$ 9'dan US$ 0.75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Bir mesajın ücretini hangi hesap öder?

Mesajı gönderen WhatsApp Business Hesabı. Aynı numaradan birden fazla hesap gönderdiğinde Meta, her ücreti kendi ödeme yöntemi ve harcama limitleriyle o mesajı gönderen hesaba atar.

marketing_lite nedir?

marketing_lite, Meta'nın WhatsApp için Marketing Messages API üzerinden gönderilen mesajlara uygulanan kategori ve tür fiyatlandırmasıdır; pazarlama şablonları için ayrı bir gönderim yoludur ve teslimat başına en yüksek fiyat gibi kendi fiyatlandırma seçeneklerine sahiptir.

Mesaj fiyatlandırması konuşmaların yerini ne zaman aldı?

1 Temmuz 2025'te. Bu tarihten önce gönderilen webhook'lar pricing_model değeri olarak CBP (konuşma bazlı fiyatlandırma) gösterebilir; sonrakiler PMP gösterir. Ücretleri hâlâ conversation id alanına göre gruplayan kodun güncellenmesi gerekir.

Ücretsiz katman her ay sıfırlanır mı?

Evet. Meta, her işletme telefon numarasına ay başına 1.000 teslim edilen hizmet mesajı verir; devreden bakiye yoktur ve sıfırlama, WhatsApp Business Hesabının saat diliminde gece yarısı yapılır.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi