Установка максимальной цены для маркетинговых сообщений (БЕТА) | Документация для разработчиков
Установите максимальную цену для маркетинговых сообщений (БЕТА-версия)
Обновлено: 17 марта 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
В связи с внедрением функции ограничения максимальной цены в API маркетинговых сообщений для WhatsApp, порядок взимания платы на платформе WhatsApp Business остается неизменным. Мы по-прежнему взимаем плату за каждое сообщение, как описано здесь .
Функция ограничения максимальной цены станет доступна в рамках ограниченного бета-тестирования с середины мая и будет опциональной на протяжении всего 2026 года.
Что такое максимальная цена?
Как было объявлено в марте 2026 года, в 2026 году мы внедряем новые функции ценообразования для API маркетинговых сообщений WhatsApp, которые позволят компаниям повысить рентабельность инвестиций и получить больше контроля над оптимизацией расходов на свои маркетинговые кампании.
Наша первая функция ценообразования позволяет компаниям устанавливать максимальную цену (max-price) за доставку маркетингового сообщения; при установке максимальной цены Meta будет взимать плату за доставку по этой максимальной цене или ниже . Компании могут установить максимальную цену, равную, ниже или выше опубликованной ставки, чтобы достичь своих целей в рамках каждой кампании.
Снижение затрат при сохранении показателей доставки на уровне текущих кампаний в WhatsApp достигается за счет установления максимальных цен, равных опубликованным тарифам.Расширьте целевую аудиторию WhatsApp и снизьте затраты , установив максимальные цены ниже опубликованных тарифов.Повышайте скорость доставки в моменты, когда взаимодействие с клиентами наиболее важно , например, во время праздников и пиковых периодов продаж, устанавливая максимальные цены выше опубликованных тарифов.
Вторая функция ценообразования — это инструмент оценки охвата , который помогает компаниям установить правильную максимальную цену, предоставляя им информацию о предполагаемых темпах и стоимости доставки при различных максимальных ценах.
Объяснение максимальной цены
Функция max-price позволяет установить максимальную цену, которую вы готовы заплатить за доставку сообщения. С вас будет взиматься ваша максимальная цена или ниже. В API это выражается в виде
PDF-документ с пояснениями к максимальной цене
bid_amount за 1000 доставок в bid_spec .Поэтапное внедрение функции ограничения максимальной цены
Мы планируем внедрить функцию ограничения максимальной цены в 3 этапа:
Ограниченное бета-тестирование начнётся в середине мая 2026 года — любой партнёр и любая напрямую интегрированная компания смогут интегрировать и использовать функцию определения максимальной цены и инструмент оценки охвата. Каждый партнёр может активировать эти функции для ограниченного числа клиентов.Открытое бета-тестирование начнётся в октябре 2026 года — любой партнёр сможет включить эти функции для всех своих клиентов.Доступность для общего использования (GA) с 2 квартала 2027 года — функция ограничения максимальной цены станет обязательной в соответствующих регионах, а фиксированные опубликованные тарифы на маркетинговые сообщения будут применяться только через облачный API.
Прежде чем начать
Для использования функции максимальной цены необходимо:
У вас должен быть активный бизнес-аккаунт WhatsApp, подключенный к API маркетинговых сообщений WhatsApp.Находиться в стране, имеющей право на использование MM API для WhatsApp .
Рекомендации
Установите максимальную цену на уровне шаблона. Параметр
bid_amount в bid_spec определяет, относительно чего будет оптимизироваться система доставки Meta. Правильная установка максимальной цены при создании шаблона дает системе наилучший сигнал для оптимизации доставки.Параметр
per_message_bid_multiplier значение bid_amount шаблона bid_amount уровне шаблона при больших объемах сообщений.Например, если вы установите
значение bid_amount равным 50 000, а затем примените множитель 2,0 к каждому сообщению, производительность доставки может отличаться от установки значения bid_amount bid_spec шаблона, а не изменять множитель на уровне сообщения в качестве обходного пути.Наращивайте трафик постепенно. При первой отправке сообщений с использованием нового шаблона с максимальной ценой, увеличивайте объем постепенно, прежде чем отправлять сообщения в больших масштабах. Это соответствует регулирования темпов рассылки с помощью шаблонов и помогает системе доставки эффективно оптимизировать свою работу.
Создавайте шаблоны с максимальной ценой
Синтаксис запроса
Если
параметр bid_spec не указан, в шаблоне используются стандартные цены из прайс-листа.Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить |
Необходимый.
Системный токен или бизнес-токен . |
|
<API_VERSION>Нить |
Необязательный.
Версия Graph API. |
v25.0 |
|
Необходимый.
Идентификатор бизнес-аккаунта WhatsApp. |
102290129340398 |
<BID_AMOUNT>инт |
Необходимый.
Максимальная цена за 1000 доставленных сообщений, выраженная в наименьшей единице вашей валюты WABA (центы для USD, пайсы для INR, песо для MXN). Список поддерживаемых валют см. в соответствующем разделе. |
87000 |
Расчет сумм максимальной цены
Параметр
Переведите желаемую цену за доставку в наименьшую единицу вашей валюты WABAУмножьте на 1000, чтобы выразить стоимость за 1000 доставок
bid_amount обозначает вашу максимальную цену за 1000 доставок в наименьшей единице вашей валюты WABA. Для конвертации желаемой цены за доставку:Пример : Чтобы установить максимальную цену в размере 0,87 ? за доставку:
Перевести в пайсы: 0,87 рупий = 87 пайсовУмножим на 1000: 87 x 1000 = 87 000
Установите
значение bid_amount равным 87000 .Пример : Чтобы установить максимальную цену в 0,05 доллара США за доставку:
Перевести в центы: 0,05 доллара = 5 центовУмножим на 1000: 5 x 1000 = 5000
Установите
значение bid_amount равным 5000 .Показатели и выставление счетов
Сообщения, отправленные с использованием функции ограничения максимальной цены или без нее, используют один и тот же Marketing Lite для целей выставления счетов.
Маркетинговые сообщения, отправленные с указанием максимальной цены, отображаются в аналитике со следующими идентификаторами:
Аналитика ценообразования / ?fields=pricing_analytics : pricing_category = MARKETING_LITEАналитика шаблонов / ?fields=template_analytics : product_type = MARKETING_MESSAGES_LITE_API
Веб-хуки используют
термин marketing_lite для pricing.category , в то время как API аналитики используют термин MARKETING_LITE для pricing_category .Пример ответа аналитики ценообразования
Пример ответа аналитики шаблона
Более подробную информацию о метриках см. в разделе «Просмотр метрик» .
коды ошибок
| Код | Сообщение | Возможные причины и решения |
|---|---|---|
|
131061 |
Шаблоны маркетинговых рассылок, содержащие bid_spec, не поддерживаются Cloud API. Для использования шаблонов с bid_spec, пожалуйста, воспользуйтесь API маркетинговых сообщений для WhatsApp. |
Вы отправляете шаблон с параметром bid_spec на конечную точку Cloud API /messages . Вместо этого отправьте запрос на /marketing_messages . |
|
100 |
Перед отправкой сообщений необходимо подписать юридическое соглашение о тестировании. |
Вы не подписали юридическое соглашение о тестировании. Пожалуйста, подпишите соглашение, чтобы получить доступ к этой функции. |
Полный список кодов ошибок см. в разделе «Коды ошибок» .