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

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

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

Обновлено: 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 / /message_templates для установки максимальной цены и включения bid_spec в тело запроса.

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

          curl '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 (центы для 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 .
                Получить информацию о максимальной цене
                Используйте GET /  /?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" }
                Обновите максимальную цену для шаблонов
                Используйте POST / / конечная точка для обновления параметра максимальной цены в существующем шаблоне.
                Вы можете обновить параметр 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
                  Настройте максимальную цену при отправке сообщений
                  Множитель максимальной цены на уровне сообщения может изменяться в течение бета-периода.
                  Используйте POST /  /marketing_messages позволяет применять множитель при отправке для корректировки максимальной цены на уровне шаблона для отдельных сообщений. Это позволяет устанавливать максимальную цену выше или ниже без редактирования шаблона.
                  Синтаксис запроса
                  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  значение 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
                  Оцените охват и затраты
                  Оценка охвата помогает понять ожидаемый объем поставок и затраты при различных уровнях максимальной цены.
                  Синтаксис запроса
                  Используйте GET /  /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
                  Нить
                  Необходимый.
                  Идентификатор бизнес-аккаунта WhatsApp.
                  102290129340398
                  <DATE_INTERVAL>
                  Перечисление
                  Необходимый.
                  Период ретроспективного анализа исторических данных, использованных для построения оценок. Один из следующих: L1D (последний 1 день), L7D (последние 7 дней), L14D (последние 14 дней), L28D (последние 28 дней).
                  Л7Д
                  <TARGETING_SPEC>
                  JSON
                  Необходимый.
                  Сериализованный JSON, указывающий на географическое местоположение. Должен включать geo_locations с  стран .
                  {"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": [ { "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
                    Перед отправкой сообщений необходимо подписать юридическое соглашение о тестировании.
                    Вы не подписали юридическое соглашение о тестировании. Пожалуйста, подпишите соглашение, чтобы получить доступ к этой функции.
                    Полный список кодов ошибок см. в разделе «Коды ошибок» .
                    
    
                            
                    
    
                    

            
                    
        
                    
    
                    

    
                    

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