Objek harga webhook WhatsApp: type, category dan billable (2026)
Objek harga dibawa dalam webhook status dan menyatakan bagaimana Meta mengelaskan sesuatu mesej: billable (sedang dihentikan), pricing_model PMP, type (regular, free_customer_service, free_entry_point atau free_group_customer_service), category seperti marketing, utility, authentication atau service, dan subtype pilihan iaitu paid_exempt. Sejak 1 Oktober 2026, regular menandakan setiap mesej yang dikenakan caj, termasuk mesej perkhidmatan.
easyCoexistence menyambungkan nombor aplikasi WhatsApp Business anda ke Cloud API Meta melalui Coexistence dan menghantar webhook status yang membawa objek ini ke pelayan anda, supaya sistem anda sendiri boleh mengira penggunaan.
pricing_model pada webhook semasa ialah harga setiap mesej; CBP hanya muncul pada webhook yang dihantar sebelum 1 Julai 2025.
Mesej perkhidmatan yang berjaya dihantar setiap nombor telefon perniagaan sebulan dalam peringkat percuma Meta, bermula 1 Oktober 2026.
Nilai type bagi mesej yang dikenakan caj, termasuk mesej perkhidmatan yang dihantar selepas peringkat percuma nombor itu habis digunakan.
Subtype pada mesej perkhidmatan yang percuma kerana organisasi itu layak sebagai kerajaan atau bukan untung.
Butiran peringkat dalam webhook; Meta merujuk medan pricing_analytics untuk maklumat peringkat volum.
Di mana objek harga muncul?
Hanya pada status, dan hanya pada sebahagian daripadanya: Meta menyertakannya bersama status sent dan salah satu daripada delivered atau read, dan contoh v24.0 dalam rujukan Meta menunjukkan ia tiada pada sent kerana ia tiba pada webhook delivered. Status failed tidak pernah membawanya. Oleh itu, anggap harga sebagai sifat mesej, dikenal pasti dengan wamid, dan rekodkan sekali sahaja, tidak kira status mana yang membawanya. Berikut contoh objek itu daripada Meta bagi mesej perkhidmatan, sebelum dan selepas peringkat percuma bulanan nombor itu 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"
}Apakah maksud nilai type sejak 1 Oktober 2026?
type ialah medan yang menjawab sama ada Meta mengenakan caj. Maksudnya berubah pada 1 Oktober 2026, apabila Meta mula mengenakan caj setiap mesej bagi mesej perkhidmatan dan template utiliti yang dihantar sebagai balasan kepada pelanggan. Kod yang ditulis sebelum tarikh itu mungkin membaca free_customer_service sebagai balasan dalam tetingkap khidmat pelanggan yang terbuka; kini ia bermaksud mesej perkhidmatan satu lawan satu dalam peringkat percuma bulanan nombor. billable masih muncul tetapi Meta menyatakan ia akan dihentikan, dan meminta anda membaca type dan category bersama-sama.
| 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 |
Apakah kategori yang boleh dimiliki sesuatu mesej?
category menamakan kadar yang Meta gunakan apabila ia mengenakan caj, dan ia ialah medan untuk dikumpulkan apabila anda membuat pemadanan dengan invois Meta, bersama negara nombor pelanggan, kerana kadar berbeza mengikut pasaran. Satu mesej ada satu kategori dan hanya satu caj: mesej bukan template yang berkandungan promosi masih mesej perkhidmatan, dan tidak pernah dikenakan caj pemasaran tambahan. Nilai yang disenaraikan Meta:
Bagaimana anda mengira caj daripada webhook?
Webhook memberitahu anda mesej mana yang boleh dikenakan caj dan pada kategori mana, bukan kosnya. Untuk membina paparan penggunaan yang sepadan dengan bil Meta, kira mengikut mesej dan mengikut kategori, kemudian gunakan kadar yang diterbitkan Meta bagi setiap pasaran, atau baca medan pricing_analytics Meta, yang memberikan pecahan mengikut mesej dan peringkat.
- Buang pendua berdasarkan wamid, kerana harga boleh dibawa oleh lebih daripada satu status dan cubaan semula mengulang webhook.
- Kira mesej sebagai dikenakan caj apabila type ialah regular; kumpulkan mengikut category dan negara penerima.
- Abaikan mesej yang gagal: Meta hanya mengenakan caj bagi mesej yang berjaya dihantar.
- Bermula v24.0, jangan jangka adanya objek conversation kecuali dalam tetingkap titik masuk percuma, dengan id yang unik bagi setiap tetingkap.
Apakah maksudnya bagi balasan AI pada nombor Coexistence?
Setiap balasan yang dihantar oleh AI anda atau automasi melalui API ialah mesej bukan template, jadi kategorinya ialah service: dalam peringkat percuma bulanan nombor, ia menunjukkan free_customer_service, dan selepas itu, regular. Template yang dihantar AI anda dengan send_template membawa kategorinya sendiri. Satu perbezaan dalam panduan Coexistence Meta penting untuk kos: mesej yang ditaip pemilik dalam aplikasi WhatsApp Business tidak tertakluk kepada tetingkap khidmat pelanggan dan tidak menjejaskan harga Cloud API.
Meta mengenakan caj mesej kepada Akaun WhatsApp Business perniagaan itu sendiri, setiap mesej, mengikut kategori dan negara; easyCoexistence tidak pernah menambah markup, dan penggunaan AI dikenakan bil oleh pembekal AI anda menggunakan kunci anda sendiri.
Kesilapan biasa
- Mengira objek harga setiap kali ia muncul. Ia boleh datang pada lebih daripada satu status bagi mesej yang sama; kira sekali bagi setiap wamid.
- Membaca billable sahaja. Meta sedang menghentikannya dan meminta anda menggunakan type dan category bersama-sama.
- Mengekalkan bacaan free_customer_service sebelum Oktober. Sejak 1 Oktober 2026, ia menandakan mesej perkhidmatan dalam peringkat percuma bulanan nombor.
- Menjangka amaun dalam payload. Objek ini menamakan kategori; kadar datang daripada jadual kadar Meta atau pricing_analytics.
Caj Meta kekal pada Akaun WhatsApp Business anda sendiri dan tidak pernah ditambah markup. Daripada US$ 9 hingga US$ 0.75 setiap nombor sebulan, menurun apabila anda menambah nombor, dengan 3 hari pertama percuma.
Soalan lazim
Akaun mana yang membayar untuk sesuatu mesej?
Akaun WhatsApp Business yang menghantarnya. Apabila beberapa akaun menghantar pada satu nombor, Meta mengaitkan setiap caj dengan akaun yang menghantar mesej itu, dengan kaedah pembayaran dan had perbelanjaan sendiri.
Apakah itu marketing_lite?
Kategori dan jenis harga bagi mesej yang dihantar melalui Marketing Messages API Meta untuk WhatsApp, laluan penghantaran berasingan bagi template pemasaran dengan pilihan harga sendiri, seperti harga maksimum bagi setiap penghantaran.
Bilakah harga setiap mesej menggantikan conversation?
Pada 1 Julai 2025. Webhook yang dihantar sebelum tarikh itu boleh menunjukkan pricing_model CBP, iaitu harga berasaskan conversation; yang kemudian menunjukkan PMP. Kod yang masih mengumpulkan caj mengikut id conversation perlu dikemas kini.
Adakah peringkat percuma ditetapkan semula setiap bulan?
Ya. Meta memberi setiap nombor telefon perniagaan 1,000 mesej perkhidmatan yang dihantar sebulan, tanpa dibawa ke bulan seterusnya, ditetapkan semula pada tengah malam mengikut zon waktu Akaun WhatsApp Business.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada