Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp-webhookin hinnoitteluobjekti: type, category ja billable (2026)

Hinnoitteluobjekti kulkee tilaswebhookien mukana ja kertoo, miten Meta on luokitellut viestin: billable (poistumassa käytöstä), pricing_model PMP, type (regular, free_customer_service, free_entry_point tai free_group_customer_service), category, esimerkiksi marketing, utility, authentication tai service, sekä valinnainen subtype, jonka arvo on paid_exempt. 1. lokakuuta 2026 alkaen regular merkitsee jokaisen veloitettavan viestin, myös palveluviestit mukaan lukien.

easyCoexistence yhdistää WhatsApp Business -sovelluksen numerosi Metan Cloud API -rajapintaan Coexistence-yhteyden kautta ja välittää tämän objektin sisältävät tilawebhookit palvelimellesi, jotta oma järjestelmäsi voi laskea käytön.

PMP

pricing_model nykyisissä webhookeissa on PMP eli viestikohtainen hinnoittelu; CBP näkyy vain webhookeissa, jotka on lähetetty ennen 1. heinäkuuta 2025.

1,000

Toimitetut palveluviestit yrityksen puhelinnumeroa kohden kuukaudessa Metan ilmaisen kiintiön sisällä, 1. lokakuuta 2026 alkaen.

regular

Veloitettavan viestin type, myös palveluviestien, jotka toimitetaan numeron ilmaisen kiintiön käytön jälkeen.

paid_exempt

Subtype palveluviesteissä, jotka ovat ilmaisia, koska organisaatio on oikeutettu valtion tai voittoa tavoittelemattoman järjestön.

0

Porrastustiedot webhookeissa; Meta ohjaa pricing_analytics-kenttään volyymiportaita koskevien tietojen osalta.

Mihin hinnoitteluobjekti ilmestyy?

Vain tilatiedoissa, ja vain joissakin niistä: Meta lisää sen sent-tilan mukana sekä delivered- tai read-tilan kanssa. Metan viiteasiakirjan v24.0-esimerkissä se puuttuu sent-tilasta, koska se tuli delivered-webhookin mukana. Failed-tilat eivät koskaan sisällä sitä. Käsittele hinnoittelua siksi viestin ominaisuutena, tunnista se wamid-tunnuksella ja tallenna se kerran, riippumatta siitä, mikä tila sen tuo mukanaan. Metan omat esimerkit palveluviestin objektista ennen kuukausittaisen ilmaisen kiintiön loppumista ja sen jälkeen:

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"
}

Mitä type-arvot tarkoittavat 1. lokakuuta 2026 alkaen?

type on kenttä, joka kertoo, veloittaako Meta. Sen merkitys muuttui 1. lokakuuta 2026, jolloin Meta alkoi veloittaa viestikohtaisesti palveluviesteistä ja asiakkaalle vastauksena lähetetyistä utility-viestipohjista. Ennen tätä päivää kirjoitettu koodi on saattanut lukea free_customer_service-arvon vastaukseksi avoimen ikkunan sisällä. Nyt se tarkoittaa kahdenkeskistä palveluviestiä kuukausittaisen ilmaisen kiintiön sisällä. billable näkyy yhä, mutta Meta sanoo sen poistuvan käytöstä ja pyytää lukemaan type- ja category-kentät yhdessä.

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

Mitä kategorioita viestillä voi olla?

category nimeää hinnan, jonka Meta soveltaa veloituksessa. Se on kenttä, jonka mukaan ryhmitellään laskua verrattaessa Metan laskuun, yhdessä asiakkaan numeron maan kanssa, sillä hinnat vaihtelevat markkinoittain. Yhdellä viestillä on yksi category ja vain yksi veloitus: ei-mallipohjainen viesti, jossa on mainossisältöä, on yhä palveluviesti, eikä sille synny lisäksi marketing-veloitusta. Arvot, jotka Meta listaa:

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.

Miten veloitukset lasketaan webhookeista?

