Перейти к основному содержимому

Установка максимальной цены для маркетинговых сообщений (БЕТА) | Документация для разработчиков

Установите максимальную цену для маркетинговых сообщений (БЕТА-версия)

Обновлено: 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 это выражается в виде bid_amount за 1000 доставок в bid_spec .
      PDF-документ с пояснениями к максимальной цене

      Поэтапное внедрение функции ограничения максимальной цены

      Мы планируем внедрить функцию ограничения максимальной цены в 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 а не изменять множитель на уровне сообщения в качестве обходного пути.
          Наращивайте трафик постепенно. При первой отправке сообщений с использованием нового шаблона с максимальной ценой, увеличивайте объем постепенно, прежде чем отправлять сообщения в больших масштабах. Это соответствует регулирования темпов рассылки с помощью шаблонов и помогает системе доставки эффективно оптимизировать свою работу.

          Создавайте шаблоны с максимальной ценой

          Используйте POST / Конечная точка для установки максимальной цены и включения bid_spec в тело запроса.

          Синтаксис запроса

          
          
          Если параметр bid_spec не указан, в шаблоне используются стандартные цены из прайс-листа.

          Параметры запроса

          Заполнитель Описание Пример значения
          <ACCESS_TOKEN>
          Нить
          EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
          <API_VERSION>
          Нить
          Необязательный.
          Версия Graph API.
          v25.0
          <WABA_ID>Нить
          Необходимый.
          Идентификатор бизнес-аккаунта WhatsApp.
          102290129340398
          <BID_AMOUNT>
          инт
          Необходимый.
          Максимальная цена за 1000 доставленных сообщений, выраженная в наименьшей единице вашей валюты WABA (центы для USD, пайсы для INR, песо для MXN). Список поддерживаемых валют см. в соответствующем разделе.
          87000

          Расчет сумм максимальной цены

          Параметр bid_amount обозначает вашу максимальную цену за 1000 доставок в наименьшей единице вашей валюты WABA. Для конвертации желаемой цены за доставку:
            Переведите желаемую цену за доставку в наименьшую единицу вашей валюты WABAУмножьте на 1000, чтобы выразить стоимость за 1000 доставок
            Пример: Чтобы установить максимальную цену в размере 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 для целей выставления счетов.
                Маркетинговые сообщения, отправленные с указанием максимальной цены, отображаются в аналитике со следующими идентификаторами:
                  Аналитика ценообразования/: 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
                  Перед отправкой сообщений необходимо подписать юридическое соглашение о тестировании.
                  Вы не подписали юридическое соглашение о тестировании. Пожалуйста, подпишите соглашение, чтобы получить доступ к этой функции.
                  Полный список кодов ошибок см. в разделе «Коды ошибок».