Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

Obiekt wyceny w webhookach WhatsApp: type, category i billable (2026)

Obiekt wyceny pojawia się w webhookach statusu i informuje, jak Meta sklasyfikowała wiadomość: billable (wycofywane), pricing_model PMP, type (regular, free_customer_service, free_entry_point lub free_group_customer_service), category, np. marketing, utility, authentication lub service, oraz opcjonalny subtype paid_exempt. Od 1 października 2026 roku regular oznacza każdą płatną wiadomość, także wiadomości serwisowe.

easyCoexistence łączy numer z aplikacji WhatsApp Business z Cloud API Meta przez Coexistence i przekazuje webhooki statusów zawierające ten obiekt na twój serwer, dzięki czemu twój własny system może policzyć zużycie.

PMP

pricing_model w bieżących webhookach to rozliczanie za wiadomość; CBP pojawia się tylko w webhookach wysłanych przed 1 lipca 2025.

1,000

Dostarczone wiadomości serwisowe na numer firmowy miesięcznie w ramach bezpłatnego limitu Meta, od 1 października 2026 roku.

regular

type płatnej wiadomości, w tym wiadomości serwisowych dostarczonych po wykorzystaniu bezpłatnego limitu numeru.

paid_exempt

subtype wiadomości serwisowych, które są bezpłatne, bo organizacja kwalifikuje się jako instytucja rządowa lub organizacja non-profit.

0

Szczegóły progów w webhookach; Meta wskazuje pole pricing_analytics jako źródło informacji o progach wolumenu.

Gdzie pojawia się obiekt wyceny?

Tylko w statusach i tylko w niektórych: Meta dołącza go do statusu sent oraz do jednego ze statusów delivered lub read, a przykład v24.0 w dokumentacji Meta pokazuje, że w sent go nie ma, bo przyszedł w webhooku delivered. Statusy failed nigdy go nie zawierają. Traktuj więc wycenę jako właściwość wiadomości, kluczowaną przez jej wamid, i zapisuj ją raz, z dowolnego statusu, który ją przynosi. Oto przykłady obiektu z dokumentacji Meta dla wiadomości serwisowej, przed i po wyczerpaniu miesięcznego bezpłatnego limitu numeru:

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

Co oznaczają wartości type od 1 października 2026 roku?

type to pole, które odpowiada na pytanie, czy Meta pobiera opłatę. Jego znaczenie zmieniło się 1 października 2026 roku, gdy Meta zaczęła pobierać opłatę za każdą wiadomość serwisową oraz za szablony utility wysyłane w odpowiedzi na wiadomość klienta. Kod napisany przed tą datą może odczytywać free_customer_service jako odpowiedź w otwartym oknie; teraz oznacza to wiadomość serwisową jeden do jednego w ramach miesięcznego bezpłatnego limitu numeru. billable nadal się pojawia, ale Meta zapowiada jego wycofanie i prosi, by czytać type i category razem.

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

Jakie kategorie może mieć wiadomość?

category to stawka, którą Meta zastosowała przy naliczaniu opłaty. Po niej grupuj, gdy uzgadniasz fakturę Meta, razem z krajem numeru klienta, bo stawki różnią się w zależności od rynku. Jedna wiadomość ma jedną kategorię i tylko jedną opłatę: wiadomość niebędąca szablonem, nawet z treścią promocyjną, pozostaje wiadomością serwisową, a nie dodatkową opłatą marketingową. Wartości, które wymienia Meta:

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.

Jak liczyć opłaty na podstawie webhooków?

Webhooki mówią, które wiadomości są płatne i w jakiej kategorii, ale nie to, ile kosztują. Aby zbudować widok zużycia zgodny z rozliczeniem Meta, licz według wiadomości i kategorii, a następnie zastosuj opublikowane przez Meta stawki dla każdego rynku, albo odczytaj pole pricing_analytics, które podaje rozbicie na wiadomości i progi.

  • Deduplikuj po wamid, bo wycena może pojawić się w więcej niż jednym statusie, a ponowienia powtarzają webhooki.
  • Licz wiadomość jako płatną, gdy type to regular; grupuj według category i kraju odbiorcy.
  • Ignoruj wiadomości failed: Meta pobiera opłaty tylko za dostarczone wiadomości.
  • Od v24.0 nie spodziewaj się obiektu conversation poza oknem bezpłatnego punktu wejścia, gdzie jego id jest unikalne dla każdego okna.

Co to oznacza dla odpowiedzi AI na numerze Coexistence?

Każda odpowiedź, którą twoja AI lub automatyzacja wysyła przez API, to wiadomość niebędąca szablonem, więc jej kategoria to service: w ramach miesięcznego bezpłatnego limitu numeru pokazuje free_customer_service, a po jego wyczerpaniu regular. Szablony, które twoja AI wysyła za pomocą send_template, mają własną kategorię. Przewodnik Meta po Coexistence wskazuje jedną różnicę ważną dla kosztów: wiadomości, które właściciel pisze w aplikacji WhatsApp Business, nie podlegają oknu obsługi klienta i nie wpływają na ceny Cloud API.

Meta rozlicza wiadomości na własnym koncie WhatsApp Business Account firmy, za każdą wiadomość, według kategorii i kraju; easyCoexistence nigdy nie nalicza do nich marży, a użycie AI rozlicza twój dostawca AI na własnym kluczu.

Typowe błędy

  • Liczenie obiektu wyceny za każdym razem, gdy się pojawia. Może pojawić się w więcej niż jednym statusie tej samej wiadomości; licz raz na wamid.
  • Czytanie samego billable. Meta go wycofuje i prosi o używanie type i category razem.
  • Zachowanie przedpaździernikowego odczytu free_customer_service. Od 1 października 2026 roku oznacza wiadomość serwisową w ramach miesięcznego bezpłatnego limitu numeru.
  • Oczekiwanie kwot w payloadzie. Obiekt podaje kategorię; stawki pochodzą z cenników Meta lub z pricing_analytics.
Z EasyCoexistence zrobisz to

Opłaty Meta pozostają na twoim koncie WhatsApp Business Account i nigdy nie są doliczane z marżą. Od US$ 9 do US$ 0.75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Które konto płaci za wiadomość?

Konto WhatsApp Business Account, które ją wysłało. Gdy na jednym numerze wysyła kilka kont, Meta przypisuje każdą opłatę do konta, które wysłało daną wiadomość, z jego własną metodą płatności i limitami wydatków.

Czym jest marketing_lite?

Kategorią i typem wyceny dla wiadomości wysyłanych przez Marketing Messages API for WhatsApp Meta, osobną ścieżkę wysyłki szablonów marketingowych z własnymi opcjami cenowymi, na przykład maksymalną ceną za dostarczenie.

Kiedy wycena za wiadomość zastąpiła rozmowy?

1 lipca 2025 roku. Webhooki wysłane przed tą datą mogą pokazywać pricing_model CBP, czyli wycenę za rozmowę; późniejsze pokazują PMP. Kod, który nadal grupuje opłaty według id rozmowy, wymaga aktualizacji.

Czy bezpłatny limit odnawia się co miesiąc?

Tak. Meta przyznaje każdemu numerowi firmowemu 1,000 dostarczonych wiadomości serwisowych miesięcznie, bez przenoszenia niewykorzystanych, z resetem o północy w strefie czasowej konta WhatsApp Business Account.

Czytaj dalej

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbny

Zweryfikowano w