Objek pricing webhook WhatsApp: type, category dan billable (2026)
Objek pricing dikirim bersama webhook status dan menyatakan bagaimana Meta mengklasifikasikan sebuah pesan: billable (akan dihentikan), pricing_model PMP, type (regular, free_customer_service, free_entry_point, atau free_group_customer_service), category seperti marketing, utility, authentication, atau service, serta subtype opsional paid_exempt. Sejak 1 Oktober 2026, regular menandai setiap pesan yang dikenai biaya, termasuk pesan layanan.
easyCoexistence menghubungkan nomor aplikasi WhatsApp Business Anda ke Cloud API Meta melalui Coexistence dan meneruskan webhook status yang membawa objek ini ke server Anda, sehingga sistem Anda bisa menghitung penggunaan.
pricing_model pada webhook terkini adalah harga per pesan; CBP hanya muncul pada webhook yang dikirim sebelum 1 Juli 2025.
Pesan layanan yang terkirim per nomor telepon bisnis per bulan dalam tingkat gratis Meta, mulai 1 Oktober 2026.
type dari pesan yang dikenai biaya, termasuk pesan layanan yang terkirim setelah tingkat gratis nomor tersebut habis terpakai.
subtype pada pesan layanan yang gratis karena organisasinya memenuhi syarat sebagai pemerintah atau nirlaba.
Rincian tingkat di webhook; Meta merujuk pada field pricing_analytics untuk informasi tingkat volume.
Di mana objek pricing muncul?
Hanya ada pada status, dan hanya pada sebagian status: Meta menyertakannya bersama status sent dan salah satu dari delivered atau read. Contoh v24.0 dalam referensi Meta menunjukkan objek itu tidak ada pada sent karena justru datang pada webhook delivered. Status failed tidak pernah membawanya. Maka perlakukan pricing sebagai properti pesan, berdasarkan wamid, dan catat sekali saja pada status mana pun yang membawanya. Berikut contoh objek dari Meta untuk pesan layanan, sebelum dan sesudah tingkat gratis bulanan nomor tersebut habis:
// 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"
}Apa arti nilai type sejak 1 Oktober 2026?
type adalah field yang menjawab apakah Meta mengenakan biaya. Artinya bergeser pada 1 Oktober 2026, ketika Meta mulai mengenakan biaya per pesan untuk pesan layanan dan untuk template utility yang dikirim sebagai balasan atas pesan pelanggan. Kode yang ditulis sebelum tanggal itu mungkin membaca free_customer_service sebagai balasan dalam jendela terbuka; kini artinya pesan layanan satu-ke-satu dalam tingkat gratis bulanan nomor tersebut. billable masih muncul, tetapi Meta menyatakan akan dihentikan, dan meminta Anda membaca type dan category bersamaan.
| Through 30 Sep 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
Kategori apa saja yang bisa dimiliki sebuah pesan?
category menamai tarif yang diterapkan Meta saat mengenakan biaya, dan ini adalah field untuk dikelompokkan ketika Anda mencocokkan dengan tagihan Meta, bersama negara nomor pelanggan, karena tarif berbeda di tiap pasar. Satu pesan memiliki satu category dan hanya satu biaya: pesan non-template dengan konten promosi tetap merupakan pesan layanan, bukan tambahan biaya marketing. Nilai yang dicantumkan Meta:
Bagaimana cara menghitung biaya dari webhook?
Webhook memberi tahu Anda pesan mana yang dapat ditagih dan pada kategori apa, bukan berapa biayanya. Untuk membuat tampilan penggunaan yang sesuai dengan tagihan Meta, hitung per pesan dan per kategori, lalu terapkan tarif Meta yang dipublikasikan untuk tiap pasar, atau baca field pricing_analytics Meta, yang memberikan rincian per pesan dan pembagian tingkat.
- Hapus duplikat berdasarkan wamid, sebab pricing bisa dikirim pada lebih dari satu status, dan webhook bisa terulang saat Meta mencoba kembali.
- Hitung sebuah pesan sebagai dikenai biaya saat type bernilai regular; kelompokkan menurut category dan negara penerima.
- Abaikan pesan failed: Meta hanya mengenakan biaya untuk pesan yang delivered.
- Mulai v24.0, jangan berharap ada objek conversation kecuali di dalam jendela free entry point, di mana id-nya unik per jendela.
Apa artinya untuk balasan AI pada nomor Coexistence?
Setiap balasan yang dikirim AI Anda atau otomatisasi melalui API adalah pesan non-template, sehingga category-nya service: dalam tingkat gratis bulanan nomor tersebut tampil sebagai free_customer_service, dan setelah itu sebagai regular. Template yang dikirim AI Anda dengan send_template membawa category sendiri. Panduan Coexistence dari Meta menambahkan satu perbedaan yang penting untuk biaya: pesan yang diketik pemilik di aplikasi WhatsApp Business tidak tunduk pada jendela layanan pelanggan dan tidak memengaruhi harga Cloud API.
Meta menagihkan pesan ke WhatsApp Business Account milik bisnis, per pesan, menurut kategori dan negara; easyCoexistence tidak pernah menambahkan markup, dan penggunaan AI ditagihkan oleh penyedia AI Anda dengan kunci Anda sendiri.
Kesalahan umum
- Menghitung objek pricing setiap kali muncul. Objek ini bisa datang pada lebih dari satu status dari pesan yang sama; hitung sekali per wamid.
- Hanya membaca billable. Meta sedang menghentikannya dan meminta Anda memakai type dan category bersamaan.
- Tetap memakai pembacaan free_customer_service dari sebelum Oktober. Sejak 1 Oktober 2026, nilai ini menandai pesan layanan di dalam tingkat gratis bulanan nomor tersebut.
- Berharap ada nominal di payload. Objek ini hanya menyebut category; tarif berasal dari daftar tarif Meta atau pricing_analytics.
Biaya Meta tetap berada di WhatsApp Business Account Anda dan tidak pernah ditambah markup. Dari US$ 9 turun hingga US$ 0.75 per nomor per bulan, makin turun seiring Anda menambah nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Akun mana yang membayar sebuah pesan?
WhatsApp Business Account yang mengirimnya. Saat beberapa akun mengirim lewat satu nomor, Meta membebankan setiap biaya ke akun yang mengirim pesan itu, dengan metode pembayaran dan batas pengeluarannya sendiri.
Apa itu marketing_lite?
Nilai category dan type untuk pesan yang dikirim melalui Marketing Messages API Meta untuk WhatsApp, jalur pengiriman terpisah untuk template pemasaran dengan opsi harga sendiri, seperti harga maksimum per pengiriman.
Sejak kapan harga per pesan menggantikan percakapan?
Pada 1 Juli 2025. Webhook yang dikirim sebelum tanggal itu bisa menampilkan pricing_model CBP, harga berbasis percakapan; yang lebih baru menampilkan PMP. Kode yang masih mengelompokkan biaya menurut id percakapan perlu diperbarui.
Apakah tingkat gratis direset setiap bulan?
Ya. Meta memberi setiap nomor telepon bisnis 1,000 pesan layanan yang terkirim per bulan, tanpa sisa yang dibawa ke bulan berikutnya, direset pada tengah malam menurut zona waktu WhatsApp Business Account.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada