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

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

Начать

Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Узнайте, как отправлять шаблонные сообщения с помощью API маркетинговых сообщений для WhatsApp (MM API для WhatsApp).

Требования

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

    Шаг 1: Примите условия предоставления услуг

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

      Шаг 2: Отправьте шаблонное маркетинговое сообщение

      Используйте marketing_messages , чтобы отправить себе шаблонное сообщение.
      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> ", "type": "template", "template": { "name": "<TEMPLATE_NAME> ", "язык": { "код": "<LANGUAGE_AND_LOCALE_CODE> " }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "text-string" } ] } ] } }'

      Шаг 3: Убедитесь, что сообщение было отправлено через веб-перехватчик состояния

      API MM для WhatsApp запускает вебхуки для сообщений о статусе, фиксируя такие события, как отправка, доставка и прочтение. При отправке сообщения через API MM для WhatsApp в полезной нагрузке вебхука будут установлены значения category и conversation.origin.type равные marketing_lite .
      { "разговор": { "id": "<CONVERSATION_ID> ", "origin": { "type": "marketing_lite" } }, "pricing": { "billable": true, "pricing_model": "PMP", "category": "marketing_lite" } }

      Географическая доступность функций

      Некоторые расширенные функции и возможности формирования отчетов API MM для WhatsApp доступны только в определенных регионах в связи с политикой Meta и/или местными правилами.

      Европейская экономическая зона, Великобритания, Япония, Южная Корея

        Сообщения, отправленные с рабочего телефонного номера в этих странах или потребителю в этих странах, не будут оптимизированы для доставки. Обратите внимание , что ограничения на шаблоны маркетинговых сообщений для каждого пользователя также не действуют в этих странах, поэтому отсутствие оптимизации доставки никак не повлияет на доставку сообщений.Сообщения, отправленные с корпоративного телефонного номера в этих странах или потребителю в этих странах, не будут иметь доступных показателей кликов и конверсий.Для компаний в этих странах метрики недоступны в пользовательском интерфейсе Ads Manager или в API Insights. Как и в случае с Cloud API, метрики будут доступны через Business Management API и в разделе «Метрики разговоров» пользовательского интерфейса WhatsApp Manager.

        Соединенные Штаты

          Начиная с 1 апреля 2025 года, маркетинговые сообщения, отправляемые пользователям WhatsApp в США, не будут доставляться (код ошибки 131049). Обратите внимание, что эта политика не относится только к MM API для WhatsApp — она действует для всех API бизнес-сообщений (включая Cloud API, см. документацию ).Телефонные номера компаний в США по-прежнему смогут использовать API MM для WhatsApp для отправки сообщений пользователям за пределами Соединенных Штатов.

          Куба, Иран, Северная Корея, Сирия и три региона Украины, находящиеся под санкциями (Крым, Донецк, Луганск):

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

            Россия

            Начиная с 20 июня 2025 года, российские компании смогут использовать MM API для WhatsApp со следующими исключениями:
              Сообщения, отправленные компанией с бизнес-профилем Meta в России или с использованием способа оплаты с российским адресом, не будут оптимизированы для доставки.Сообщения, отправленные с рабочего номера телефона в этих странах или потребителю в этих странах, не будут иметь доступных показателей кликов и конверсий. Для компаний в этих странах показатели недоступны в пользовательском интерфейсе Ads Manager или в API Insights. Как и в случае с Cloud API, показатели по-прежнему будут доступны через Business Management API и показатели диалогов в пользовательском интерфейсе WhatsApp Manager.Все остальные функции MM API для WhatsApp остаются доступными.

              Узнать больше

                Узнайте о дополнительных форматах маркетинговых сообщений.