ВойтиНачать бесплатный пробный период
Meta Tech Provider

Объект ценообразования в вебхуках WhatsApp: тип, категория и billable (2026)

Объект ценообразования передаётся в вебхуках статусов и показывает, как Meta классифицировала сообщение: billable (устаревающее поле), pricing_model PMP, type (regular, free_customer_service, free_entry_point или free_group_customer_service), category, например marketing, utility, authentication или service, и необязательный subtype со значением paid_exempt. С 1 октября 2026 года regular отмечает каждое платное сообщение, включая сервисные.

easyCoexistence подключает номер вашего приложения WhatsApp Business к Cloud API Meta через Coexistence и передаёт статусные вебхуки с этим объектом на ваш сервер, чтобы ваша система могла подсчитать использование.

PMP

pricing_model в актуальных вебхуках: тарификация за сообщение; CBP встречается только в вебхуках, отправленных до 1 июля 2025 года.

1,000

Доставленные сервисные сообщения на номер бизнеса в месяц в пределах бесплатного лимита Meta, с 1 октября 2026 года.

regular

type платного сообщения, включая сервисные сообщения, доставленные после исчерпания бесплатного лимита номера.

paid_exempt

subtype у сервисных сообщений, которые бесплатны, потому что организация имеет право на льготу как государственная или некоммерческая.

0

Данные о ступенях объёма в вебхуках; Meta указывает на поле pricing_analytics для информации об объёмных ступенях.

Где появляется объект ценообразования?

Только в статусах и только в некоторых: Meta включает его вместе со статусом sent и одним из статусов delivered или read. В примере Meta для версии v24.0 объекта нет в sent, потому что он пришёл в вебхуке delivered. В статусах failed он никогда не передаётся. Поэтому относитесь к тарификации как к свойству сообщения, привязанному к его wamid, и записывайте её один раз, из какого бы статуса она ни пришла. Примеры объекта от Meta для сервисного сообщения до и после исчерпания ежемесячного бесплатного лимита номера:

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

Что означают значения type с 1 октября 2026 года?

type отвечает на вопрос, взимает ли Meta плату. Его смысл изменился 1 октября 2026 года, когда Meta начала тарифицировать за сообщение сервисные сообщения и утилитарные шаблоны, отправленные в ответ на обращение клиента. Код, написанный до этой даты, может читать free_customer_service как ответ в открытом окне обслуживания клиентов; теперь это значит сервисное сообщение один на один в пределах ежемесячного бесплатного лимита номера. billable по-прежнему присутствует, но Meta сообщает, что его уберут, и просит читать type и category вместе.

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

Какие категории может иметь сообщение?

category называет тариф, который Meta применила при списании. Это поле, по которому нужно группировать при сверке со счётом Meta, вместе со страной номера клиента, так как тарифы различаются по рынкам. Одно сообщение имеет одну категорию и только одно списание: сообщение без шаблона с рекламным содержимым остаётся сервисным сообщением, а не дополнительным списанием за маркетинг. Значения, которые перечисляет 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.

Как считать списания по вебхукам?

Вебхуки сообщают, какие сообщения подлежат оплате и по какой категории, но не их стоимость. Чтобы построить отчёт об использовании, совпадающий со счётом Meta, считайте по сообщениям и категориям, затем применяйте опубликованные Meta тарифы для каждого рынка или читайте поле pricing_analytics, которое даёт разбивку по сообщениям и ступени объёма.

  • Удаляйте дубликаты по wamid: тарификация может прийти в нескольких статусах, а повторные отправки повторяют вебхуки.
  • Считайте сообщение платным, когда type равен regular; группируйте по category и стране получателя.
  • Игнорируйте сообщения со статусом failed: Meta взимает плату только за доставленные.
  • Начиная с v24.0 объекта conversation не будет, кроме окна бесплатной точки входа, где его id уникален для каждого окна.

Что это значит для ответов ИИ на номере Coexistence?

