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

Многопартнерские решения

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

В этом документе объясняется, как настроить многопартнерские решения («решения») и как использовать их с функцией встроенной регистрации .

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

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

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

Требования

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

Если ваше приложение будет обращаться к нашим API для доступа к данным зарегистрированных клиентов:

Приложение должно совпадать с тем приложением, токен которого будет использоваться в запросах к API.Приложение должно пройти проверку и получить одобрение на использование whatsapp_business_management и whatsapp_business_messaging .Приложение должно быть подписано на account_updates и иметь возможность успешно обрабатывать веб-хуки для зарегистрированных клиентов.

Создание многосторонних партнерских решений

Используйте управления приложением > WhatsApp > Партнерские решения , чтобы создавать, принимать и управлять решениями.

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

Решения

Состояния решений отображаются на решений партнеров . Решения могут находиться в следующих состояниях:

Состояние	Описание
Активный	Предложенное решение было одобрено приглашенной стороной и может быть использовано для настройки встроенной регистрации для процесса адаптации клиентов.
Деактивировано	Решение деактивировано. Клиенты, пытающиеся получить доступ к встроенной системе регистрации, настроенной для решения в этом состоянии, увидят ошибку, сообщающую, что в данный момент она не может быть использована для регистрации новых пользователей.
Черновик	Решение было инициировано и сохранено, но вы не отправили его своему партнеру. Клиенты, пытающиеся получить доступ к встроенной системе регистрации, настроенной для решения в этом состоянии, увидят ошибку, сообщающую, что в данный момент она не может быть использована для регистрации новых пользователей.
Неактивный	Ваш партнер отклонил запрос на решение. Клиенты, пытающиеся получить доступ к встроенной системе регистрации, настроенной для решения в этом состоянии, увидят ошибку, сообщающую, что в данный момент она не может быть использована для регистрации новых пользователей.
В ожидании	Ваше предложение не было принято или отклонено вашим партнером. Клиенты, пытающиеся получить доступ к встроенной системе регистрации, настроенной для решения в этом состоянии, увидят ошибку, сообщающую, что в данный момент она не может быть использована для регистрации новых пользователей.
Ожидается деактивация	Ваш партнёр запросил деактивацию решения. Вы можете принять или отклонить этот запрос.

Ограничения на процесс адаптации

Технологические компании, предоставляющие решения, могут подключить до 200 новых клиентов в течение одной недели. В этот лимит включаются только клиенты, которые ранее не пользовались платформой WhatsApp Business.

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

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

Выставление счетов

Клиенты, зарегистрированные через встроенную систему регистрации с использованием идентификатора решения, используют кредитную линию партнера по решению, связанного с данным решением.

Шаг 1: Определение деталей решения

Свяжитесь со своим потенциальным партнером и вместе определите:

Название решения. Название решения будет отображаться в «Партнерские решения» на панели управления приложением как для вас, так и для вашего партнера, поэтому вам обоим следует согласовать название, которое будет отличаться от других решений, которые вы можете инициировать или принять.Кто будет создавать и инициировать запрос на решение? Это может сделать любой из партнеров. Если вы инициируете запрос, вам потребуется идентификатор приложения вашего партнера.Кто будет размещать встроенную форму регистрации, настроенную с использованием идентификатора решения? Это может сделать один или оба партнера.Все остальное, например, контракты, соглашения об уровне обслуживания, предоставляемые услуги, процессы выставления счетов и т. д., остается на усмотрение вас и вашего партнера в соответствии с вашими отдельными соглашениями с Meta.

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

Примеры полезных нагрузок и на что следует обращать внимание при получении любого из этих веб-хуков см «Веб-хуки»

Шаг 3: Создание решения

Если вы создаете решение самостоятельно, перейдите в панель управления приложениями > WhatsApp > партнерских решений и нажмите «Создать партнерское решение» .

Используйте идентификатор приложения вашего партнера для завершения процесса. В рамках процесса создания вы можете указать, какие приложения партнеров по решениям могут использоваться подключенными бизнес-клиентами для отправки сообщений ( Только я , Только мой партнер ).

После создания вашему партнеру будет отправлено электронное письмо и уведомление от Meta Business Suite, а также будет запущен веб-перехватчик partner_solutions

Партнерское решение будет отображаться на «Партнерские решения» со «Ожидание» , пока не будет принято вашим партнером. В случае принятия его статус изменится на «Активный» . В случае отклонения — на «Неактивный» .

Шаг 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 .

~~When a customer completes the Embedded Signup flow configured with your solution, an account update webhook is triggered with a~~ ДОБАВЛЕН ПАРТНЕР ~~или~~ PARTNER_APP_INSTALLED ~~event. Capture the~~ waba_id, solution_id~~, и~~ owner_business_id ~~property values contained in the webhook payload, as well as any other values you may need in order to provide the customer with WhatsApp messaging services.~~

Кроме того, мы отправим электронное письмо администраторам бизнес-портфеля, которому принадлежит приложение, а также уведомление 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 необходим для распределения кредитных линий.Функция «Управление» будет работать только при наличии полного доступа к решению, включая функцию обмена сообщениями .

Редактирование или деактивация решений

Для редактирования или деактивации решения вы можете использовать панель управления приложения или API.

При запросе на деактивацию статус решения изменится на «Ожидание деактивации» , и ваш партнер получит уведомление по электронной почте и через Meta Business Suite. Кроме того, будет запущен веб-хук partner_solutions событием SOLUTION_UPDATED и статусом решения PENDING_DEACTIVATION . После этого ваш партнер сможет принять или отклонить ваш запрос.

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

Если запрос на деактивацию будет отклонен, решение останется в активном состоянии и сможет продолжать использоваться для регистрации клиентов.

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

Ограничения

Вы можете редактировать только те решения, которые были созданы вами.Вы можете запросить деактивацию любых созданных вами решений, находящихся в активном состоянии.

Через панель управления приложения

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

Состояние	Разрешенные действия
Активный	Вы можете изменить название решения или деактивировать его.
Деактивировано	Решения в этом состоянии не подлежат редактированию.
Черновик	Вы можете изменить название решения.
Неактивный	Вы можете изменить название решения.
В ожидании	Решения в этом состоянии нельзя редактировать до тех пор, пока ваш партнер не примет или не отклонит их.
Ожидается деактивация	Вы можете принять или отклонить запрос партнера на деактивацию.

Через API

Отправить запрос на деактивацию

~~Используйте~~ ~~POST /<SOLUTION_ID>/send_deactivation_request~~ ~~endpoint to send a solution deactivation request. You must be the solution owner in order to send this request.~~

Принять запрос на деактивацию

~~Используйте~~ ~~POST /<SOLUTION_ID>/accept_deactivation_request~~ ~~endpoint to accept a solution deactivation request. You must be the solution owner in order to send this request.~~

Отклонить запрос на деактивацию

~~Используйте~~ ~~POST /<SOLUTION_ID>/reject_deactivation_request~~ ~~endpoint to reject a solution deactivation request. You must be the solution owner in order to send this request.~~

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

У вас есть несколько вариантов переноса активов корпоративных клиентов в систему Multi-Partner Solutions и обратно. См. раздел « Перенос активов корпоративных клиентов» .