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

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

На борту

Обновлено: 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

      Используйте ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> конечную точку и запросить маркетинговые_сообщения_статус_адаптации Поле для проверки статуса соответствия требованиям WhatsApp для пользователя WABA через API MM.
      У соответствующих требованиям WABA это поле установлено на ИМЕЮЩИЙ ПРАВОЕсли это значение установлено на ВСАДИЛСЯЭто означает, что корпоративный клиент WABA уже подключен. См ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> Справочная информация обо всех возможных значениях и их смыслах.
      Пример запроса
      локон 'https://graph.facebook.com/v25.0/25002526842541/?fields=marketing_messages_onboarding_status' \
    -ЧАС «Авторизация: Предъявитель EAAAl...»
      Пример ответа
      {
      "marketing_messages_onboarding_status": "ИМЕЮЩИЙ ПРАВО",
      "идентификатор": "25002526842541"
      }
      Вы также можете использовать ПОЛУЧАТЬ /<BUSINESS_PORTFOLIO_ID> /client_whatsapp_business_accounts Используйте следующую конечную точку с фильтрацией, чтобы получить список всех подходящих WABA, которые были вам предоставлены.
      Синтаксис запроса
      ПОЛУЧАТЬ /<BUSINESS_PORTFOLIO_ID>/client_whatsapp_business_accounts
        ?filtering=[
          {
            'field':'marketing_messages_onboarding_statuс',
            'оператор':'IN',
            'value':['ELIGIBLE']
          }
        ]
      Пример запроса
      локон -г 'https://graph.facebook.com/v25.0/19502398688333/client_whatsapp_business_accounts?filtering=[{'поле':'маркетинговые_сообщения_статус_адаптации','оператор':'В','ценить':['ИМЕЮЩИЙ ПРАВО']}]' \
    -ЧАС 'Авторизация: Предъявитель EAAAj...'
      Пример ответа
      {
      "данные": [
          {
      "идентификатор": "46302397361990",
      "имя": «Кровельные работы в Сан-Андреасе»,
      "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 / Для получения списка возвращаемых значений и их значений используйте справочный материал.
      

      

      

      Если
Вы хотите проверить условия использования и статус запроса намерения для бизнес-менеджера
      Используйте ПОЛУЧАТЬ /<BUSINESS_PORTFOLIO_ID> / конечную точку и запросить маркетинговые_сообщения_статус_адаптации Поле для проверки статуса соответствия требованиям MM API для WhatsApp.
      Разрешение
        управление бизнесом
        Пример запроса
        локон"https://graph.facebook.com/v24.0/52002526842524351/?fields=marketing_messages_onboarding_status" \
        -ЧАС«Авторизация: Предъявитель EAAAl...»
        Пример ответа
        {
        "marketing_messages_onboarding_status":
           {
        «статус»: "УСЛОВИЯ ОБСЛУЖИВАНИЯ ПОДПИСАНЫ"
        "время": "2025-10-07"
           }
        }
        Используйте ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> конечную точку и запросить информация о владельце бизнеса Поле для проверки статуса регистрации WABA.
        Разрешения
          whatsapp_business_managementwhatsapp_business_messaging
          Пример запроса
          локонПОЛУЧАТЬ"https://graph.facebook.com/v24.0/69843579834234?fields=owner_business_info" \
          -ЧАС«Авторизация: Предъявитель EAAAl...»
          Пример ответа
          {
          "owner_business_info": {
          "имя": "Тестирование платной рассылки WhatsApp",
          "идентификатор": "<BM_ID> ",
          "marketing_messages_onboarding_status": {
          «статус»: "УСЛОВИЯ ОБСЛУЖИВАНИЯ ПОДПИСАНЫ" | "ЗАПРОС_ОТПРАВЛЕН" | "НЕ НАЧАЛОСЬ"
          "время": "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⁠.
                Настройка через API
                Вы также можете настроить активность событий обмена для каждого сообщения отдельно, добавив соответствующий параметр <message_activity_sharing> параметр и установка его в логическое значение (True/False) в маркетинговые сообщения Полезная нагрузка вызова API. Вызов API переопределяет конфигурацию учетной записи WhatsApp Business по умолчанию.
                Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /маркетинговые_сообщения Конечная точка для отправки сообщения пользователю WhatsApp.
                Синтаксис запроса
                curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/маркетинговые_сообщения'
                -H 'Content-Type: application/json' \
                -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
                -д '
                {
                  "messaging_product": "whatsapp",
                  "recipient_type": "individual",
                  "к": "<Номер телефона пользователя WhatsApp>",
                  "message_activity_sharing": "<БУЛЕВОЕ>",
                  "тип": "<ТИП СООБЩЕНИЯ",
                ":"<MESSAGE_CONTENTS> "
                }
                Получение веб-хука, подписанного в соответствии с условиями использования 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 и статуса соответствия требованиям.
                

                

                {
                
"объект":
                
"whatsapp_business_account",
                
"вход":
                
[
                    {
                      "идентификатор": "<SOLUTION_PROVIDER_BUSINESS_ID>",
                      "время": "<WEBHOOK_TIMESTAMP>",
                      "изменения": [
                        {
                          "field": "account_update",
                          "ценить": {
                            "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",
                  "вход": [
                    {
                      "идентификатор": "<WABA_ID>",
                      "время": "<WEBHOOK_TIMESTAMP>",
                      "изменения": [
                        {
                          "field": "account_update",
                          "ценить": {
                            "событие": "AD_ACCOUNT_LINKED",
                            "waba_info": {
                              "waba_id": "<WABA_ID>",
                              "ad_account_id": "<AD_ACCOUNT_ID>",
                              "owner_business_id": "<BUSINESS_PORTFOLIO_ID>"
                            }
                          }
                        }
                      ]
                    }
                  ]
                }
                
    
                        
                
    
                

            
                
        
                
    
                

    
                

    
    
                
        
                
             Вернуться наверх