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

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

Когда компания регистрируется в MM API для WhatsApp, создаются рекламные аккаунты только для чтения, которые связываются с каждым из маркетинговых шаблонов, существующих в портфеле ее бизнеса.

Эти связанные учетные записи позволяют бизнесу:

Эти рекламные аккаунты, доступные только для чтения, синхронизируются со всеми изменениями в маркетинговых шаблонах, так что любые изменения в маркетинговых шаблонах отражаются в связанном рекламном объекте.

Выполните следующие шаги, чтобы подключиться к MM API для WhatsApp.

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

Кроме того, должны быть выполнены следующие требования:

API MM для WhatsApp будет постоянно обновлять вертикальные критерии соответствия и правила, чтобы соответствовать различным международным нормам и правилам, поэтому эти требования могут меняться.

Для управляемых партнерами WABA компании могут найти подходящие WABA, используя следующую конечную точку:

Для отправки сообщения через 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.

Примечание: значение события ToS станет доступно с 8 сентября 2025 года. См. информацию об устаревшем веб-хуке ниже.

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

Вы можете использовать включенные идентификаторы бизнес-портфеля и WABA для проверки соответствия требованиям и начала отправки сообщений или запуска последующих действий по подключению по мере необходимости. Этот веб-хук является предпочтительным для отслеживания API MM для подключения к WhatsApp и статуса соответствия требованиям.

После завершения процесса подключения и настройки связанных рекламных аккаунтов account_update, указывающий на успешное завершение подключения. Этот веб-хук содержит идентификатор рекламного аккаунта только для чтения, к которому привязан каждый WABA, для использования при вызове API аналитики.

Примечание: Этот веб-хук считается устаревшим для API MM для регистрации в WhatsApp. Пожалуйста, используйте веб-хук, подписанный в соответствии с условиями использования API MM для WhatsApp.

Важно: ad_account_linked больше не будет срабатывать, поскольку партнеры не получат доступ к рекламным аккаунтам.