Включение предложения SaaS в приложение Teams

С помощью предложения SaaS (программное обеспечение как услуга) вы можете монетизировать приложение Teams, продавая планы подписки непосредственно из списка Microsoft Teams Store. Например, предположим, что у вас есть бесплатное приложение, которое любой пользователь может получить в Магазине Teams. Теперь пользователям, которые хотят получить больше возможностей, можно предложить планы категории премиум и корпоративные планы.

Монетизация приложения в общих чертах выглядит следующим образом.

1. Планирование предложения SaaS.

2. Интеграция с API выполнения SaaS.

3. Создание начальной страницы для управления подписками.

4. Создание предложения SaaS.

5. Настройка приложения для предложения SaaS.

6. Опубликуйте приложение в Магазине Teams.

Планирование предложения SaaS

Подробные рекомендации см. в статье Планирование предложения SaaS для коммерческой платформы Майкрософт.

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

• Определение модели подписки. Поддерживающее транзакции предложение SaaS может включать несколько планов подписки. Общедоступные открытые планы подписки являются наиболее распространенными, но можно также ориентироваться на конкретных клиентов, подготовив варианты специально для них. Дополнительные сведения см. в статье Частные планы на коммерческой платформе Майкрософт.
• Ознакомьтесь с параметром Продажи через список Майкрософт для вашего предложения SaaS, который требуется, если вы хотите, чтобы пользователи приобретали планы подписки для вашего приложения непосредственно в Магазине Teams.
• Узнайте, как единый вход Microsoft Entra помогает клиентам приобретать подписки и управлять ими. (Для приложений Teams с предложениями SaaS требуется единый вход Microsoft Entra.)
• Следует учитывать, что вы несете ответственность за управление инфраструктурой, необходимой для поддержки использования клиентами предложения SaaS, и оплату ее использования.
• Планирование вариантов для мобильных устройств. Чтобы избежать нарушения сторонних политик Магазина Teams, ваше приложение не может включать ссылки, позволяющие пользователям приобретать планы подписки на мобильных устройствах. Тем не менее, если в вашем приложении есть функции, требующие оформления подписки, вы можете сообщить об этом. Дополнительные сведения см. в статье на близкую к этому вопросу тему Политики коммерческой платформы в отношении сертификации.

Интеграция с API выполнения SaaS

Интеграция с API выполнения SaaS необходима для монетизации приложения Teams. Эти API помогают управлять жизненным циклом плана подписки после его приобретения пользователем.

Полные инструкции и информацию об интерфейсах API см. в статье Документация по API выполнения SaaS. Как правило, после приобретения подписки будут выполняться с помощью API перечисленные ниже действия.

1. Получение маркера идентификации покупки с помощью URL-адреса начальной страницы.

2. Использование этого маркера для получения сведений о подписке.

3. Уведомление коммерческой платформы об активации подписки.

Рекомендации по управлению подписками

• С помощью поддерживающих транзакции предложений SaaS для приложений Teams планы подписки (лицензии) должны назначаться отдельным пользователям, а не группам или всей организации.
• После назначения пользователям плана подписки сообщите им об этом с помощью бота Teams или электронной почты. В сообщение включите сведения о том, как добавить приложение в Teams и начать работу.
• Поддержка концепции нескольких администраторов. Иными словами, несколько пользователей в одной и той же организации могут приобретать собственные подписки и управлять ими.

Создание начальной страницы для управления подписками

Когда кто-то завершает покупку плана подписки для вашего приложения в Магазине Teams, коммерческая платформа направляет его на целевую страницу, где он может управлять подпиской (например, назначить лицензию конкретному пользователю в своей организации).

Полные инструкции см. в статье Создание начальной страницы для предложения SaaS.

Рекомендации по начальным страницам

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

• Пользователи должны иметь возможность войти на целевую страницу с теми же учетными данными Microsoft Entra, которые использовались для покупки подписки. Дополнительные сведения см. в статье Идентификатор Microsoft Entra и предложения SaaS для транзакций на коммерческой платформе.
• Разрешите пользователям выполнять перечисленные ниже действия на вашей начальной странице. Следует определить, какими должны быть роль и разрешения пользователя. Например, может потребоваться разрешить поиск пользователей только администраторам подписки).
  • Поиск пользователей в их организации по электронной почте или с помощью другого способа идентификации.
  • Просмотр списка пользователей, которым можно назначать лицензии.
  • Назначение лицензии одному или нескольким пользователям одновременно.
  • Назначение различных типов лицензий (при наличии) и управление ими.
  • Проверка того, назначена ли уже определенная лицензия другому пользователю.
  • Отмена своей подписки.
