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

Привлечение корпоративных клиентов

Обновлено: 10 февраля 2026 г

API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.

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

Прежде чем начать

Вашему приложению необходимы расширенные права доступа для следующих разрешений:

whatsapp_business_messaging : Это разрешение позволяет приложению вызывать API MM для WhatsApp для отправки сообщений.whatsapp_business_management : Это разрешение позволяет приложению управлять WABA-кодами, номерами телефонов и шаблонами через API управления бизнесом WhatsApp .ads_read (необязательно): Это разрешение предоставляет приложению доступ к API Insights , позволяя партнерам получать метрики по конверсиям.

Если ваше приложение еще не имеет расширенного доступа к этим разрешениям, запросите расширенный доступ через раздел «Проверка приложения» .

Обзор интеграции с партнерами по решениям

Для того чтобы помочь вашим клиентам использовать MM API для WhatsApp, необходимо выполнить несколько шагов:

Шаг	Примечания
1: Пройдите адаптацию	Зарегистрируйтесь через панель управления приложения и следуйте инструкциям в разделе «Ввод в эксплуатацию» самостоятельно .
2: Отправка сообщений	Тот же шаблон конечной точки и полезная нагрузка для отправки сообщения, что и в Cloud API — отличается только конечная точка «отправить сообщение».
3: Просмотр метрик	Новинка! Интеграция с API Insights позволяет просматривать метрики как из Cloud API (отправленные/прочитанные/доставленные), а также новые метрики, такие как конверсии веб-сайта и приложения.

Самостоятельная регистрация

Зарегистрируйтесь для получения MM API для WhatsApp

Для регистрации поставщик решений должен:

Перейдите в панель управления приложением > WhatsApp > Панель быстрого запускаНа «Быстрый старт» найдите карточку «Повышение рентабельности инвестиций с помощью API маркетинговых сообщений для WhatsApp» и нажмите кнопку «Начать».Запросите недостающие разрешения на проверку приложения, нажав кнопку «Запросить разрешение». Дополнительную информацию Отправить приложение на проверку Нажмите «Перейти к руководству по интеграции», чтобы принять Условия предоставления услуг

Отправьте приложение на проверку для получения расширенных разрешений

При использовании API MM для WhatsApp поставщики решений должны использовать приложение со следующими расширенными разрешениями.

Если ваше приложение еще не имеет следующих расширенных разрешений, необходимо, чтобы оно прошло проверку на соответствие требованиям :

Расширенные разрешения приложения	Необходимо для выполнения следующих действий от имени вашего клиента
`whatsapp_business_messaging`	Для отправки сообщений через API маркетинговых сообщений для WhatsApp воспользуйтесь конечной точкой MM API для WhatsApp: «Отправить сообщения»
`whatsapp_business_management`	Для управления учетными записями WABA, номерами телефонов и шаблонами используйте конечные точки WABA, номерами телефонов и шаблонами, а также получите основные показатели через API управления бизнесом WhatsApp.
`ads_read` (необязательно)	Это разрешение является необязательным и требуется только для вызова API аналитики , позволяя партнеру получать расширенные метрики по конверсиям (например, конверсии на веб-сайте, конверсии в приложении).

Для отправки приложения на проверку подготовьте видеозапись экрана, демонстрирующую использование каждого разрешения. Рекомендуется показать пример каждого действия в столбце «Необходимо для выполнения…» выше, чтобы показать использование каждого разрешения в действии.

Внедрение конечных бизнес-процессов

Существует несколько способов, с помощью которых партнер может подключить компанию, с которой он сотрудничает, к API MM для WhatsApp и получить необходимые токены доступа для отправки сообщений и получения метрик от ее имени:

через WhatsApp Manager (рекомендуется)через встроенную регистрацию

Самостоятельная регистрация в MM API для WhatsApp через WhatsApp Manager (рекомендуется)

Если ваша компания интегрируется с облачным API через поставщика решений, они смогут подключиться напрямую через WhatsApp Manager .

Подключите компанию к MM API для WhatsApp с помощью встроенной регистрации

API MM для WhatsApp имеет собственный встроенный процесс регистрации, который могут использовать поставщики решений, и который:

позволяет вашим клиентам регистрироваться в Cloud API и MM API для WhatsAppЭто позволяет запросить токен доступа с необходимыми разрешениями для отправки сообщений через MM API для WhatsApp и получения метрик из Insights API от имени ваших клиентов.

