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

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

Многопартнерское решение —- Встроенное создание

Обновлено: 12 декабря 2025 г
Многопартнерские решения (MPS) позволяют партнерам по решениям и поставщикам технологий совместно управлять активами клиентов в WhatsApp для предоставления услуг обмена сообщениями WhatsApp клиентам.
Если вы являетесь партнером по решениям, вместо использования панели управления приложения для создания MPS, вы можете создать его с помощью фрагмента JavaScript и HTML-кнопки, которую можно встроить где-нибудь на вашем веб-сайте. Поставщики технологических решений, желающие сотрудничать с вами, могут использовать эту кнопку, чтобы предоставить вашему приложению разрешение на управление решениями для одного или нескольких их приложений, что вы затем сможете сделать с помощью серии запросов API.

Поток

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

Требования

    необходимо настроить вход через Facebook для бизнеса Для корректной работы приложения, указав действительные URI перенаправления OAuth и разрешенные домены для JavaScript SDK . Эти значения должны быть уже установлены при настройке встроенной регистрации.Ваше приложение должно пройти проверку и получить разрешение на расширенный доступ к параметру manage_app_solution .

    Встроенная кнопка создания

    Шаг 1: Предоставьте приложению разрешение

    Получите доступ к Meta Business Suite и, используя учетную запись вашей системы, предоставьте вашему приложению manage_app_solution .
      Войдите в систему business.facebook.com⁠?.Воспользуйтесь выпадающим меню «Портфолио бизнеса» слева, чтобы найти свое портфолио бизнеса, и нажмите на значок шестеренки (для перехода к настройкам).Перейдите в раздел Пользователи > Системные пользователи.Нажмите на пользователя системы, имеющего доступ к корпоративным ресурсам в вашем приложении и аккаунте WhatsApp Business.Нажмите «Сгенерировать токен» .Выберите приложение.Установите срок действия токена.Выберите manage_app_solution .Сгенерируйте токен.
      Используйте этот токен при принятии любых многопартнерских решений, которые вы создаете для своих партнеров (см. ниже).

      Шаг 2: Добавьте код встроенной кнопки

      Добавьте следующий код на свой веб-сайт или портал, или в любое другое место, куда вы планируете направлять поставщиков технических услуг, которые будут работать с вами в рамках MPS. Обязательно замените... <SOLUTION_PARTNER_APP_ID> с вашим идентификатором приложения.
      <!--
      Загрузка JavaScript SDK асинхронно --><scriptасинхронныйотложитькроссоригин="аноним"src="https://connect.facebook.net/en_US/sdk.js"></script><script>// Настройка JavaScript SDK окно.fbAsyncInit =функция(){ ФБ.инициализация({ appId:"<SOLUTION_PARTNER_APP_ID> ",// Замените на идентификатор вашего приложения печенье:истинный, xfbml:истинный, версия:"v20.0"});};// Запуск процесса создания MPSфункция launchSolutionCreationFlow(){ ФБ.авторизоваться(функция(ответ){если(ответ.authResponse){константа accessToken = ответ.authResponse.accessToken; консоль.бревно(accessToken);// Замените на свой код, который получает токен доступа}еще{ консоль.бревно(«Пользователь не авторизовался»);// Замените на свой код, который регистрирует ошибку аутентификации}},{ объем:"manage_app_solution"});}</script><buttonпри клике="launchSolutionCreationFlow()"стиль="фон-цвет:#1877f2; border: 0; border-radius: 4px; color: #fff; cursor: pointer; font-family: Helvetica, Arial, sans-serif; font-size: 16px; font-weight: bold; height: 40px; padding: 0 24px;">Запуск процесса создания решения</button>
      Направьте потенциальных партнеров-поставщиков технологий по этому адресу и попросите их выполнить процедуру. Сообщите им, что выполнение процедуры не создает решение (для этого требуются некоторые вызовы API с вашей стороны) и что ты'ты'Я сообщу им идентификатор решения, как только оно будет создано.

      Создание решения

      Шаг 1: Получение пользовательского токена

      Каждый раз, когда поставщик технических решений использует встроенную кнопку создания решения и завершает процесс, процесс возвращает результат authResponse объект (response.authResponse) который имеет accessToken свойство:
      { status: 'connected', authResponse: { accessToken: '<USER_ACCESS_TOKEN> ', expiresIn:'<TOKEN_EXPIRATION_TIMESTAMP> ', reauthorize_required_in:'<SECONDS_UNTIL_REAUTH_REQUIRED> ', signedRequest:'<SIGNED_PARAMETER> ', ID пользователя:'<USER_ID> ' } }
      Захватить accessToken Значение свойства. Это токен доступа пользователя от поставщика технологий, который вам понадобится далее.
      Шаг 2: Получите подробную информацию о приложении
      Используйте токен доступа пользователя поставщика технических услуг и GET /me/assigned_applications Конечная точка для получения списка идентификаторов приложений, которые поставщик технических услуг выбрал при завершении процесса.
      Пример запроса
      curl 'https://graph.facebook.com/v20.0/me/application_details' \ -H 'Авторизация: Bearer EAAJB'
      Пример ответа
      Пример ответа поставщика технологических услуг, выбравшего в процессе только одно приложение.
      { "data": [ { "link": "www.mediamonsoon.com", "name": "media_monsoon_prod", "id": "634974688087057" } ] }
      Каждый объект в ответе описывает приложение, выбранное поставщиком технических услуг при прохождении процесса. Зафиксируйте идентификатор Оценка стоимости недвижимости каждого приложения для следующего шага.
      Шаг 3: Создайте решение для поставщика технологий
      Используйте токен доступа поставщика технологий и идентификатор приложения из предыдущего шага, чтобы отправить запрос ПОЧТА /<APP_ID> /whatsapp_business_solution конечная точка.
      Повторите этот запрос для каждого идентификатора приложения, полученного на предыдущем шаге.
      Синтаксис запроса
      ПОЧТА /<APP_ID>/решение для бизнеса через WhatsApp
      { "owner_permissions": ["MESSAGING"], "partner_app_id": "<SOLUTION_PARTNER_APP_ID> ", "partner_permissions": ["MESSAGING"], "solution_name": "<SOLUTION_NAME> " }
        <SOLUTION_PARTNER_APP_ID> — Ваш идентификатор приложения.<SOLUTION_NAME> — Название для решения. Это название будет отображаться на панели управления приложения как для вас, так и для поставщика технических услуг, поэтому оно должно быть уникальным и отличаться от других решений, которые вы или поставщик технических услуг можете инициировать или принять в дальнейшем.
        Ответ
        В случае успеха API создаст решение и свяжет ваше приложение и приложение поставщика технологий с ним.
        { "solution_id": "<SOLUTION_ID> " }
        Захватить solution_id Это идентификатор решения, который понадобится вам на следующем шаге.
        Шаг 4: Примите решение
        Используйте свой системный токен доступа пользователя Предоставить разрешение приложению шаг и идентификатор решения для отправки запроса в ПОЧТА /<SOLUTION_ID> /принимать конечная точка для любых решений, которые вы создали для поставщиков технологий.
        Пример запроса
        curl -X POST 'https://graph.facebook.com/v20.0/795033096057724/accept' \ -H 'Авторизация: Bearer EAATA...'.
        Пример ответа
        В случае успеха:
        { "success": true }
        После того как вы примете решение, сообщите техническому партнеру об успешном создании решения и предоставьте ему все идентификаторы решений, которые вы создали и приняли.
        
    
                
        
    
        

            
        
        
        
    
        

    
        

    
    
        
        
        
             Вернуться наверх