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

Отправка маркетинговых сообщений | Документация для разработчиков

Отправляйте маркетинговые сообщения

Обновлено: 20 марта 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
API маркетинговых сообщений для WhatsApp позволяет отправлять только шаблонные маркетинговые сообщения. Для отправки или получения сообщений других типов используйте Cloud API параллельно с API маркетинговых сообщений для WhatsApp на том же рабочем номере телефона.
Если вы используете пользовательский интерфейс или API партнера для настройки и отправки маркетинговых сообщений, вы можете продолжать это делать и вам не нужно использовать какие-либо возможности, описанные в этом документе — ваш партнер позаботится об интеграции с MM API для функций отправки сообщений WhatsApp от вашего имени.

Создавайте маркетинговые шаблоны

Шаблоны маркетинговых материалов можно создавать несколькими способами:
    Через пользовательский интерфейс WhatsApp Business ManagerЧерез конечную точку «Шаблоны сообщений» API управления бизнесомЕсли вы работаете с партнером, он может предложить собственный API или пользовательские интерфейсы для создания шаблонов, использующие конечную точку «Шаблоны сообщений»
    См. документацию по созданию и управлению шаблонами .
    При создании нового маркетингового шаблона синхронизация с соответствующим рекламным аккаунтом занимает до 10 минут. Эта синхронизация позволяет оптимизировать сообщения и измерять клики и последующие конверсии. Шаблоны, неактивные более 7 дней, также требуют 10 минут для синхронизации после первого использования. Подождите 10 минут после создания новых маркетинговых шаблонов, прежде чем отправлять маркетинговый трафик. То же самое относится и к отправке первого маркетингового сообщения по неактивному шаблону.
    API маркетинговых сообщений для WhatsApp поддерживает все маркетинговые шаблоны. Кроме того, API маркетинговых сообщений для WhatsApp предоставляет следующие функции, недоступные для маркетинговых шаблонов в облачном API:
      Время жизни (TTL) для шаблонных сообщений маркетинга: Если Meta не может доставить сообщение пользователю WhatsApp, Meta будет повторять попытку доставки в течение периода времени, известного как время жизни (TTL) или срок действия сообщения. TTL доступен для шаблонных сообщений аутентификации и служебных сообщений в Cloud API, но TTL для шаблонных сообщений маркетинга доступен исключительно в MM API для WhatsApp. Подробную информацию о настройке TTL для шаблонных сообщений маркетинга см. созданию и управлению шаблонами через API или по установке пользовательского срока действия сообщения через пользовательский интерфейс .

      Автоматический креативные оптимизации

      Автоматическая оптимизация креативов тестирует различные варианты оформления и оптимизирует маркетинговые сообщения на основе методов, замеченных в высокоэффективных креативах. Ее можно отключить с помощью.. Отказ на уровне шаблона или Отказ от участия на уровне бизнес-аккаунта WhatsApp, предоставляя предприятиям гибкость и контроль над тем, как применяются креативные улучшения. Они похожи на Преимущество+ креатив⁠ для рекламы.
      Автоматическая оптимизация креативов, такая как извлечение и выделение текста, привела к увеличению показателя кликабельности (CTR) в среднем на 13,9%*.
      Эта функция обеспечивает вариативность креативов для оптимизации производительности, то есть результат может различаться в разных сообщениях даже при одинаковых исходных данных. Эта возможность тестирует незначительные вариации существующего заголовка изображения и автоматически выбирает вариант, получающий наивысший коэффициент кликабельности с течением времени, без необходимости вашего участия. Мы постоянно изучаем и тестируем новые автоматические методы оптимизации креативов, чтобы помочь максимизировать эффективность вашей кампании. По мере появления новых вариантов, их можно применять к шаблонам, на которые подписаны подписчики, для достижения лучших бизнес-результатов.

      Фильтрация изображений

      Для некоторых кампаний Meta автоматически применяет наиболее эффективные фильтры к изображениям в заголовке, чтобы улучшить качество и привлекательность изображений:
      Пример автоматической оптимизации фильтрации изображений

      Извлечение заголовка

      В некоторых кампаниях Meta извлекает ключевые слова или фразы из вашего сообщения, чтобы создать заголовок для основного текста и выделить ключевую информацию.
      Пример извлечения заголовка из содержимого сообщения

      Извлечение заголовка с помощью касания

      В некоторых кампаниях Meta извлекает ключевые слова или фразы из вашего сообщения, чтобы создать заголовок для целевой области, выделяющей ключевую информацию.
      Пример извлечения заголовка с помощью функции tap-target

      Форматирование текста

      Для некоторых кампаний Meta обновляет форматирование текста (например, удаляет лишние пробелы, выделяет фразы жирным шрифтом) для повышения эффективности. Текстовое содержимое не изменяется — изменяется только форматирование.
      Пример оптимизации форматирования текста

      Вскоре

      Мы постоянно изучаем и тестируем новые методы автоматической оптимизации креативов, чтобы максимально повысить эффективность ваших кампаний. Хотя мы ожидаем, что эти улучшения станут доступны в будущем, наши планы могут измениться.
      Расширения продукта
      Meta улучшает креативы, состоящие из одного изображения, добавляя набор дополнительных товаров из каталога, которые, вероятно, привлекут внимание пользователей или приведут к конверсии, создавая более персонализированный и релевантный опыт.
      Пример расширения ассортимента с использованием товаров из каталога
      Автоматический промо-тег
      Для некоторых кампаний Meta автоматически извлекает из сообщений рекламные теги, например, «скидка 30%», «скидка 50%», «бесплатная доставка», чтобы создать рекламный тег и добавить его на изображение для выделения информации о рекламной акции.
      Пример тега автоматического продвижения
      Изображение баннера
      В некоторых рекламных кампаниях Meta использует цветные отступы, чтобы преобразовать изображение в оптимальное соотношение сторон, повысить визуальную привлекательность и улучшить восприятие медиаконтента.
      Пример баннера с изображением
      В некоторых кампаниях Meta преобразует любые URL-ссылки в теле сообщения, либо сокращая их, либо применяя форматирование Markdown (гиперссылки) к соседним ключевым фразам для улучшения удобочитаемости сообщения.
      Пример форматирования ссылок

      Приостановлено или устарело

      Мы приостановили следующие автоматические оптимизации креативов, и не следует ожидать их применения к вашим маркетинговым сообщениям. Мы обновим документацию, если возобновим какие-либо из этих оптимизаций в будущем:
        кадрирование изображенияMeta автоматически обрезает изображения в заголовке до оптимальных размеров, гарантируя, что ваши визуальные элементы всегда будут идеально обрамлены без обрезки текста.Текстовые наложенияMeta автоматически добавляет текстовое наложение на изображение, используя содержимое вашего сообщения.Анимация изображенияMeta автоматически преобразует изображение в шапке сайта в анимированный GIF-файл.генерация фонового изображенияMeta автоматически генерирует новое фоновое изображение.
        Сноски
        *Данное заключение основано на A/B-тестировании, проведенном с использованием более 50 миллионов маркетинговых сообщений, отправленных примерно 200 рекламодателями через MM API для WhatsApp в период с 1 декабря 2025 года по 7 января 2026 года. В ходе тестирования сравнивался CTR для сообщений с автоматической оптимизацией креативов (ACO) и сообщений без применения ACO, и результаты анализа оказались статистически значимыми при 95% доверительной вероятности.

        Настройте автоматическую оптимизацию креативов (на уровне шаблона)

        Все функции оптимизации включены по умолчанию, но вы можете использовать.. creative_features_spec Объект, позволяющий указать, какие оптимизации вы хотите включить («включить») или отключить («отключить») для данного шаблона. Для этого установите значение для каждой оптимизации enroll_status имущество к любому OPT_IN или УКЛОНЯТЬСЯ при создании шаблона или при редактировании существующего шаблона.

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

        Используйте ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates Конечная точка для настройки автоматической оптимизации креативов на уровне шаблона.
        ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates { "name": "<TEMPLATE_NAME> ", "язык": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE> ", "компоненты": [<TEMPLATE_COMPONENTS> ], "degrees_of_freedom_spec": { "creative_features_spec": { "image_brightness_and_contrast": { "enroll_status": "OPT_OUT" }, "image_touchups": { "enroll_status": "OPT_IN" }, "add_text_overlay": { "enroll_status": "OPT_OUT" }, "image_animation": { "enroll_status": "OPT_IN" }, "image_background_gen": { "enroll_status": "OPT_IN" }, "auto_promotion_tag": { "enroll_status": "OPT_IN" }, "text_extraction_for_headline": { "enroll_status": "OPT_IN" }, "text_extraction_for_tap_target": { "enroll_status": "OPT_IN" }, "product_extensions": { "enroll_status": "OPT_OUT" }, "text_formatting_optimization": { "enroll_status": "OPT_OUT" } } } }
        Используйте ПОЛУЧАТЬ /<TEMPLATE_ID> Конечная точка для получения статуса автоматической оптимизации креативов на уровне шаблона.
        Синтаксис запроса
        ПОЛУЧАТЬ /<TEMPLATE_ID> ?fields=degrees_of_freedom_spec
        Пример ответа
        { "degrees_of_freedom_spec": { "creative_features_spec": [ { "key": "IMAGE_BRIGHTNESS_AND_CONTRAST", "value": { "enroll_status": "OPT_OUT" } }, { "key": "IMAGE_TOUCHUPS", "value": { "enroll_status": "OPT_OUT" } }, { "key": "ADD_TEXT_OVERLAY", "value": { "enroll_status": "OPT_IN" } }, { "key": "IMAGE_ANIMATION", "value": { "enroll_status": "OPT_OUT" } }, { "key": "IMAGE_BACKGROUND_GEN", "value": { "enroll_status": "OPT_OUT" } }, { "key": "AUTO_PROMOTION_TAG", "value": { "enroll_status": "OPT_OUT" } }, { "key": "TEXT_EXTRACTION_FOR_HEADLINE", "value": { "enroll_status": "OPT_OUT" } }, { "key": "TEXT_EXTRACTION_FOR_TAP_TARGET", "value": { "enroll_status": "OPT_OUT" } }, { "key": "PRODUCT_EXTENSIONS", "value": { "enroll_status": "OPT_IN" } }, { "key": "TEXT_FORMATTING_OPTIMIZATION", "value": { "enroll_status": "OPT_IN" } } ] }, "id": "123456789" }
        Настройка автоматической оптимизации креативов (на уровне бизнес-аккаунта WhatsApp)
        Все функции оптимизации включены по умолчанию, но вы можете использовать.. creative_features_spec Этот объект позволяет указать, какие оптимизации вы хотите включить («включить») или отключить («отключить») для всего бизнес-аккаунта WhatsApp. Для этого установите параметры для каждой оптимизации отдельно enroll_status свойство, которое вы хотите изменить на одно из двух OPT_IN или УКЛОНЯТЬСЯ.
        Синтаксис запроса
        Используйте ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> Конечная точка для настройки автоматической оптимизации креативов на уровне бизнес-аккаунта WhatsApp.
        ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> { "degrees_of_freedom_spec": { "creative_features_spec": { "image_touchups": { "enroll_status": "OPT_IN" }, "image_animation": { "enroll_status": "OPT_IN" }, "image_brightness_and_contrast": { "enroll_status": "OPT_IN" }, "add_text_overlay": { "enroll_status": "OPT_IN" }, "image_background_gen": { "enroll_status": "OPT_IN" }, "auto_promotion_tag": { "enroll_status": "OPT_IN" }, "text_extraction_for_headline": { "enroll_status": "OPT_IN" }, "product_extensions": { "enroll_status": "OPT_IN" }, "text_extraction_for_tap_target": { "enroll_status": "OPT_IN" }, "text_formatting_optimization": { "enroll_status": "OPT_OUT" } } } }
        Синтаксис запроса
        Используйте ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> Конечная точка для получения информации о статусе автоматической оптимизации креативов на уровне бизнес-аккаунта WhatsApp.
        ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=degrees_of_freedom_spec
        Пример ответа
        { "degrees_of_freedom_spec": { "data": [ { "creative_features_spec": [ { "image_brightness_and_contrast": "OPT_IN", "image_touchups": "OPT_IN", "add_text_overlay": "OPT_IN", "image_animation": "OPT_IN", "image_background_gen": "OPT_IN", "auto_promotion_tag": "OPT_IN", "text_extraction_for_headline": "OPT_IN", "product_extensions": "OPT_IN", "text_extraction_for_tap_target": "OPT_IN", "text_formatting_optimization": "OPT_IN" } ] } ] }, "id": "1234567890" }
        Другие оптимизации
        

        

        

        

        Усечение текста
        

        Мета-функция обрезает текст до определенного количества строк для повышения производительности. Содержимое текста при этом не изменяется, исходный текст по-прежнему доступен через кнопку «Читать далее». Точные правила обрезки по количеству строк следующие:
        

          Сообщения без призыва к действию (CTA), но со ссылкой в ​​теле сообщения (отменяют приведенные ниже правила): усекаются до 5 строк.Сообщения с медиа-заголовком ( Изображение , Видео , Документ , Местоположение и GIF ): усекаются до 3 строк.Сообщения без заголовка (то есть текстовые сообщения ): усекаются до 4 строк.

          

          

          

          Отправляйте шаблонные маркетинговые сообщения
          

          Отправка сообщений осуществляется с использованием того же синтаксиса полезной нагрузки API, что и отправка сообщений через Cloud API, и требует тех же разрешений.
          

          Конечная  /marketing_messages поддерживает только шаблонные маркетинговые сообщения для MM API для WhatsApp и Cloud API. Все остальные типы сообщений (свободного формата, аутентификация, сервис, утилита) не поддерживаются и приведут к ошибке.
          

          Маркетинговые сообщения будут отправляться через MM API для WhatsApp только после того, как бизнес-клиент выполнит все требования по регистрации . Если требования по регистрации не выполнены, маркетинговые сообщения все равно будут направляться через Cloud API. Вы можете отключить возможность направления сообщений через Cloud API, установив для необязательного поля product_policy значение STRICT .
          

          Примечание: Вы по-прежнему можете использовать  /messages для отправки маркетинговых сообщений через Cloud API.
          

          
Конечная точка
          

          
Аутентификация
          

          /НОМЕР_ТЕЛЕФОНА_ID/маркетинговые_сообщения
          Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в Панель управления приложения > WhatsApp > Настройка API.
          Если вы являетесь поставщиком услуг корпоративного обмена сообщениями, вам необходимо пройти аутентификацию с помощью токена доступа whatsapp_business_messaging разрешение.
          Синтаксис запроса
          

          

          ПОЧТА
          
/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /marketing_messages { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "тип": "<MESSAGE_TYPE> ", "<MESSAGE_TYPE> ": {<MESSAGE_CONTENTS> },<!-- Optional --> "product_policy": "<PRODUCT_POLICY> ", "message_activity_sharing":<SHARE_MESSAGING_ACTIVITY?> }
          MM API для WhatsApp предоставляет следующие дополнительные функции, недоступные для сообщений маркетинговых шаблонов в Cloud API:
          

            

            Политика резервного копирования продукта: установите параметр product_policy в значение CLOUD_API_FALLBACK , чтобы API отправлял исходящие сообщения через Cloud API, если требования по подключению не были выполнены. Установите значение STRICT, если вы не хотите, чтобы API использовал резервный способ отправки сообщений через Cloud API.
            

            Совместное использование активности сообщений:  message_activity_sharing — это необязательный параметр на уровне сообщения, который включает или отключает совместное использование активности сообщений (например, прочтения сообщения) для данного маркетингового сообщения в Meta для оптимизации маркетинговых сообщений. Если этот параметр не указан, будет применена настройка по умолчанию на уровне WABA. Вы всегда можете изменить свою настройку по умолчанию в разделе «Настройки бизнеса» (см. журнал изменений для скриншота).
            

             в документации по типам сообщений Cloud API , поскольку MM API для WhatsApp использует тот же формат отправки сообщений.
            

            

            

            

            Получение веб-хуков статуса сообщений
            

            API MM для WhatsApp запускает  для сообщений  (отправлено, доставлено, прочитано). Кроме того, вебхуки для сообщений статуса, описывающие сообщение, отправленное через API MM для WhatsApp, и содержащие информацию о ценах, будут иметь параметры pricing.category и conversation.type, установленные в значение marketing_lite . Если сообщение маршрутизируется через Cloud API, параметр pricing.category будет установлен в значение marketing .
            

            {
            
"разговор": { "id": "<CONVERSATION_ID> ", "origin": { "type": "marketing_lite" } }, "pricing": { "billable": true, "pricing_model": "PMP", "category": "marketing_lite" } }

            Ведите журналы идентификаторов каждого исходящего сообщения, а также указывайте, было ли это сообщение отправлено через Cloud API или MM API для WhatsApp, чтобы использовать уникальный идентификатор сообщения, возвращаемый в веб-хуках статуса сообщения, для определения источника отправленного сообщения.
            

            

            

            

            Получение входящих сообщений
            

            MM API для WhatsApp — это API только для отправки сообщений. Он не принимает входящие сообщения от пользователей. Чтобы принимать входящие сообщения на рабочий номер телефона, используйте Cloud API параллельно с MM API для WhatsApp на том же номере телефона.
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

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