Отправка маркетинговых сообщений | Документация для разработчиков
Отправляйте маркетинговые сообщения
Обновлено: 20 марта 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
API маркетинговых сообщений для WhatsApp позволяет отправлять только шаблонные маркетинговые сообщения. Для отправки или получения сообщений других типов используйте Cloud API параллельно с API маркетинговых сообщений для WhatsApp на том же рабочем номере телефона.
Если вы используете пользовательский интерфейс или API партнера для настройки и отправки маркетинговых сообщений, вы можете продолжать это делать и вам не нужно использовать какие-либо возможности, описанные в этом документе — ваш партнер позаботится об интеграции с MM API для функций отправки сообщений WhatsApp от вашего имени.
Создавайте маркетинговые шаблоны
Шаблоны маркетинговых материалов можно создавать несколькими способами:
См. документацию по созданию и управлению шаблонами .
При создании нового маркетингового шаблона синхронизация с соответствующим рекламным аккаунтом занимает до 10 минут. Эта синхронизация позволяет оптимизировать сообщения и измерять клики и последующие конверсии. Шаблоны, неактивные более 7 дней, также требуют 10 минут для синхронизации после первого использования. Подождите 10 минут после создания новых маркетинговых шаблонов, прежде чем отправлять маркетинговый трафик. То же самое относится и к отправке первого маркетингового сообщения по неактивному шаблону.
API маркетинговых сообщений для WhatsApp поддерживает все маркетинговые шаблоны. Кроме того, API маркетинговых сообщений для WhatsApp предоставляет следующие функции, недоступные для маркетинговых шаблонов в облачном API:
Автоматическая оптимизация креативов
Автоматическая оптимизация креативов тестирует различные варианты оформления и оптимизирует маркетинговые сообщения на основе методов, замеченных в высокоэффективных креативах. Ее можно отключить с помощью опции отказа на уровне шаблона или на уровне бизнес-аккаунта WhatsApp , что обеспечивает компаниям гибкость и контроль над применением улучшений креативов. Это похоже на креативы Advantage+ для рекламы.
Автоматическая оптимизация креативов, такая как извлечение и выделение текста, привела к увеличению показателя кликабельности (CTR) в среднем на 13,9%*.
Эта функция обеспечивает вариативность креативов для оптимизации производительности, то есть результат может различаться в разных сообщениях даже при одинаковых исходных данных. Эта возможность тестирует незначительные вариации существующего заголовка изображения и автоматически выбирает вариант, получающий наивысший коэффициент кликабельности с течением времени, без необходимости вашего участия. Мы постоянно изучаем и тестируем новые автоматические методы оптимизации креативов, чтобы помочь максимизировать эффективность вашей кампании. По мере появления новых вариантов, их можно применять к шаблонам, на которые подписаны подписчики, для достижения лучших бизнес-результатов.
Фильтрация изображений
Для некоторых кампаний Meta автоматически применяет наиболее эффективные фильтры к изображениям в заголовке, чтобы улучшить качество и привлекательность изображений:
Извлечение заголовка
В некоторых кампаниях Meta извлекает ключевые слова или фразы из вашего сообщения, чтобы создать заголовок для основного текста и выделить ключевую информацию.
Извлечение заголовка с помощью касания
В некоторых кампаниях Meta извлекает ключевые слова или фразы из вашего сообщения, чтобы создать заголовок для целевой области, выделяющей ключевую информацию.
Форматирование текста
Для некоторых кампаний Meta обновляет форматирование текста (например, удаляет лишние пробелы, выделяет фразы жирным шрифтом) для повышения эффективности. Текстовое содержимое не изменяется — изменяется только форматирование.
Вскоре
Мы постоянно изучаем и тестируем новые методы автоматической оптимизации креативов, чтобы максимально повысить эффективность ваших кампаний. Хотя мы ожидаем, что эти улучшения станут доступны в будущем, наши планы могут измениться.
Расширения продукта
Meta улучшает креативы, состоящие из одного изображения, добавляя набор дополнительных товаров из каталога, которые, вероятно, привлекут внимание пользователей или приведут к конверсии, создавая более персонализированный и релевантный опыт.
Автоматический промо-тег
Для некоторых кампаний Meta автоматически извлекает из сообщений рекламные теги, например, «скидка 30%», «скидка 50%», «бесплатная доставка», чтобы создать рекламный тег и добавить его на изображение для выделения информации о рекламной акции.
В некоторых рекламных кампаниях Meta использует цветные отступы, чтобы преобразовать изображение в оптимальное соотношение сторон, повысить визуальную привлекательность и улучшить восприятие медиаконтента.
Форматирование ссылок (гиперссылки)
В некоторых кампаниях Meta преобразует любые URL-ссылки в теле сообщения, либо сокращая их, либо применяя форматирование Markdown (гиперссылки) к соседним ключевым фразам для улучшения удобочитаемости сообщения.
Приостановлено или устарело
Мы приостановили следующие автоматические оптимизации креативов, и не следует ожидать их применения к вашим маркетинговым сообщениям. Мы обновим документацию, если возобновим какие-либо из этих оптимизаций в будущем:
Сноски
*Данное заключение основано на A/B-тестировании, проведенном с использованием более 50 миллионов маркетинговых сообщений, отправленных примерно 200 рекламодателями через MM API для WhatsApp в период с 1 декабря 2025 года по 7 января 2026 года. В ходе тестирования сравнивался CTR для сообщений с автоматической оптимизацией креативов (ACO) и сообщений без применения ACO, и результаты анализа оказались статистически значимыми при 95% доверительной вероятности.
Настройте автоматическую оптимизацию креативов (на уровне шаблона)
Все функции оптимизации включены по умолчанию, но вы можете использовать
creative_features_spec, чтобы указать, какие оптимизации вы хотите включить («opt-in») или отключить («opt-out») для данного шаблона. Для этого установите enroll_status в значение OPT_IN или OPT_OUT при создании шаблона или при редактировании существующего шаблона.Синтаксис запроса
Используйте POST /
ПОЧТА /<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" } } } }Используйте GET /
Синтаксис запроса
ПОЛУЧАТЬ /<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, чтобы указать, какие оптимизации вы хотите включить («opt-in») или отключить («opt-out») для всего аккаунта WhatsApp Business. Для этого установите enroll_status , которую вы хотите изменить, в значение OPT_IN или OPT_OUT .Синтаксис запроса
Используйте POST /
ПОЧТА /<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" } } } }Синтаксис запроса
Используйте GET /
ПОЛУЧАТЬ /<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" }Другие оптимизации
Усечение текста
Мета-функция обрезает текст до определенного количества строк для повышения производительности. Содержимое текста при этом не изменяется, исходный текст по-прежнему доступен через кнопку «Читать далее». Точные правила обрезки по количеству строк следующие:
Отправляйте шаблонные маркетинговые сообщения
Отправка сообщений осуществляется с использованием того же синтаксиса полезной нагрузки 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 на том же номере телефона.