Перейти к основному содержимому

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

На борту

Обновлено: 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 будет постоянно обновлять вертикальные критерии соответствия и правила, чтобы соответствовать различным международным нормам и правилам, поэтому эти требования могут меняться.

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

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

              Если ваш бизнес напрямую интегрируется с Cloud API без участия партнера, следуйте приведенным ниже инструкциям, чтобы принять Условия предоставления услуг и подключиться к MM API для WhatsApp.
                Перейдите в Панель управления приложением > WhatsApp > быстрого запуска .На «Быстрый старт» найдите карточку «Повысьте рентабельность инвестиций с помощью 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 > " }
                }
                }
                ]
                }
                ]
                }