Webhookit kertovat, mitkä viestit ovat veloitettavia ja mihin category kuuluu, eivät sitä, mitä ne maksavat. Jotta käyttönäkymä vastaa Metan laskutusta, laske viestit ja category-arvot ja sovella sitten Metan julkaisemia hintoja kullekin markkinalle tai lue Metan pricing_analytics-kenttä, joka antaa viestikohtaiset erittelyt ja porrastuksen.

  • Poista päällekkäisyydet wamid-tunnuksen perusteella, sillä hinnoittelu voi tulla useammasta tilasta ja uudelleenyritykset lähettävät webhookit uudelleen.
  • Laske viesti veloitetuksi, kun type on regular; ryhmittele category-arvon ja vastaanottajan maan mukaan.
  • Jätä epäonnistuneet viestit huomioimatta: Meta veloittaa vain toimitetuista viesteistä.
  • Versiosta v24.0 alkaen conversation-objektia ei ole odotettavissa paitsi ilmaisen sisäänkäyntipisteen ikkunassa, jossa sen id on ainutlaatuinen ikkunakohtaisesti.

Mitä tämä tarkoittaa Coexistence-numeron tekoälyvastauksille?

Jokainen tekoälysi tai automaation API:n kautta lähettämä vastaus on ei-mallipohjainen viesti, joten sen category on service: kuukausittaisen ilmaisen kiintiön sisällä se näkyy arvolla free_customer_service ja sen jälkeen arvolla regular. send_template-kutsulla lähettämilläsi malleilla on oma category. Metan Coexistence-opas lisää yhden eron, joka vaikuttaa kustannuksiin: WhatsApp Business -sovelluksessa omistajan kirjoittamat viestit eivät ole asiakaspalveluikkunan alaisia eivätkä vaikuta Cloud API -hinnoitteluun.

Meta veloittaa viestit yrityksen omalta WhatsApp Business -tililtä viestikohtaisesti, category-arvon ja maan mukaan. easyCoexistence ei koskaan lisää niihin korotusta, ja tekoälyn käytön laskuttaa tekoälyn tarjoaja omalla avaimellasi.

Yleiset virheet

  • Hinnoitteluobjektin laskeminen joka kerta, kun se ilmestyy. Se voi tulla useammasta saman viestin tilasta; laske kerran wamid-tunnusta kohden.
  • billable yksinään lukeminen. Meta poistaa sen käytöstä ja pyytää käyttämään type- ja category-kenttiä yhdessä.
  • Vanhan, lokakuua edeltävän tulkinnan säilyttäminen free_customer_service-arvosta. 1. lokakuuta 2026 jälkeen se merkitsee palveluviestiä kuukausittaisen ilmaisen kiintiön sisällä.
  • Summien odottaminen payloadissa. Objekti nimeää categoryn; hinnat tulevat Metan hintataulukoista tai pricing_analytics-kentästä.
Näin teet tämän EasyCoexistencen avulla

Metan veloitukset pysyvät omalla WhatsApp Business -tililläsi, eikä niihin koskaan lisätä korotusta. US$ 9:stä US$ 0,75:een numeroa kohden kuukaudessa, ja hinta laskee, kun lisäät numeroita. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Kuka maksaa viestistä?

WhatsApp Business -tili, joka sen lähetti. Kun useampi tili lähettää numerosta, Meta kohdistaa jokaisen veloituksen tilille, joka kyseisen viestin lähetti, sen omalla maksutavalla ja kulutusrajoilla.

Mikä on marketing_lite?

Hinnoittelun category ja type viesteille, jotka lähetetään Metan Marketing Messages API for WhatsApp -rajapinnan kautta. Se on erillinen lähetyspolku markkinointimalleille, ja sillä on omat hinnoitteluvaihtoehdot, kuten enimmäishinta toimitusta kohden.

Milloin viestikohtainen hinnoittelu korvasi keskustelut?

1. heinäkuuta 2025. Sitä ennen lähetetyt webhookit voivat näyttää pricing_model-arvon CBP eli keskustelupohjainen hinnoittelu; myöhemmät näyttävät PMP:n. Koodi, joka ryhmittelee veloituksia yhä keskustelun id:n mukaan, on päivitettävä.

Nollaako ilmainen kiintiö joka kuukausi?

Kyllä. Meta antaa jokaiselle yrityksen puhelinnumerolle 1 000 toimitettua palveluviestiä kuukaudessa ilman siirtoa, ja kiintiö nollautuu keskiyöllä WhatsApp Business -tilin aikavyöhykkeen mukaan.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu