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

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

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

Обновлено: 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 вот что Мета'Мета'Система доставки оптимизирует доставку. Установка правильной максимальной цены при создании шаблона дает системе наилучший сигнал для оптимизации доставки.
          Он per_message_bid_multiplier масштабирует шаблон'шаблон'с bid_amount Изменяется ли значение для отдельных сообщений, но система доставки, как правило, обеспечивает лучшую оптимизацию производительности на уровне исходного шаблона bid_amount в больших количествах.
          Например, если вы установите шаблон'шаблон'с bid_amount Установите значение 50 000, а затем примените множитель 2,0 к каждому сообщению; производительность доставки может отличаться от заданного значения шаблон'шаблон'с bid_amount до 100 000 напрямую — даже несмотря на то, что эффективная максимальная цена одинакова. Поэтому мы рекомендуем настраивать ставку на уровне шаблона и обновлять ее шаблон'шаблон'с bid_spec при необходимости, вместо того чтобы в качестве обходного пути изменять множитель уровня сообщения.
          Наращивайте трафик постепенно. При первой отправке сообщений с использованием нового шаблона с максимальной ценой, увеличивайте объем постепенно, прежде чем отправлять сообщения в больших масштабах. Это соответствует регулирования темпов рассылки с помощью шаблонов и помогает системе доставки эффективно оптимизировать свою работу.

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

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

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

          

          локон
          
'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> ' \ -H 'Content-Type: application/json' \ -d ' { "name": "seasonal_sale_promo", "category": "MARKETING", "language": "en", "components": [ { "type": "BODY", "text": "Покупайте на нашей сезонной распродаже! Скидки до 50% на отдельные товары." } ], "bid_spec": { "bid_amount": "<BID_AMOUNT> ", "bid_strategy": "LOWEST_COST_WITH_BID_CAP" } }'
          Если параметр bid_spec не указан, в шаблоне используются стандартные цены из прайс-листа.
          

          

          

          

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

          

          



Заполнитель 

Описание 

Пример значения 



          

          <ACCESS_TOKEN>
          

          Нить
          


          

          Необходимый.
          

          


          

          EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
          



          

          <API_VERSION>
          

          Нить
          


          

          Необязательный.
          

          Версия Graph API.
          


          

          v25.0
          



          

          Нить
          


          

          Необходимый.
          

          Идентификатор бизнес-аккаунта WhatsApp.
          


          

          102290129340398
          



          

          <BID_AMOUNT>
          

          инт
          


          

          Необходимый.
          

          Максимальная цена за 1000 доставок сообщений, выраженная в вашем коде WABA валюта'валюта'наименьшая единица измерения (центы для долларов США, пайсы для индийских рупий, песо для мексиканских песо). См поддерживаемые валюты Список валют доступен по ссылке.
          


          

          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 .
                

                

                

                Забрать
информация о максимальной цене
                Используйте ПОЛУЧАТЬ /<TEMPLATE_ID> /?fields=bid_spec Конечная точка для получения значения параметра максимальной цены для существующего шаблона.
                Синтаксис запроса
                curl 'https://graph.facebook.com/<API_VERSION> /<TEMPLATE_ID> /?fields=bid_spec' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> '
                Параметры запроса
                
Заполнитель

Описание

Пример значения

                <ACCESS_TOKEN>
                Нить
                EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
                <API_VERSION>
                Нить
                Необязательный.
                Версия Graph API.
                v25.0
                <TEMPLATE_ID>
                Нить
                Необходимый.
                Идентификатор шаблона сообщения WhatsApp.
                1733678867511493
                Пример ответа
                { "bid_spec": { "bid_strategy": "LOWEST_COST_WITH_BID_CAP", "bid_amount": 87000 }, "id": "1733678867511493" }
                Обновите максимальную цену для шаблонов
                Используйте ПОЧТА /<TEMPLATE_ID> / Конечная точка для обновления параметра максимальной цены в существующем шаблоне.
                Вы можете обновить bid_spec Для шаблонов, изначально созданных с указанием максимальной цены, действуют те же параметры.
                Сложение невозможно bid_spec к существующему шаблону, созданному без него. Вам необходимо создать новый шаблон с этим параметром bid_spec включено.
                Остальные ограничения соответствуют стандарту ограничения на редактирование шаблонов:
                  Утвержденные шаблоныДо 100 правок в час, 2400 в деньОтклоненные или приостановленные шаблоны: Неограниченное количество правок
                  Синтаксис запроса
                  curl 'https://graph.facebook.com/<API_VERSION> /<TEMPLATE_ID> /' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> ' \ -H 'Content-Type: application/json' \ -d '{ "bid_spec": { "bid_strategy": "LOWEST_COST_WITH_BID_CAP", "bid_amount":<BID_AMOUNT> } }'
                  Параметры запроса
                  
Заполнитель

Описание

Пример значения

                  <ACCESS_TOKEN>
                  Нить
                  EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
                  <API_VERSION>
                  Нить
                  Необязательный.
                  Версия Graph API.
                  v25.0
                  <TEMPLATE_ID>
                  Нить
                  Необходимый.
                  Идентификатор шаблона сообщения WhatsApp. Шаблон должен быть изначально создан с помощью bid_spec.
                  1733678867511493
                  <BID_AMOUNT>
                  int32
                  Необходимый.
                  Обновлена ​​максимальная цена за 1000 доставок сообщений, выраженная в наименьшей единице вашей валюты WABA.
                  4000
                  Настройте максимальную цену при отправке сообщений
                  Множитель максимальной цены на уровне сообщения может изменяться в течение бета-периода.
                  Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /маркетинговые_сообщения Конечная точка для применения множителя во время отправки, позволяющего корректировать максимальную цену на уровне шаблона для отдельных сообщений. Это позволяет устанавливать максимальную цену выше или ниже без редактирования шаблона.
                  Синтаксис запроса
                  curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /marketing_messages' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> ' \ -H 'Content-Type: application/json' \ -d '{ "recipient_type": "individual", "messaging_product": "whatsapp", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "template", "template": { "name": "seasonal_sale_promo", "language": { "code": "en" } }, "bid_spec": { "per_message_bid_multiplier": "<PER_MESSAGE_BID_MULTIPLIER> " } }'
                  В этом примере множитель 1,5 увеличивает размер шаблона bid_amount на 50%. Если шаблон bid_amount Если значение равно 2000, то эффективная максимальная цена для этого сообщения составит 3000.
                  Параметры запроса
                  
Заполнитель

Описание

Пример значения

                  <ACCESS_TOKEN>
                  Нить
                  EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
                  <API_VERSION>
                  Нить
                  Необязательный.
                  Версия Graph API.
                  v25.0
                  <WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
                  Нить
                  Необходимый.
                  Идентификатор бизнес-телефона WhatsApp.
                  106540352242922
                  <WHATSAPP_USER_PHONE_NUMBER>
                  Нить
                  Необходимый.
                  Номер телефона пользователя WhatsApp.
                  +16505551234
                  <PER_MESSAGE_BID_MULTIPLIER>
                  Плавать
                  Необязательный. По умолчанию: 1
                  Положительный множитель, применяемый к шаблону bid_amount. Например, 1.5 увеличивает максимальную цену на 50% 0.5 уменьшает его на 50%, и 1 (по умолчанию) используется значение максимальной цены шаблона без изменений.
                  1.5
                  Оцените охват и затраты
                  Оценка охвата помогает понять ожидаемый объем поставок и затраты при различных уровнях максимальной цены.
                  Синтаксис запроса
                  Используйте ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> /reachestimate Конечная точка для получения расчетных диапазонов доставки и диапазонов стоимости при различных значениях максимальной цены.
                  Оценки составлены на основе исторических данных и предназначены исключительно для информационных и плановых целей. Они не гарантируют будущих результатов реализации, затрат или показателей эффективности. Фактические результаты могут отличаться из-за изменений условий платформы или других факторов.
                  Он targeting_spec Значение должно быть сериализовано в формате JSON. Например:
                  curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /reachestimate?targeting_spec={"geo_locations":{"countries":["IN"]}}&date_interval=<DATE_INTERVAL> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> '
                  Параметры запроса
                  
Заполнитель

Описание

