Встроенные компоненты | Документация для разработчиков

На борту

Обновлено: 10 февраля 2026 г

API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.

Подключение к API маркетинговых сообщений для WhatsApp (MM API для WhatsApp) — это простой способ обновить вашу систему отправки маркетинговых сообщений с оптимизацией на основе облачного API. Следуйте приведенным ниже инструкциям, чтобы подключить свою компанию, независимо от того, интегрируетесь ли вы с API напрямую или работаете с партнером.

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

Эти связанные учетные записи позволяют бизнесу:

Для просмотра данных используйте API маркетинга (MM API) и API аналитики WhatsApp

Эти рекламные аккаунты, доступные только для чтения, синхронизируются со всеми изменениями в маркетинговых шаблонах, так что любые изменения в маркетинговых шаблонах отражаются в связанном рекламном объекте.

Выполните следующие шаги, чтобы подключиться к MM API для WhatsApp.

Требования к участию

Для использования API маркетинговых сообщений для WhatsApp (MM API для WhatsApp) компания должна соблюдать применимые правовые, отраслевые и контентные ограничения (в зависимости от страны), изложенные в Политике использования сообщений WhatsApp для бизнеса .

Кроме того, должны быть выполнены следующие требования:

WABA активна и не ограничена в возможности обмена сообщениями из-за каких-либо нарушенийНалоговая служба WABA не входит в санкционные регионыСтрана, в которой находится бизнес владельца, не входит в санкционные регионы

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

Проверка соответствия критериям (альтернативный вариант)

Это поле будет устарело в версии 24.0. Мы рекомендуем использовать поле marketing_messages_onboarding_status .

~~Вы можете использовать~~ ~~ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID>~~ ~~конечную точку и запросить~~ marketing_messages_lite_api_status Это поле предназначено для получения информации о соответствии требованиям, но в будущем оно будет устарело, поэтому мы рекомендуем использовать другое поле ~~описанный выше метод~~ ~~вместо.~~

ПОЛУЧАТЬ /<Идентификатор бизнес-аккаунта WhatsApp>?fields=marketing_messages_lite_api_status

Для управляемых партнерами WABA компании могут найти подходящие WABA, используя следующую конечную точку:

ПОЛУЧАТЬ /<BUSINESS_ID>/client_whatsapp_business_accounts?fields=marketing_messages_lite_api_status

См ~~ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID>~~ ~~Для получения списка возвращаемых значений и их значений используйте справочный материал.~~

Зарегистрируйте номер телефона в Cloud API

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

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

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

Номера телефонов WhatsApp Business, не зарегистрированные в Cloud API, нельзя использовать с MM API для WhatsApp.

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

Для поставщиков решений

Если вы являетесь поставщиком решений и занимаетесь подключением конечных пользователей к своим сервисам, обратитесь к разделу «Подключение бизнес-клиентов» .

Привлечение корпоративных клиентов

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

Откройте Менеджер WhatsApp > Обзор.В разделе «Уведомления» нажмите «Принять условия», чтобы начать работу с API маркетинговых сообщений для WhatsApp.Выполните следующие шаги, чтобы завершить подписание условий использования MM API для WhatsApp.

Ваши бизнес-клиенты должны иметь возможность начать отправлять сообщения через MM API для WhatsApp.

Если у вас нет доступа к менеджеру WhatsApp, найдите панель администратора вашего бизнес-портфолио здесь .

Для корпоративных клиентов, не имеющих партнера

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

Перейдите в Панель управления приложением > WhatsApp > быстрого запуска .На «Быстрый старт» найдите карточку «Повысьте рентабельность инвестиций с помощью API маркетинговых сообщений для WhatsApp» и нажмите кнопку «Начать».Нажмите «Перейти к руководству по интеграции», чтобы принять Условия предоставления услуг

Получение веб-хука, подписанного в соответствии с условиями использования WhatsApp, через API MM (предпочтительный вариант)

Примечание: значение события ToS станет доступно с 8 сентября 2025 года. См. информацию об устаревшем веб-хуке ниже.

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

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

Получение веб-хука завершения процесса адаптации (устаревшая версия)

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

Примечание: Этот веб-хук считается устаревшим для API MM для регистрации в WhatsApp. Пожалуйста, используйте веб-хук, подписанный в соответствии с условиями использования API MM для WhatsApp.

Важно: ad_account_linked больше не будет срабатывать, поскольку партнеры не получат доступ к рекламным аккаунтам.