Шаг 1: Интеграция с SDK для входа через Facebook

Если вы еще этого не сделали для Cloud API, настройте JavaScript SDK Facebook и вход через Facebook, чтобы встроить процесс регистрации в свой веб-сайт или клиентский портал. Вы можете встроить этот процесс на несколько принадлежащих вам веб-страниц или порталов.

Шаг 2: Настройка новой конфигурации разрешений

Следуйте инструкциям в шаге 2 документации по встроенной регистрации , чтобы создать новую конфигурацию входа через Facebook для бизнеса. В конфигурации выберите следующее:

Ресурсы:

аккаунты WhatsApp(Не выбирайте другие варианты: рекламные аккаунты, страницы, каталоги, пиксели, аккаунты Instagram)

Права доступа:

ads_read (необязательно)whatsapp_business_managementwhatsapp_business_messaging

Шаг 3: Запустите встроенную форму регистрации

ознакомьтесь с по внедрению встроенной системы регистрации и добавьте функцию marketing_messages_lite в список функций.

{ "config_id": "<config_id> ", "response_type": "code", "override_default_response_type": true, "extras": { "featureType": "whatsapp_business_app_onboarding", "sessionInfoVersion": "3", "features": [ { "name": "marketing_messages_lite" } ], "version": "v3" } }

Шаг 4: Дождитесь подтверждения регистрации через веб-перехватчик

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

Подробную информацию о account_update см Ввод в систему .

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

Подключите компанию к API маркетинговых сообщений для WhatsApp, используя Intent API

Партнеры могут использовать Intent API для подключения бизнеса к Marketing Messages API для WhatsApp (MM API для WhatsApp), автоматически помечая все WABA-коды от имени клиента (OBO), которые должны быть переданы клиенту, и получая асинхронное (веб-хук) уведомление после завершения подключения для получения необходимых токенов доступа.

Если у конечной компании есть какие-либо OBO WABA, для которых в настоящее время не задано намерение миграции OBO, это намерение будет автоматически установлено для всех OBO WABA между партнером и конечной компанией посредством этого вызова API.

1) Вызовите API намерений

Вызов API намерений для подключения BMID к MM API для WhatsApp инициирует отправку электронного письма всем администраторам этого BMID, направляя их к процессу подключения в Business Manager. Meta будет связываться с администраторами BMID до тех пор, пока они либо не подключатся, либо не отклонят приглашение к подключению.

Для вызова API намерений для каждого из своих соответствующих конечных бизнес-подразделений партнеры должны использовать токен доступа системного пользователя для приложения с расширенными правами доступа.

Квалифицированным конечным бизнесом считается тот, который:

Компания еще не подписала API MM для условий использования WhatsAppВ настоящее время является партнерским бизнесом, что обусловлено наличием 1 или более совместных или OBO WABA с BSPИмеет 1+ WABA в MM API для страны, имеющей право на налогообложение WhatsApp

Запрос:

curl -i -X POST \ "https://graph.facebook.com/<API_VERSION> /<END_BUSINESS_ID> /onboard_partners_to_mm_lite?access_token=<SYSTEM_USER_ACCESS_TOKEN> "

Дополнительный корпус:

Если партнер хочет перенести OBO WABA в решение WhatsApp Business, а не предоставлять доступ к ним только партнеру, в вызов API можно передать необязательный solution_id.

{ "solution_id": "<MULTI-PARTNER_SOLUTION_ID> " }

Ответ:

{ "request_id": "893436979557695" }

Ошибка: Неверный тип получателя

Причина: Конечный бизнес не имеет права подключаться к MM API для WhatsApp, потому что

Они либо уже приняли Условия использованияКонечный бизнес не находится в стране, включенной в список разрешенныхВ настоящее время нет стран, имеющих право на получение льгот WABA, которые передаются в BSPОшибка: Ваша компания уже отправила этот запрос. Чтобы отследить статус запроса, свяжитесь с компанией, у которой вы запрашиваете доступ.

Причина: К данной компании уже поступал запрос на подключение к MM API для WhatsApp с использованием этого процесса.Ошибка: У приложения недостаточно прав для вызова этого API.

Причина: Приложение, используемое SUAT для вызова API, должно иметь расширенный доступ как минимум к разделам whatsapp_business_messaging и whatsapp_business_management.Каково ожидаемое поведение объектов OBO WABA и какой устанавливается намерение миграции?