• Предоставьте вводную информацию об использовании вашего приложения.
• Добавьте способы получения поддержки, такие как часто задаваемые вопросы, база знаний или контактный адрес электронной почты.
• Предоставьте ссылку, которая упрощает подписчику доступ к начальной странице. Например, включите эту ссылку во вкладку О программе вашего приложения.

Создание предложения SaaS

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

Создание предложения

Полные инструкции о том, как это сделать в Центре партнеров, см. в статье Создание предложения SaaS. Ниже описаны действия общего характера.

1. Если у вас еще нет учетной записи в Центре партнеров, создайте ее.

2. Настройте планы подписки, изложите информацию о ценах и другие сведения для вашего предложения SaaS, поддерживающего транзакции. В частности, выполните перечисленные ниже действия.

   • В разделе Подробные настройки выберите Да, чтобы указать, что вы продаете предложение через корпорацию Майкрософт.

   • В разделе Интеграция с Microsoft 365 добавьте ссылку на AppSource в профиль вашего приложения. Это обеспечит пользователям возможность покупать ваши планы подписки не только в Teams, но и в AppSource.

3. Сохраните свои ИД издателя и предложения. (Они понадобятся вам позже, чтобы связать предложение с вашим приложением на портале разработчиков.)

4. Опубликуйте свое предложение на коммерческой платформе.

Тестирование предложения

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

Важно!

Вы можете протестировать сквозную транзакцию в Teams с помощью функции Предварительное тестирование для приложений с монетизацией. Для динамических предложений необходимо выполнить процесс проверки в Магазине Teams.

В том, что касается Teams, цель этих тестов — подтвердить, что при выполнении пользователями указанных ниже действий количество лицензий и назначений соответствует их количеству в Центре администрирования Teams.

• Активация и настройка плана подписки на вашей начальной странице.
• Назначение, удаление или переназначение лицензии себе или другим лицам.
• Отмена или продление подписки.

Публикация предложения

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

Настройка приложения для предложения SaaS

Вы опубликовали предложение SaaS, но по-прежнему необходимо связать его с приложением Teams, чтобы пользователи видели ваши планы подписки в Магазине Teams.

1. Перейдите на Портал разработчика и щелкните Приложения.

2. На странице Приложения выберите приложение, с которое вы связываете с предложением SaaS.

3. Перейдите на страницу Планы и цены и укажите свои ИД издателя и предложения. (Если вы не сохранили эти ИД, можно найти их в Центре партнеров.)

4. Выберите Просмотр для предварительного просмотра планов подписки на предложение SaaS.

5. Если вас все устраивает, щелкните Сохранить.

   В ваш манифест приложения добавляется свойство subscriptionOffer.

      "subscriptionOffer": {
        "offerId": "publisherId.offerId"  
        }
   

Примечание.

Свойство subscriptionOffer поддерживается в схеме манифеста версии 1.10 или более поздней.

Публикация приложения

Вы создали предложение SaaS и связали его с приложением Teams. Теперь пришло время опубликовать приложение в Магазине Teams. Полные инструкции см. в статье Публикация приложения в Магазине Teams.

Важно!

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

После публикации пользователи увидят параметр Купить подписку в диалоговом окне сведений о приложении при попытке добавить ваше приложение в Teams.

Удаление предложения SaaS из приложения

Если вы отключаете связь с предложением SaaS, включенным в список в Магазине Teams, необходимо повторно опубликовать приложение, чтобы увидеть изменения в Магазине Teams.

1. Перейдите на Портал разработчика и щелкните Приложения.
2. На странице Приложения выберите приложение, из которое удаляется предложение.
3. Перейдите на страницу Планы и цены и выберите Отменить.
4. После отмены связи с предложением выполните следующие действия, чтобы обновить описание в Магазине Teams:
   1. Выберите Распространить > публикацию в магазин Teams.
   2. Выберите Открыть центр партнеров, чтобы начать процесс повторной публикации приложения без предложения.

Пример кода

Название примера	Описание	Node.js	Манифест
Монетизация приложения tab	Это пример приложения вкладки, в котором показано, как открыть диалоговое окно покупки и запустить поток покупки с помощью пакета SDK для Teams JS.	Просмотр	Просмотр

См. также

• Рекомендации по проверке для приложений, связанных с предложением SaaS
• Коммерческая платформа Майкрософт