Встроенные компоненты | Документация для разработчиков
На борту
Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Подключение к API маркетинговых сообщений для WhatsApp (MM API для WhatsApp) — это простой способ обновить вашу систему отправки маркетинговых сообщений с оптимизацией на основе облачного API. Следуйте приведенным ниже инструкциям, чтобы подключить свою компанию, независимо от того, интегрируетесь ли вы с API напрямую или работаете с партнером.
Когда компания регистрируется в MM API для WhatsApp, создаются рекламные аккаунты только для чтения, которые связываются с каждым из маркетинговых шаблонов, существующих в портфеле ее бизнеса.
Эти связанные учетные записи позволяют бизнесу:
Эти рекламные аккаунты, доступные только для чтения, синхронизируются со всеми изменениями в маркетинговых шаблонах, так что любые изменения в маркетинговых шаблонах отражаются в связанном рекламном объекте.
Выполните следующие шаги, чтобы подключиться к MM API для WhatsApp.
Требования к участию
Для использования API маркетинговых сообщений для WhatsApp (MM API для WhatsApp) компания должна соблюдать применимые правовые, отраслевые и контентные ограничения (в зависимости от страны), изложенные в Политике использования сообщений WhatsApp для бизнеса .
Кроме того, должны быть выполнены следующие требования:
API MM для WhatsApp будет постоянно обновлять вертикальные критерии соответствия и правила, чтобы соответствовать различным международным нормам и правилам, поэтому эти требования могут меняться.
Проверьте статус участия в программе WABA и соответствие требованиям
Используйте GET / Используйте конечную точку и запросите
marketing_messages_onboarding_status , чтобы проверить статус соответствия требованиям WhatsApp для пользователя WABA через API MM.У соответствующих требованиям WABA это поле имеет значение Справочная информация обо всех возможных значениях и их смыслах.
ELIGIBLE . Если это значение установлено на ONBOARDED , это означает, что бизнес-клиент WABA уже подключен. См. GET /Пример запроса
curl 'https://graph.facebook.com/ v25.0 /25002526842541/?fields=marketing_messages_onboarding_status' \ - H 'Авторизация: Bearer EAAAl...'Пример ответа
{
"marketing_messages_onboarding_status"
: "ELIGIBLE" , "id"
: "25002526842541" }
Вы также можете использовать GET / /client_whatsapp_business_accounts со следующей фильтрацией, чтобы получить список всех подходящих учетных записей WABA, которыми с вами поделились.
Синтаксис запроса
GET /
<BUSINESS_PORTFOLIO_ID> / client_whatsapp_business_accounts ? filtering=[
{
'field':'marketing_messages_onboarding_status
', 'operator':'IN',
'value':['ELIGIBLE']
}
]
Пример запроса
curl -g ' https://graph.facebook.com/v25.0/19502398688333/client_whatsapp_business_accounts?filtering=[{'field':'marketing_messages_onboarding_status','operator':'IN','value':['ELIGIBLE ' ] } ] ' \ -H ' Авторизация : Bearer EAAAj ... 'Пример ответа
{
"data"
: [ {
"id"
: "46302397361990" , "name"
: "San Andreas Roofing" , "timezone_id"
: "1" , "message_template_namespace"
: "93d3e793_8a4f_49c4_b903_fd72aac80f71" }
]
}
Проверка соответствия критериям (альтернативный вариант)
Это поле будет устарело в версии 24.0. Мы рекомендуем использовать поле
marketing_messages_onboarding_status .Вы можете использовать GET / Используйте конечную точку и запросите
marketing_messages_lite_api_status для получения статуса соответствия требованиям, однако это поле будет устаревшим в будущем, поэтому мы рекомендуем использовать описанный выше метод .GET / < WHATSAPP_BUSINESS_ACCOUNT_ID > ?fields=marketing_messages_lite_api_status
Для управляемых партнерами WABA компании могут найти подходящие WABA, используя следующую конечную точку:
GET / <BUSINESS_ID> / client_whatsapp_business_accounts ?fields= marketing_messages_lite_api_status
См. GET / Для получения списка возвращаемых значений и их значений используйте справочный материал.
Если вы хотите проверить условия использования и статус запроса намерения для бизнес-менеджера
Используйте GET / / конечная точка и запросите
marketing_messages_onboarding_status , чтобы проверить статус соответствия требованиям WhatsApp через API MM.Разрешение
управление бизнесомПример запроса
curl
"https://graph.facebook.com/v24.0/5200252684252435 1/?fields=marketing_messages_onboarding_status" \ -H
'Авторизация: Bearer EAAAl...'
Пример ответа
{
"marketing_messages_onboarding_status"
: {
"status"
: "TERM_OF_SERVICE_SIGNED" "time"
: "2025-10-07" }
}
Используйте GET / Используйте конечную точку и запросите
owner_business_info , чтобы проверить статус подключения WABA.Разрешения
whatsapp_business_managementwhatsapp_business_messagingПример запроса
curl
GET "https://graph.facebook.com/v24.0/69843579834234?fields=owner_business_info " \ -H
'Авторизация: Bearer EAAAl...'
Пример ответа
{
"owner_business_info"
: { "name"
: "WhatsApp PaidSend Testing" , "id"
: "" , "marketing_messages_onboarding_status"
: { "status"
: "TERM_OF_SERVICE_SIGNED" | "REQUEST_SENT" | "NOT_STARTED" "time"
: "2025-08-13" }
},
}
Зарегистрируйте номер телефона в 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.
Ваши бизнес-клиенты должны иметь возможность начать отправлять сообщения через MM API для WhatsApp.
Если у вас нет доступа к менеджеру WhatsApp, найдите панель администратора вашего бизнес-портфолио здесь .
Для корпоративных клиентов, не имеющих партнера
Если ваш бизнес напрямую интегрируется с Cloud API без участия партнера, следуйте приведенным ниже инструкциям, чтобы принять Условия предоставления услуг и подключиться к MM API для WhatsApp.


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