1 совместное, 4 OBO с намерением

Вызов выполнен успешно, создается API MM для намерения WhatsApp, но новое намерение OBO не устанавливается0 общих, 5 OBO с намерением

Вызов выполнен успешно, создается API MM для намерения WhatsApp, но новое намерение OBO не устанавливается1 совместно, 4 OBO без намерения

Вызов выполнен успешно, создан API MM для намерения WhatsApp, установлен новый интент OBO0 совместно используемых, 5 OBO без намерения

Вызов выполнен успешно, создается API MM для намерения WhatsApp, при условии установки намерения OBO0 совместно, 0 OBO

Вызов не удался, не установлен API MM для намерения WhatsApp или OBO

2) Дождитесь подтверждения регистрации через веб-перехватчик

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

3) Получите обновленный токен доступа пользователя системы интеграции бизнеса (BISUAT). Для вызова API Insights вам потребуется токен доступа пользователя системы интеграции бизнеса, привязанный к рекламному аккаунту, связанному с управляемым вами WABA. Следуйте инструкциям в разделе «API управления токенами доступа пользователя системы интеграции бизнеса», чтобы получить существующий токен для управления идентификаторами рекламных аккаунтов, полученными в веб-хуке.

Синтаксис запроса:

curl -i -X POST "https://graph.facebook.com/<API_VERSION> /<CLIENT_BUSINESS_ID> /system_user_access_tokens ?appsecret_proof="<APPSECRET_PROOF_HASH> " &access_token="<SYSTEM_USER_ACCESS_TOKEN> " &fetch_only=true

Объект	Описание	Пример значения
`<API_VERSION>`	Версия Graph API.	v23.0
`<APPSECRET_PROOF_HASH>`	Обязательно. Параметр appsecret_proof представляет собой хеш sha256 вашего токена доступа, гарантирующий более высокую безопасность вызовов API с сервера. Подробнее .	e3b0c...
`<CLIENT_BUSINESS_ID>`	Обязательно. Идентификатор компании-клиента.	2780023991704
`<SYSTEM_USER_ACCESS_TOKEN>`	Обязательно. Для использования этого токена доступа требуется разрешение business_management.	EAAJZC...

Синтаксис ответа

{ "access_token": "<NEW_ACCESS_TOKEN> " }

Подключение пользователей приложения WhatsApp Business (так называемое «сосуществование»)

Вы можете настроить встроенную регистрацию таким образом, чтобы корпоративные клиенты могли регистрироваться, используя свою существующую учетную запись приложения WhatsApp Business и номер телефона:

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

Примечание: Для обеспечения точного отслеживания показателей мы рекомендуем корпоративным клиентам избегать перехода по ссылкам в своих маркетинговых сообщениях. Переход по этим ссылкам может повлиять на данные отслеживания и привести к искаженным результатам.

Пользователи приложения Offboard WhatsApp Business

После отключения Coexistence вы автоматически будете отключены от MM API для WhatsApp. Рекламный аккаунт будет деактивирован и отвязан, что предотвратит отслеживание показателей конверсии.

Помогите компании настроить систему измерения конверсии

Подробную информацию о том, как компании могут измерять, когда маркетинговое сообщение из MM API для WhatsApp приводит к конверсии (например, добавлению в корзину, покупке), см. в разделе «Настройка измерения конверсий»

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

Отправка сообщений

См. раздел «Отправка сообщений» для получения документации о том, как отправлять сообщения и получать веб-хуки от имени ваших клиентов через MM API для WhatsApp.

Показатели просмотров

См. Руководство по просмотру метрик для получения документации о том, как:

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

Партнерам настоятельно рекомендуется получать метрики с помощью API Ads Insights (а не API Business Management), поскольку эти API предоставляют более полные отчеты по метрикам, включая отчеты о конверсиях из таких источников, как события конверсии на веб-сайте и в приложении.

После интеграции с API для создания отчетов (рекомендуется использовать Insights API) отобразите эти метрики на своих панелях мониторинга и в API, чтобы ваши клиенты могли ими пользоваться.

Обратитесь к своему менеджеру по работе с партнерами за рекомендациями по передовым методам сбора метрик, включая копию руководства Meta «Создание панелей мониторинга для бизнес-коммуникаций » для партнеров.