AccediInizia la prova gratuita
Meta Tech Provider

Oggetto pricing nei webhook WhatsApp: type, categoria e billable (2026)

L'oggetto pricing viaggia nei webhook di stato e indica come Meta ha classificato un messaggio: billable (in dismissione), pricing_model PMP, type (regular, free_customer_service, free_entry_point o free_group_customer_service), categoria come marketing, utility, authentication o service, e un subtype facoltativo paid_exempt. Dal 1 ottobre 2026, regular contrassegna ogni messaggio addebitato, inclusi i messaggi di servizio.

easyCoexistence collega il numero della tua app WhatsApp Business alla Cloud API di Meta tramite Coexistence e inoltra al tuo server i webhook di stato che portano questo oggetto, così il tuo sistema può conteggiare il consumo.

PMP

pricing_model nei webhook attuali è il pricing per messaggio; CBP compare solo nei webhook inviati prima del 1 luglio 2025.

1,000

Messaggi di servizio recapitati per numero di telefono aziendale al mese, entro il piano gratuito di Meta, dal 1 ottobre 2026.

regular

Il type di un messaggio addebitato, inclusi i messaggi di servizio recapitati dopo che il numero ha esaurito il piano gratuito.

paid_exempt

Il subtype dei messaggi di servizio gratuiti perché l'organizzazione è un ente governativo o no-profit idoneo.

0

Dettagli sugli scaglioni nei webhook; Meta rimanda al campo pricing_analytics per le informazioni sulle fasce di volume.

Dove compare l'oggetto pricing?

Solo sugli stati, e solo su alcuni: Meta lo include con lo stato sent e con uno tra delivered o read. Un esempio v24.0 nel riferimento di Meta lo mostra assente su sent perché è arrivato sul webhook delivered. Gli stati failed non lo portano mai. Quindi tratta il pricing come una proprietà del messaggio, identificata dal wamid, e registralo una sola volta, qualunque stato lo porti. Ecco gli esempi dell'oggetto di Meta per un messaggio di servizio, prima e dopo l'esaurimento del piano gratuito mensile del numero:

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

Cosa significano i valori di type dal 1 ottobre 2026?

type è il campo che risponde alla domanda se Meta addebita. Il suo significato è cambiato il 1 ottobre 2026, quando Meta ha iniziato ad addebitare per messaggio i messaggi di servizio e i template di utility inviati in risposta a un cliente. Il codice scritto prima di quella data può leggere free_customer_service come una risposta nella finestra aperta; ora indica un messaggio di servizio uno a uno entro il piano gratuito mensile del numero. billable è ancora presente, ma Meta dice che sarà dismesso e chiede di leggere type e category insieme.

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

Quali categorie può avere un messaggio?

category indica la tariffa che Meta applica quando addebita, ed è il campo per cui raggruppare quando riconcili con la fattura di Meta, insieme al paese del numero del cliente, perché le tariffe variano per mercato. Un messaggio ha una sola categoria e un solo addebito: un messaggio non-template con contenuto promozionale resta un messaggio di servizio, mai un addebito marketing in più. I valori che Meta elenca:

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.

Come si contano gli addebiti dai webhook?

I webhook indicano quali messaggi sono fatturabili e in quale categoria, non quanto costano. Per costruire una vista di consumo che corrisponda alla fatturazione di Meta, conta per messaggio e per categoria, poi applica le tariffe pubblicate da Meta per ogni mercato, oppure leggi il campo pricing_analytics di Meta, che fornisce il dettaglio per messaggio e gli scaglioni.

  • Deduplica sul wamid, perché il pricing può viaggiare su più di uno stato e i nuovi tentativi ripetono i webhook.
  • Conta un messaggio come addebitato quando type è regular; raggruppa per category e per paese del destinatario.
  • Ignora i messaggi falliti: Meta addebita solo quelli recapitati.
  • Dalla v24.0, non aspettarti alcun oggetto conversation tranne all'interno della finestra del punto di ingresso gratuito, dove il suo id è unico per finestra.

Cosa significa per le risposte AI su un numero Coexistence?

Ogni risposta che la tua AI o un'automazione invia tramite API è un messaggio non-template, quindi la sua categoria è service: entro il piano gratuito mensile del numero compare free_customer_service, e dopo, regular. I template che la tua AI invia con send_template portano la loro categoria. La guida Coexistence di Meta aggiunge una differenza che conta per i costi: i messaggi che il titolare scrive nell'app WhatsApp Business non sono soggetti alla finestra di assistenza clienti e non incidono sul pricing della Cloud API.

Meta fattura i messaggi sull'account WhatsApp Business dell'azienda, per messaggio, per categoria e paese; easyCoexistence non applica mai un ricarico, e l'uso dell'AI è fatturato dal tuo provider AI con la tua chiave.

Errori comuni

  • Contare l'oggetto pricing ogni volta che compare. Può arrivare su più di uno stato dello stesso messaggio; conta una volta per wamid.
  • Leggere billable da solo. Meta lo sta dismettendo e chiede di usare type e category insieme.
  • Mantenere la lettura pre-ottobre di free_customer_service. Dal 1 ottobre 2026 indica un messaggio di servizio entro il piano gratuito mensile del numero.
  • Aspettarsi importi nel payload. L'oggetto indica la categoria; le tariffe vengono dai listini di Meta o da pricing_analytics.
Farlo con EasyCoexistence

Gli addebiti di Meta restano sul tuo account WhatsApp Business e non vengono mai ricaricati. Da US$ 9 a US$ 0.75 per numero al mese, con calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

Quale account paga un messaggio?

L'account WhatsApp Business che lo ha inviato. Quando più account inviano sullo stesso numero, Meta attribuisce ogni addebito all'account che ha inviato quel messaggio, con il proprio metodo di pagamento e i propri limiti di spesa.

Cos'è marketing_lite?

La categoria e il tipo di pricing per i messaggi inviati tramite l'API di Meta per i messaggi di marketing su WhatsApp, un percorso di invio separato per i template di marketing con opzioni di prezzo proprie, come un prezzo massimo per consegna.

Quando il pricing per messaggio ha sostituito le conversazioni?

Il 1 luglio 2025. I webhook inviati prima di quella data possono mostrare pricing_model CBP, il pricing basato sulle conversazioni; quelli successivi mostrano PMP. Il codice che raggruppa ancora gli addebiti per id di conversazione va aggiornato.

Il piano gratuito si azzera ogni mese?

Sì. Meta concede a ogni numero di telefono aziendale 1.000 messaggi di servizio recapitati al mese, senza riporto, azzerati a mezzanotte nel fuso orario dell'account WhatsApp Business.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il