Решения для работы с несколькими партнерами | Документация для разработчиков
Многопартнерские решения
Обновлено: 27 февраля 2026 г
В этом документе объясняется, как настроить многопартнерские решения («решения») и как использовать их с функцией встроенной регистрации .
Многопартнерские решения позволяют партнерам по решениям и поставщикам технологий совместно управлять ресурсами WhatsApp клиентов, чтобы предоставлять услуги обмена сообщениями WhatsApp своим клиентам. Например, если вы являетесь поставщиком технологий и не можете предложить своим клиентам индивидуальные или полноценные услуги обмена сообщениями WhatsApp, вы можете сотрудничать с партнером по решениям, чтобы предложить своим клиентам услуги этого партнера.
После создания и подтверждения через API или панель управления приложением идентификатор решения можно использовать для настройки встроенного процесса регистрации. Любые клиенты, зарегистрированные через настроенный процесс, могут предоставить доступ к ресурсам всем партнерам решения.
Обратите внимание, что решения также можно настроить с помощью встроенной кнопки, которая запускает интерфейс для сбора информации о приложении от поставщиков технологий. Этот процесс и задействованные вызовы API описаны в «Многопартнерское решение — создание встроенной функции» , но приведенная ниже информация по-прежнему актуальна и должна быть прочитана в первую очередь.
Требования
Вы должны быть утвержденным партнером по решениям , поставщиком технологий, выполнившим шаги, описанные в нашем «Начало работы для поставщиков технологий», соответствующие предполагаемому использованию, или поставщиком технологий, получившим статус технологического партнера .
Если ваше приложение будет обращаться к нашим API для доступа к данным зарегистрированных клиентов:
Создание многосторонних партнерских решений
Используйте управления приложением > WhatsApp > Партнерские решения , чтобы создавать, принимать и управлять решениями.
Решения могут быть созданы любым из партнеров, участвующих в проекте. После создания запроса на решение он отправляется приглашенному партнеру, который затем может использовать панель в своей панели управления приложением, чтобы принять или отклонить запрос. После принятия запроса любой из партнеров может использовать идентификатор решения для настройки встроенного процесса регистрации и подключения бизнес-клиентов.
Решения
Состояния решений отображаются на решений партнеров . Решения могут находиться в следующих состояниях:
Активный
Предложенное решение было одобрено приглашенной стороной и может быть использовано для настройки встроенной регистрации для процесса адаптации клиентов.
Деактивировано
Решение деактивировано.
Черновик
Решение было инициировано и сохранено, но вы не отправили его своему партнеру.
Неактивный
Ваш партнер отклонил запрос на решение.
В ожидании
Ваше предложение не было принято или отклонено вашим партнером.
Ожидается деактивация
Ваш партнёр запросил деактивацию решения. Вы можете принять или отклонить этот запрос.
Ограничения на процесс адаптации
Технологические компании, предоставляющие решения, могут подключить до 200 новых клиентов в течение одной недели. В этот лимит включаются только клиенты, которые ранее не пользовались платформой WhatsApp Business.
Встроенная регистрация
Встроенная регистрация может быть настроена и размещена любым из партнеров решения или обоими партнерами. После внедрения клиенты, использующие ее, увидят персонализированную версию процесса встроенной регистрации, которая ясно дает понять, что, завершив этот процесс, они предоставляют доступ к данным WhatsApp обоим партнерам:
Когда клиент завершает процесс, все необходимые нам ресурсы WhatsApp клиента автоматически генерируются, и доступ к этим ресурсам предоставляется обоим партнерам по решению.
Выставление счетов
Клиенты, зарегистрированные через встроенную систему регистрации с использованием идентификатора решения, используют кредитную линию партнера по решению, связанного с данным решением.
Шаг 1: Определение деталей решения
Свяжитесь со своим потенциальным партнером и вместе определите:
Шаг 2: Подпишитесь на веб-хуки
Подпишитесь на account_update и partner_solutions . Эти веб-хуки будут информировать вас о подключении новых корпоративных клиентов, а также о создании или редактировании партнерских решений, с которыми вы связаны.
Примеры полезных нагрузок и на что следует обращать внимание при получении любого из этих веб-хуков см «Веб-хуки»
Шаг 3: Создание решения
Если вы создаете решение самостоятельно, перейдите в панель управления приложениями > WhatsApp > партнерских решений и нажмите «Создать партнерское решение» .
Используйте идентификатор приложения вашего партнера для завершения процесса. В рамках процесса создания вы можете указать, какие приложения партнеров по решениям могут использоваться подключенными бизнес-клиентами для отправки сообщений ( Только я , Только мой партнер ).
После создания вашему партнеру будет отправлено электронное письмо и уведомление от Meta Business Suite, а также будет запущен веб-перехватчик partner_solutions
Партнерское решение будет отображаться на «Партнерские решения» со «Ожидание» , пока не будет принято вашим партнером. В случае принятия его статус изменится на «Активный» . В случае отклонения — на «Неактивный» .
Шаг
4: Accept The Solution Request
событиеРЕШЕНИЕ СОЗДАНОsolution_statusИНИЦИИРОВАНОsolution_idЧерез панель управления приложения
Через API
имяправа владельцапартнеры{partner_permissions,partner_app}Пример запроса
локон -г 'https://graph.facebook.com/v25.0/795033096057724&fields=name,owner_permissions,partners{partner_permissions,partner_app}' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "name": "Социальный OVD с Lucky Shrub", "owner_permissions": [ "MANAGE", "DEVELOP", "MANAGE_TEMPLATES", "MANAGE_PHONE", "VIEW_COST", "MANAGE_EXTENSIONS", "VIEW_PHONE_ASSETS", "MANAGE_PHONE_ASSETS", "VIEW_TEMPLATES", "VIEW_INSIGHTS" ], "partners": { "data": [ { "partner_permissions": [ "MANAGE", "DEVELOP", "MANAGE_TEMPLATES", "MANAGE_PHONE", "VIEW_COST", "MANAGE_EXTENSIONS", "VIEW_PHONE_ASSETS", "MANAGE_PHONE_ASSETS", "VIEW_TEMPLATES", "VIEW_INSIGHTS" ], "partner_app": { "link": "https://www.facebook.com/games/?app_id=21202248997039", "name": "Lucky Shrub", "id": "21202248997039" }, "id": "795033099391057" } ], "paging": { "cursors": { "before": "QVFIUl9hX0RqLUZAPemJQVWdsYTl5WlBsY0lCb0FNTExOY2N2NzJtRENZAbDd3azBNXzhPZAndqaU5sSXdfWWJaSXJ1S2pqMi0tQUdUdm1LTGZATUDNIdGRNNE1B", "after": "QVFIUl9hX0RqLUZAPemJQVWdsYTl5WlBsY0lCb0FNTExOY2N2NzJtRENZAbDd3azBNXzhPZAndqaU5sSXdfWWJaSXJ1S2pqMi0tQUdUdm1LTGZATUDNIdGRNNE1B" } } }, "id": "795033096057724" }
имяправа владельцаpartner_permissionspartner_apppartner_permissionsПример запроса на принятие
локон -X POST 'https://graph.facebook.com/v25.0/795033096057724/accept' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример запроса на отклонение
локон -X POST 'https://graph.facebook.com/v25.0/795033096057724/reject' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "success": true }
Шаг 5: Настройка встроенной регистрации
Присвойте идентификатор решения
solutionID в extras.setup в регистрации метода запуска и обратного вызова кода встроенной регистрации.// Регистрация метода запуска и обратного вызова const launchWhatsAppSignup = () => { FB.login(fbLoginCallback, { config_id: '<CONFIGURATION_ID> ', // Здесь указывается ваш идентификатор конфигурации, убедитесь, что он заключен в кавычки response_type: 'code', override_default_response_type: true, extras: { setup: { solutionID: '<SOLUTION_ID> ' // добавьте идентификатор решения здесь, убедитесь, что он заключен в кавычки }, featureType: '', sessionInfoVersion: '3', } }); }Портфолио вашего бизнеса и бизнеса вашего партнера ( Настройки бизнеса > Информация о бизнесе ) будет отображаться на протяжении всего процесса встроенной регистрации.
После настройки отображайте настроенный процесс встроенной регистрации клиентам на вашей платформе там, где считаете это целесообразным. Обратите внимание, что если у вас несколько активных партнерских решений, вы несете ответственность за добавление правильного идентификатора решения в конфигурацию встроенной регистрации и его отображение целевым клиентам, иначе клиент может быть зарегистрирован с использованием неправильного решения.
Шаг 6: Отслеживайте активность подключенных бизнес-клиентов
Чтобы отслеживать новых зарегистрированных клиентов, ваше приложение должно быть подписано на account_update .
Когда клиент завершает встроенный процесс регистрации, настроенный для вашего решения, запускается веб-перехватчик обновления учетной записи с
PARTNER_ADDED или PARTNER_APP_INSTALLED . Захватите waba_id , solution_id и owner_business_id , содержащиеся в полезной нагрузке веб-перехватчика, а также любые другие значения, которые могут потребоваться для предоставления клиенту услуг обмена сообщениями WhatsApp.Кроме того, мы отправим электронное письмо администраторам бизнес-портфеля, которому принадлежит приложение, а также уведомление Meta Business Suite бизнес-портфелю, которому принадлежит приложение.
Если вы являетесь партнером по решениям, предоставьте свою кредитную линию всем новым корпоративным клиентам, подключенным через партнерское решение.
Примечание : Если вы являетесь партнером по решениям и пытаетесь добавить пользователя в бизнес-аккаунт WhatsApp, предоставленный вам, вам необходимо учесть следующие сценарии:
на отправку сообщений в рамках решения, вам необходимо определить, какие именно задачи вам нужны при добавлении пользователя в общий бизнес-аккаунт WhatsApp: DEVELOP , MANAGE_TEMPLATES , MANAGE_PHONE , VIEW_COST , MANAGE_EXTENSIONS , VIEW_PHONE_ASSETS , MANAGE_PHONE_ASSETS , VIEW_TEMPLATES , VIEW_INSIGHTS , MANAGE_USERS и MANAGE_BILLING .В этом сценарии также следует отметить, что параметр MANAGE_BILLING необходим для распределения кредитных линий.Функция «Управление» будет работать только при наличии полного доступа к решению, включая функцию обмена сообщениями .
Вебхуки
account_update
событиеДОБАВЛЕН ПАРТНЕР{ "entry": [ { "id": "<BUSINESS_PORTFOLIO_ID> ", "время":<TIMESTAMP> , "изменения": [ { "значение": { "событие": "<EVENT> ", "waba_info": { "waba_id": "<BUSINESS_CUSTOMER_WABA_ID> ", "owner_business_id": "<BUSINESS_CUSTOMER_BUSINESS_PORTFOLIO_ID> ", "solution_id": "<SOLUTION_ID> ", "solution_partner_business_ids": [<SOLUTION_BUSINESS_PORTFOLIO_IDS> ] } }, "field": "account_update" } ] } ], "object": "whatsapp_business_account" }
Свойства полезной нагрузки
| | |
| | |
| | |
| | |
| | |
| | |
| |
партнерские_решения
{ "entry": [ { "id": "<BUSINESS_PORTFOLIO_ID> ", "время":<TIMESTAMP> , "изменения": [ { "значение": { "событие": "SOLUTION_CREATED", "solution_id": "<SOLUTION_ID> ", "solution_status": "INITIATED" }, "field": "partner_solutions" } ] } ], "object": "whatsapp_business_account" }
Свойства полезной нагрузки
| | |
| | |
| | |
| | |
| |
Редактирование или деактивация решений
Для редактирования или деактивации решения вы можете использовать панель управления приложения или API.
При запросе на деактивацию статус решения изменится на «Ожидание деактивации» , и ваш партнер получит уведомление по электронной почте и через Meta Business Suite. Кроме того,
будет запущен веб-хук partner_solutions событием SOLUTION_UPDATED и статусом решения PENDING_DEACTIVATION . После этого ваш партнер сможет принять или отклонить ваш запрос.Обратите внимание, что партнерские решения по-прежнему можно использовать для регистрации клиентов до тех пор, пока ваш партнер не примет запрос на деактивацию.
Если запрос на деактивацию будет отклонен, решение останется в активном состоянии и сможет продолжать использоваться для регистрации клиентов.
Если запрос на деактивацию будет принят, статус решения изменится на «Деактивировано» , и его больше нельзя будет использовать для подключения корпоративных клиентов, поэтому убедитесь, что ни вы, ни ваш партнер не предоставляете его корпоративным клиентам.
Ограничения
Через панель управления приложения
используйте «Панель управления приложениями > WhatsApp > Партнерские решения» . Обратите внимание, что редактировать можно только те решения, которые были инициированы вами.
Активный
Вы можете изменить название решения или деактивировать его.
Деактивировано
Решения в этом состоянии не подлежат редактированию.
Черновик
Вы можете изменить название решения.
Неактивный
Вы можете изменить название решения.
В ожидании
Решения в этом состоянии нельзя редактировать до тех пор, пока ваш партнер не примет или не отклонит их.
Ожидается деактивация
Вы можете принять или отклонить запрос партнера на деактивацию.
Через API
Отправить запрос на деактивацию
Используйте POST /
Пример
запрос
curl -X POST 'https://graph.facebook.com/v20.0/795033096057724/send_deactivation_request \ -H 'Авторизация: Bearer EAAAT...'
Пример ответа
{ "success": true }
Принять запрос на деактивацию
Используйте POST /
Пример
запрос
curl -X POST 'https://graph.facebook.com/v20.0/795033096057724/accept_deactivation_request \ -H 'Авторизация: Bearer EAAAT...'
Пример ответа
{ "success": true }
Отклонить запрос на деактивацию
Используйте POST /
Пример
запрос
curl -X POST 'https://graph.facebook.com/v20.0/795033096057724/reject_deactivation_request \ -H 'Авторизация: Bearer EAAAT...'
Пример ответа
{ "success": true }
Ручная проверка зарегистрированных клиентов
Синтаксис запроса
ПОЛУЧАТЬ /<BUSINESS_PORTFOLIO_ID>/клиентские бизнес-аккаунты WhatsApp
?фильтрация=[{"поле":"partners","operator":"ALL","ценить":["<PARTNER_BUSINESS_PORTFOLIO_ID>"]}]<PARTNER_BUSINESS_PORTFOLIO_ID>Ответ
{ "data": [ { "id": "<CUSTOMER_WABA_ID> ", "имя": "<CUSTOMER_WABA_NAME> ", "timezone_id": "<CUSTOMER_WABA_TIMEZONE_ID> ", "business_type": "ent", "message_template_namespace": "<MESSAGE_TEMPLATE_NAMESPACE> " }, ... ], "пагинация": { "курсоры": { "перед": "<BEFORE> ", "после": "<AFTER> " }, "следующий": "<NEXT> " } }
| | |
| | |
| | |
| | |
| | |
| |
Пример запроса
локон -г 'https://graph.facebook.com/v25.0/506914307656634/client_whatsapp_business_accounts?filtering=[{%22field%22%3A%22partners%22%2C%20%22operator%22%3A%20%22ALL%22%2C%20%22value%22%3A%20[%22520744086200222%22]}]' \
-ЧАС «Авторизация: Предъявитель EAAJB...»Пример ответа
{"данные":[{"идентификатор":"102290129340398","имя":"Cool New Customer 2","timezone_id":"7","business_type":"ent","message_template_namespace":"<MESSAGE_TEMPLATE_NAMESPACE>"},{"идентификатор":"112077945305052","имя":"Cool New Customer 1","timezone_id":"7","business_type":"ent","message_template_namespace":"<MESSAGE_TEMPLATE_NAMESPACE>"},...],"пейджинг":{"курсоры":{"до":"QVFIU...","после":"QVFIU..."},"следующий":"https://graph.facebook.com/v25.0/50691..."}}Получение данных решения
Получение полей из решения
поляПример запроса
локон 'https://graph.facebook.com/v25.0/17602267745700?fields=name,status,partners' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "name": "Social OVD with Lucky Shrub", "status": "ACTIVE", "partners": { "data": [ { "partner_app": { "link": "https://www.socialoverdrive.com/", "name": "Social Overdrive", "id": "637576208107267" }, "status": "ACCEPTED", "id": "17602267745704" } ], "paging": { "cursors": { "before": "QVFIUmxnSE9LUFliNzlUTWdhTlYzQjBtekprSC0wQUdoZAGRYbFlzeUpDMG9yNkF1OHYyel9tcUlBbGhFckxJQ1Y3UFZA4dUkycEk0WDJwRGYzT2JYbVhEdFdB", "after": "QVFIUmxnSE9LUFliNzlUTWdhTlYzQjBtekprSC0wQUdoZAGRYbFlzeUpDMG9yNkF1OHYyel9tcUlBbGhFckxJQ1Y3UFZA4dUkycEk0WDJwRGYzT2JYbVhEdFdB" } } }, "id": "17602267745700" }
Получите решения, связанные с вашим приложением
Пример запроса
локон 'https://graph.facebook.com/v25.0/21202248997039/whatsapp_business_solutions' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "data": [ { "name": "Social OVD with Lucky Shrub", "status": "INITIATED", "status_for_pending_request": "PENDING_ACTIVATION", "id": "19702253086782" }, { "name": "Social OVD with Social Brew", "status": "ACTIVE", "status_for_pending_request": "NONE", "id": "17602267745700" } ], "paging": { "cursors": { "before": "QVFIUkxlbkhTZA1VleGwyWHd3SmlSMnlnelhlbUVSSjVYQmU2aXVmb1YyWk9JTkx3b2gwNE9FS3J2ejMzNENxbmh1bWZAqSkZAJUzNfbmF4NmtPaFYxQldaaXR3", "after": "QVFIUlgyLTlQYWV0eTNGWXVhcTJnOEhzY1lvUDloVV8wUUxVQk9YMVJ5UGlBZAmx1Q1BjaEVwd0tWdmNvRU9jdGRiNnlrc193alRNaDV2SXZAfN1kybDBibEFR" } } }
Получите решения, которые обеспечили подключение WABA
Пример запроса
локон 'https://graph.facebook.com/v25.0/102290129340398/solutions' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "data": [ { "name": "Social OVD with Social Brew", "status": "ACTIVE", "status_for_pending_request": "NONE", "id": "17602267745700" } ], "paging": { "cursors": { "before": "QVFIUjZACTFNmWURVTHN2NFVaM2ZApd2RaOGIxOU5wenpQZADFkbVdtSEJDSGFDelhDOU5hT28xcmJLS05TM3U0UUFmdVNGUWFfdjdJb1o2OTVNY083ZAHYtc2x3", "after": "QVFIUjZACTFNmWURVTHN2NFVaM2ZApd2RaOGIxOU5wenpQZADFkbVdtSEJDSGFDelhDOU5hT28xcmJLS05TM3U0UUFmdVNGUWFfdjdJb1o2OTVNY083ZAHYtc2x3" } } }
Найдите партнеров для решения
Пример запроса
локон 'https://graph.facebook.com/v25.0/17602267745700/partners' \
-ЧАС 'Authorization: Bearer EAAAT...'Пример ответа
{ "data": [ { "partner_app": { "link": "https://www.socialoverdrive.com", "name": "Social Overdrive", "id": "637576208107267" }, "status": "ACCEPTED", "id": "17602267745704" } ], "paging": { "cursors": { "before": "QVFIUmxnSE9LUFliNzlUTWdhTlYzQjBtekprSC0wQUdoZAGRYbFlzeUpDMG9yNkF1OHYyel9tcUlBbGhFckxJQ1Y3UFZA4dUkycEk0WDJwRGYzT2JYbVhEdFdB", "after": "QVFIUmxnSE9LUFliNzlUTWdhTlYzQjBtekprSC0wQUdoZAGRYbFlzeUpDMG9yNkF1OHYyel9tcUlBbGhFckxJQ1Y3UFZA4dUkycEk0WDJwRGYzT2JYbVhEdFdB" } } }
Получение бизнес-токенов от клиентов
Запрос
business_idcurl 'https://graph.facebook.com/<API_VERSION> /<SOLUTION_ID> /access_token?business_id=<CUSTOMER_BUSINESS_PORTFOLIO_ID> ' \ -H 'Авторизация: Предъявитель<SYSTEM_TOKEN> '
Параметры запроса
| ||
| | |
| | |
| |
Ответ
{ "data": [ { "access_token": "<CUSTOMER_BUSINESS_TOKEN> " } ] }
Перенос активов корпоративных клиентов между различными решениями
У вас есть несколько вариантов переноса активов корпоративных клиентов в систему Multi-Partner Solutions и обратно. См. раздел « Перенос активов корпоративных клиентов» .