Каждый ответ, который ваш ИИ или автоматизация отправляет через API, является сообщением без шаблона, поэтому его категория service: в пределах ежемесячного бесплатного лимита номера он показывает free_customer_service, а после него regular. Шаблоны, которые ваш ИИ отправляет через send_template, несут собственную категорию. В руководстве Meta по Coexistence есть одно отличие, важное для стоимости: сообщения, которые владелец набирает в приложении WhatsApp Business, не подпадают под окно обслуживания клиентов и не влияют на тарификацию Cloud API.

Meta выставляет счета за сообщения на аккаунт WhatsApp Business самого бизнеса, за каждое сообщение, по категории и стране; easyCoexistence никогда не добавляет к ним наценку, а использование ИИ оплачивает ваш провайдер ИИ по вашему собственному ключу.

Распространённые ошибки

  • Подсчёт объекта ценообразования при каждом появлении. Он может прийти в нескольких статусах одного сообщения; считайте один раз на wamid.
  • Чтение только billable. Meta его убирает и просит использовать type и category вместе.
  • Сохранение прежнего понимания free_customer_service. С 1 октября 2026 года он отмечает сервисное сообщение в пределах ежемесячного бесплатного лимита номера.
  • Ожидание сумм в полезной нагрузке. Объект называет категорию; тарифы берутся из прайс-листов Meta или pricing_analytics.
Настройка с EasyCoexistence

Списания Meta остаются на вашем аккаунте WhatsApp Business и никогда не получают наценку. От US$ 9 до US$ 0,75 за подключённый номер в месяц, с понижением по мере добавления номеров, первые 3 дня бесплатно.

Часто задаваемые вопросы

Какой аккаунт оплачивает сообщение?

Аккаунт WhatsApp Business, который его отправил. Если на одном номере отправляют несколько аккаунтов, Meta относит каждое списание к аккаунту, отправившему сообщение, с его собственным способом оплаты и лимитами расходов.

Что такое marketing_lite?

Категория и тип тарификации для сообщений, отправленных через Marketing Messages API для WhatsApp от Meta, отдельного пути отправки маркетинговых шаблонов с собственными вариантами тарификации, например максимальной ценой за доставку.

Когда тарификация за сообщение заменила диалоги?

1 июля 2025 года. Вебхуки, отправленные до этой даты, могут показывать pricing_model CBP, тарификацию по диалогам; более поздние показывают PMP. Код, который всё ещё группирует списания по id диалога, нужно обновить.

Обнуляется ли бесплатный лимит каждый месяц?

Да. Meta даёт каждому номеру бизнеса 1 000 доставленных сервисных сообщений в месяц без переноса остатка, обнуление происходит в полночь по часовому поясу аккаунта WhatsApp Business.

Читайте дальше

Статусы вебхуков WhatsApp: отправлено, доставлено, прочитано, ошибкаКак WhatsApp сообщает о судьбе отправленного сообщения: массив statuses, значения статусов, поля и сопоставление по wamid.Цены WhatsApp Business с октября 2026: сервисные сообщения сверх 1 000 в месяц оплачиваютсяС 1 октября 2026 Meta взимает плату за сервисные сообщения сверх 1 000 на номер в месяц. Что изменилось, как это тарифицируется и что значит для ИИ-ответов.Окно бесплатной точки входа: объявления Click-to-WhatsApp, до 7 дней сообщений без оплаты MetaОтвет на сообщение клиента из объявления Click-to-WhatsApp в течение 24 часов открывает окно до 7 дней без платы Meta за сообщения. Как это работает.За какие сообщения WhatsApp Meta берёт платуСервисные ответы бесплатны до 1 000 на номер в месяц. За что Meta берёт плату, кому выставляет счёт и почему провайдер не может добавить наценку.Сколько стоит автоматизация WhatsApp с AI? Наша плата, сборы Meta и ваша модельТри счёта: наша плата за номер (от US$ 9 до US$ 0,75), сообщения Meta на вашем аккаунте и токены вашего AI-провайдера по вашему ключу.Почему сообщение WhatsApp не доставлено: чтение статуса failed и его ошибокСтатус failed значит, что Meta не смогла отправить или доставить сообщение. Разберите массив errors и коды 131047, 131049, 131050 и что делать.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на