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