Встроенные компоненты | Документация для разработчиков
На борту
Обновлено: 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 / Используйте следующую конечную точку с фильтрацией, чтобы получить список всех подходящих 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':['ELIGIBLEEAAAj']'...Bearer'-H\Авторизация']}
: Пример ответа
{
"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/52002526842524351/?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Пример запроса
curlGET"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
Вы также можете настроить активность событий обмена для каждого сообщения отдельно, добавив соответствующий параметр.
<message_activity_sharing> Параметр и установка его в логическое значение (True/False) в marketing_messages . Вызов API переопределяет конфигурацию учетной записи по умолчанию для вашей учетной записи WhatsApp Business.Используйте
POST / Конечная точка для отправки сообщения пользователю 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>"
}
}
}
]
}
]
}