Объект ценообразования в вебхуках 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 и передаёт статусные вебхуки с этим объектом на ваш сервер, чтобы ваша система могла подсчитать использование.
pricing_model в актуальных вебхуках: тарификация за сообщение; CBP встречается только в вебхуках, отправленных до 1 июля 2025 года.
Доставленные сервисные сообщения на номер бизнеса в месяц в пределах бесплатного лимита Meta, с 1 октября 2026 года.
type платного сообщения, включая сервисные сообщения, доставленные после исчерпания бесплатного лимита номера.
subtype у сервисных сообщений, которые бесплатны, потому что организация имеет право на льготу как государственная или некоммерческая.
Данные о ступенях объёма в вебхуках; Meta указывает на поле pricing_analytics для информации об объёмных ступенях.
Где появляется объект ценообразования?
Только в статусах и только в некоторых: Meta включает его вместе со статусом sent и одним из статусов delivered или read. В примере Meta для версии v24.0 объекта нет в sent, потому что он пришёл в вебхуке delivered. В статусах failed он никогда не передаётся. Поэтому относитесь к тарификации как к свойству сообщения, привязанному к его wamid, и записывайте её один раз, из какого бы статуса она ни пришла. Примеры объекта от Meta для сервисного сообщения до и после исчерпания ежемесячного бесплатного лимита номера:
// 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 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
Какие категории может иметь сообщение?
category называет тариф, который Meta применила при списании. Это поле, по которому нужно группировать при сверке со счётом Meta, вместе со страной номера клиента, так как тарифы различаются по рынкам. Одно сообщение имеет одну категорию и только одно списание: сообщение без шаблона с рекламным содержимым остаётся сервисным сообщением, а не дополнительным списанием за маркетинг. Значения, которые перечисляет Meta:
Как считать списания по вебхукам?
Вебхуки сообщают, какие сообщения подлежат оплате и по какой категории, но не их стоимость. Чтобы построить отчёт об использовании, совпадающий со счётом 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.
Списания 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 Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на