Настройка через API
Вы также можете настроить активность событий обмена для каждого сообщения отдельно, добавив соответствующий параметр.
Параметр и установка его в логическое значение (True/False) в marketing_messages . Вызов API переопределяет конфигурацию учетной записи по умолчанию для вашей учетной записи WhatsApp Business.Используйте
POST / /marketing_messages для отправки сообщения пользователю WhatsApp.Синтаксис запроса
curl 'https://graph.facebook.com/
< API_VERSION > / < WHATSAPP_BUSINESS_PHONE_NUMBER_ID > /marketing_messages' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< ACCESS_TOKEN > ' \ -d '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "
< WHATSAPP_USER_PHONE_NUMBER > ", "message_activity_sharing": "
< BOOLEAN > ", "type": "
< MESSAGE_TYPE ", "
: "" }
Получение веб-хука, подписанного в соответствии с условиями использования 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 и статуса соответствия требованиям.
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "
< SOLUTION_PROVIDER_BUSINESS_ID > ", "time": "
< WEBHOOK_TIMESTAMP > ", "changes": [
{
"field": "account_update",
"value": {
"event": "MM_LITE_TERMS_SIGNED",
"waba_info": {
"owner_business_id": "
< BUSINESS_PORTFOLIO_ID > ", "waba_id": "
< WABA_ID > " }
}
}
]
}
]
}
Получение веб-хука завершения процесса адаптации (устаревшая версия)
После завершения процесса подключения и настройки связанных рекламных аккаунтов
account_update, указывающий на успешное завершение подключения. Этот веб-хук содержит идентификатор рекламного аккаунта только для чтения, к которому привязан каждый WABA, для использования при вызове API аналитики.Примечание: Этот веб-хук считается устаревшим для API MM для регистрации в WhatsApp. Пожалуйста, используйте веб-хук, подписанный в соответствии с условиями использования API MM для WhatsApp.
Важно:
ad_account_linked больше не будет срабатывать, поскольку партнеры не получат доступ к рекламным аккаунтам.{
"object": "whatsapp_business_account",
"entry": [
{
"id": "
< WABA_ID > ", "time": "
< WEBHOOK_TIMESTAMP > ", "changes": [
{
"field": "account_update",
"value": {
"event": "AD_ACCOUNT_LINKED",
"waba_info": {
"waba_id": "
< WABA_ID > ", "ad_account_id": "
< AD_ACCOUNT_ID > ", "owner_business_id": "
< BUSINESS_PORTFOLIO_ID > " }
}
}
]
}
]
}