Пример значения

                  <ACCESS_TOKEN>
                  Нить
                  EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
                  <API_VERSION>
                  Нить
                  Необязательный.
                  Версия Graph API.
                  v25.0
                  <WABA_ID>Нить
                  Необходимый.
                  Идентификатор бизнес-аккаунта WhatsApp.
                  102290129340398
                  <DATE_INTERVAL>
                  Перечисление
                  Необходимый.
                  Период ретроспективного анализа исторических данных, использованных для составления оценок. Один из следующих вариантов: Л1Д (за последний день), Л7Д (за последние 7 дней), Л14Д (за последние 14 дней), Л28Д (за последние 28 дней).
                  Л7Д
                  <TARGETING_SPEC>
                  JSON
                  Необходимый.
                  Сериализованный JSON, указывающий на географическую целевую аудиторию. Обязательно должен включать: геолокации с страны множество.
                  {"geo_locations":{"countries":["IN"]}}
                  Пример ответа
                  { "waba_currency": "USD", "estimates": [ { "bid_amount": 400, "users": 1000, "lower_bound_deliveries": 500, "upper_bound_deliveries": 570, "cost_lower_bound": 389.74, "cost_upper_bound": 390.74 }, { "bid_amount": 520, "users": 1000, "lower_bound_deliveries": 600, "upper_bound_deliveries": 650, "cost_lower_bound": 400.74, "cost_upper_bound": 510.74 } ] }
                  Ответ содержит несколько оценки Записи с различными максимальными ценами позволяют сравнивать ожидаемые объемы доставки и затраты в разных ценовых категориях.
                  Поля ответа
                  ПолеОписание
                  waba_currency
                  Валюта вашего бизнес-аккаунта WhatsApp.
                  bid_amount
                  Максимальная цена за 1000 доставок сообщений в наименьшей единице валюты WABA.
                  пользователи
                  Целевое количество пользователей. В бета-версии оно было зафиксировано на уровне 1000.
                  lower_bound_deliveries
                  Нижняя граница расчетного диапазона сроков доставки для данной максимальной цены.
                  верхняя_граничная_доставка
                  Верхняя граница расчетного диапазона сроков доставки для данной максимальной цены.
                  cost_lower_bound
                  Нижняя граница расчетной средней стоимости 1000 доставок в наименьшей единице валюты WABA.
                  cost_upper_bound
                  Верхняя граница расчетной средней стоимости 1000 доставок в наименьшей единице валюты WABA.
                  Показатели и выставление счетов
                  

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

                    

                    

                    

                    Пример ответа аналитики ценообразования
                    

                    

                    {
                    
"pricing_analytics":
                    
{
                    
"данные":
                    
[ { "data_points": [ { "start": 1748761200, "end": 1748847600, "country": "IN", "pricing_type": "REGULAR", "pricing_category": "MARKETING_LITE", "volume": 1, "cost": 10 } ] } ] } }
                    Пример ответа аналитики шаблона
                    

                    

                    {
                    
"данные": [ { "гранулярность": "ежедневно", "тип продукта": "маркетинговые сообщения LITE API", "точки данных": [ { "идентификатор шаблона": "1421988012088524", "начало": 1718064000, "конец": 1718150400, "отправлено": 1, "доставлено": 1, "прочитано": 1, "стоимость": [ { "тип": "израсходованная сумма", "значение": 0.01 }, { "тип": "стоимость за доставленный", "значение": 0.01 } ] } ] } ] }
                    Более подробную информацию о метриках см. в разделе «Просмотр метрик» .
                    

                    

                    

                    

                    коды ошибок
                    

                    

                    


Код
Сообщение
Возможные причины и решения



                    

                    131061
                    


                    

                    Шаблоны маркетинговых рассылок, содержащие bid_spec, не поддерживаются Cloud API. Для использования шаблонов с bid_spec, пожалуйста, воспользуйтесь API маркетинговых сообщений для WhatsApp.
                    


                    

                    Вы отправляете шаблон с параметром bid_spec на конечную точку Cloud API /messages . Вместо этого отправьте запрос на  /marketing_messages .
                    



                    

                    100
                    


                    

                    Перед отправкой сообщений необходимо подписать юридическое соглашение о тестировании.
                    


                    

                    Вы не подписали юридическое соглашение о тестировании. Пожалуйста, подпишите соглашение, чтобы получить доступ к этой функции.
                    

                    Полный список кодов ошибок см. в разделе «Коды ошибок» .
                    
    
                            
                    
    
                    

            
                    
        
                    
    
                    

    
                    

    
    
                    
        
                    
             Вернуться наверх