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

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

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

Шаблоны маркетинговых материалов можно создавать несколькими способами:

См. документацию по созданию и управлению шаблонами .

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

API маркетинговых сообщений для WhatsApp поддерживает все маркетинговые шаблоны. Кроме того, API маркетинговых сообщений для WhatsApp предоставляет следующие функции, недоступные для маркетинговых шаблонов в облачном API:

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

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

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

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

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

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 .

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

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