InloggenGratis proefperiode starten
Meta Tech Provider

WhatsApp webhook prijsobject: type, categorie en factureerbaar (2026)

Het prijsobject zit in status-webhooks en laat zien hoe Meta een bericht heeft ingedeeld: factureerbaar (wordt uitgefaseerd), pricing_model PMP, type (regular, free_customer_service, free_entry_point of free_group_customer_service), categorie zoals marketing, utility, authentication of service, en een optioneel subtype paid_exempt. Sinds 1 oktober 2026 markeert regular elk bericht dat wordt gefactureerd, ook serviceberichten.

easyCoexistence koppelt je WhatsApp Business-app-nummer via Coexistence aan de Cloud API van Meta en stuurt de status-webhooks die dit object bevatten naar je server, zodat je eigen systeem het gebruik kan optellen.

PMP

pricing_model op huidige webhooks is prijs per bericht; CBP verschijnt alleen op webhooks die vóór 1 juli 2025 zijn verstuurd.

1,000

Afgeleverde serviceberichten per bedrijfstelefoonnummer per maand binnen de gratis tier van Meta, vanaf 1 oktober 2026.

regular

Het type van een gefactureerd bericht, inclusief serviceberichten die worden afgeleverd nadat de gratis tier van het nummer op is.

paid_exempt

Het subtype op serviceberichten die gratis zijn omdat de organisatie in aanmerking komt als overheids- of non-profitorganisatie.

0

Staffelingsdetails in webhooks; Meta verwijst naar het veld pricing_analytics voor informatie over volumestaffels.

Waar verschijnt het prijsobject?

Alleen op statussen, en ook dan niet op alle: Meta voegt het toe bij de status sent en bij een van delivered of read. Een voorbeeld van v24.0 in de referentie van Meta laat het ontbreken bij sent, omdat het in plaats daarvan op de delivered-webhook kwam. Mislukte statussen bevatten het nooit. Behandel prijs dus als eigenschap van het bericht, gekoppeld aan de wamid, en registreer het één keer, welke status het ook meebrengt. Dit zijn de eigen voorbeelden van Meta van het object voor een servicebericht, vóór en nadat de maandelijkse gratis tier van het nummer op is:

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

Wat betekenen de typewaarden sinds 1 oktober 2026?

type is het veld dat aangeeft of Meta kosten rekent. De betekenis veranderde op 1 oktober 2026, toen Meta per bericht begon te factureren voor serviceberichten en voor utility-templates die als antwoord op een klant worden verstuurd. Code die vóór die datum is geschreven, kan free_customer_service lezen als antwoord binnen het open venster; het betekent nu een één-op-één servicebericht binnen de maandelijkse gratis tier van het nummer. billable verschijnt nog steeds, maar Meta zegt dat het wordt uitgefaseerd en vraagt om type en categorie samen te lezen.

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

Welke categorieën kan een bericht hebben?

De categorie noemt het tarief dat Meta toepaste bij facturering. Groepeer hierop wanneer je afstemt met de factuur van Meta, samen met het land van het nummer van de klant, want tarieven verschillen per markt. Een bericht heeft één categorie en één enkele kosten: een niet-template-bericht met promotionele inhoud is nog steeds een servicebericht, nooit een extra marketingkost. De waarden die Meta noemt:

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.

Hoe tel je kosten vanuit webhooks?

Webhooks vertellen je welke berichten factureerbaar zijn en in welke categorie, niet wat ze kosten. Om een gebruiksoverzicht te bouwen dat overeenkomt met de facturatie van Meta, tel je per bericht en per categorie, en pas je de gepubliceerde tarieven van Meta toe per markt, of lees je het veld pricing_analytics van Meta, dat uitsplitsingen per bericht en staffels geeft.

  • Ontdubbel op de wamid, want prijs kan op meer dan één status meekomen en herhaalde webhooks komen dubbel binnen.
  • Tel een bericht als gefactureerd wanneer type regular is; groepeer op categorie en het land van de ontvanger.
  • Negeer mislukte berichten: Meta factureert alleen afgeleverde berichten.
  • Vanaf v24.0 verwacht je geen conversation-object, behalve binnen een venster van free_entry_point, waar het id per venster uniek is.

Wat betekent dit voor AI-antwoorden op een Coexistence-nummer?

Elk antwoord dat je AI of een automatisering via de API verstuurt, is een niet-template-bericht, dus de categorie is service: binnen de maandelijkse gratis tier van het nummer staat er free_customer_service, en daarna regular. Templates die je AI verstuurt met send_template dragen hun eigen categorie. De gids over Coexistence van Meta voegt één verschil toe dat voor de kosten telt: berichten die de eigenaar in de WhatsApp Business-app typt, vallen niet onder het klantservicevenster en beïnvloeden de prijs van de Cloud API niet.

Meta factureert berichten aan het eigen WhatsApp Business Account van het bedrijf, per bericht, per categorie en land; easyCoexistence rekent er nooit een opslag op, en AI-gebruik wordt door je AI-aanbieder gefactureerd op je eigen sleutel.

Veelgemaakte fouten

  • Het prijsobject elke keer tellen wanneer het verschijnt. Het kan op meer dan één status van hetzelfde bericht komen; tel één keer per wamid.
  • Alleen billable lezen. Meta faseert het uit en vraagt om type en categorie samen te gebruiken.
  • De pre-oktoberlezing van free_customer_service aanhouden. Sinds 1 oktober 2026 markeert het een servicebericht binnen de maandelijkse gratis tier van het nummer.
  • Bedragen in de payload verwachten. Het object noemt de categorie; tarieven komen van de tarieflijsten van Meta of pricing_analytics.
Dit doen met EasyCoexistence

De kosten van Meta blijven op je eigen WhatsApp Business Account en worden nooit met een opslag doorberekend. Van US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Welk account betaalt voor een bericht?

Het WhatsApp Business Account dat het bericht heeft verstuurd. Wanneer meerdere accounts op één nummer versturen, rekent Meta elke kost af bij het account dat dat bericht verstuurde, met een eigen betaalmethode en uitgavenlimieten.

Wat is marketing_lite?

De categorie en het type prijzen voor berichten die via de Marketing Messages API van Meta voor WhatsApp worden verstuurd, een afzonderlijk verzendpad voor marketingtemplates met eigen prijsopties, zoals een maximumprijs per aflevering.

Wanneer verving prijs per bericht de gesprekken?

Op 1 juli 2025. Webhooks die vóór die datum zijn verstuurd, kunnen pricing_model CBP tonen, gesprekgebaseerde prijs; latere tonen PMP. Code die kosten nog groepeert op conversation-id, moet worden bijgewerkt.

Reset de gratis tier elke maand?

Ja. Meta geeft elk bedrijfstelefoonnummer 1.000 afgeleverde serviceberichten per maand, zonder overdracht naar de volgende maand, en reset om middernacht in de tijdzone van het WhatsApp Business Account.

Lees verder

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode

Geverifieerd op