Инструкции магазина Teams по проверке приложений

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

Примечание.

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

Предлагаемые преимущества

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.1 и содержит дополнительные рекомендации для разработчиков приложений Microsoft Teams о ценностном предложении их предложения.

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

Вкладки

Вкладки должны обеспечивать не только функцию размещения существующего веб-сайта. [Обязательное исправление]

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

На рисунке показан пример приложения со всем веб-сайтом в I-фрейме без параметра back.


Боты уведомлений Уведомление предоставляет значение в Teams, если:
  1. Опубликованная карточка или текст предоставляют достаточные сведения, не требующие дальнейших действий пользователя.
  2. Опубликованная карточка или текст предоставляют пользователю достаточные предварительные сведения для выполнения действия или принятия решения о просмотре дополнительных сведений по ссылке, которая открывается за пределами Teams.

Приложения, которые предоставляют только уведомления с содержимым, например" У вас есть новое уведомление, щелкните, чтобы просмотреть и требовать от пользователя перейти за пределы Teams для всего остального, не обеспечивают значительного значения в Teams.

Снимок экрана: пример уведомления только бит с недостаточной информацией в предварительной версии.


Расширения сообщений

[Обязательное исправление]

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

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

  1. Опубликованная карточка предоставляет достаточные сведения, не требующие дальнейших действий пользователя.

  2. Опубликованная карточка предоставляет пользователю достаточные предварительные сведения для выполнения действия или принятия решения о просмотре дополнительных сведений по ссылке, которая открывается за пределами Teams.

    validation-search-base-messaging-ext-adequete-info

    validation-search-base-messaging-ext-inadequete-info


Распаковка связи

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


К началу страницы

имя приложения;

[Обязательное исправление]

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.1.1 и содержит дополнительные рекомендации для разработчиков по именованию приложений.

Развернуть, чтобы узнать больше

Имя приложения играет важную роль в том, как пользователи обнаруживают его в Магазине Teams. При присвоении названия приложению используйте следующие правила.

  • Название должно содержать термины, которые имеют отношение к вашим пользователям. [Обязательное исправление]

  • Добавьте в качестве префикса или суффикса имя нарицательное с именем разработчика. Например, Задачи Contoso вместо Задачи. [Обязательное исправление]

  • Не следует использовать Teams или другие названия продуктов Майкрософт, такие как Excel, PowerPoint, Word, OneDrive, SharePoint, OneNote, Azure, Surface и Xbox, которые могут ложно указывать на совместную торговую марку или совместную продажу. Дополнительные сведения о ссылках на программные продукты и службы Майкрософт см. в рекомендациях по товарным знакам и фирменной символике Майкрософт. [Обязательное исправление]

  • Не следует копировать имя приложения, указанного в Магазине Teams или другом предложении на коммерческой платформе. [Обязательное исправление]

  • Имя не должно содержать ненормативную или оскорбительную лексику. Имя также не должно включать язык, не учитывающий расовые или культурные особенности. [Обязательное исправление]

  • Имя должно быть уникальным. Если ваше приложение (Contoso) указано в Магазине Teams и Microsoft AppSource и вы хотите указать другое приложение, относяноеся к географическому региону, например Contoso Mexico, ваша отправка должна соответствовать следующим критериям:

    • Укажите функции приложения, связанные с регионом, в названии, метаданных, интерфейсе первого отклика приложения и разделах справки. Например, названием должно быть Contoso Mexico. Название приложения должно четко отличать существующее приложение от того же разработчика, чтобы не запутать конечных пользователей. [Обязательное исправление]
    • При отправке пакета приложения в Центре партнеров выберите в разделе Доступность нужные рынки, где доступно приложение. [Обязательное исправление]
  • Имя приложения не должно использоваться с основными функциями Teams, такими как Чат, Контакты, Календарь, Звонки, Файлы, Действия, Teams и Справка. Имя приложения не сокращается до чата, контактов, календаря, звонков, файлов, действий, Teams и справки при установке в левой области навигации. [Обязательное исправление]

  • Если ваше приложение является частью официального партнерства с корпорацией Майкрософт, имя приложения должно быть первым. Например, соединитель Contoso для Microsoft Teams.

  • Имя приложения не должно содержать никаких ссылок на продукты Майкрософт или Майкрософт. Не используйте Teams или Майкрософт в имени приложения, если ваше приложение не находится в официальном партнерстве с корпорацией Майкрософт. В таком случае имя приложения должно быть первым перед любой ссылкой на Корпорацию Майкрософт. Например, соединитель Contoso для Microsoft Teams. [Обязательное исправление]

  • Не используйте круглые скобки при именовании для включения продуктов Майкрософт. [Обязательное исправление]

  • Имя разработчика должно совпадать в манифесте приложения (ранее — манифест приложения Teams) и AppSource. [Обязательное исправление]

  • Отправленные манифесты приложений должны быть рабочими. Соответственно, имя приложения не должно указывать на то, что приложение является предварительным. Например, имя приложения не должно содержать такие слова, как Beta, Dev, Preview и UAT. [Обязательное исправление]

  • Имя приложения в манифесте приложения и AppSource должно совпадать. [Обязательное исправление]

Совет

Фирменная символика приложения в Магазине Teams и AppSource, включая имя приложения, имя разработчика, значок приложения, снимки экрана AppSource, видео, краткое описание и веб-сайт отдельно или вместе взятые, не должны олицетворять официальное предложение Майкрософт, если ваше приложение не является официальным предложением Microsoft 1P.

Повторяющееся приложение

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

    • Чтобы выполнить требования к поддержке нескольких регионов, необходимо встроиться в бизнес-логику и опубликовать только один список.

    Снимок экрана: пройденный сценарий требования к региону, выполненный с помощью логики.

    • Чтобы выполнить несколько требований к конечным точкам для локального и облачного развертывания, необходимо выполнить сборку в бизнес-логику и опубликовать только одно описание.

Пригодность для использования в рабочей обстановке

[Обязательное исправление]

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.1.2, 100.8 и 100.10 и содержит дополнительные рекомендации для разработчиков по созданию приложений, подходящих для рабочих мест.

Развернуть, чтобы узнать больше

Содержимое приложения должно быть пригодным для использования в обычной рабочей обстановке и соответствовать всем ограничениям, указанным в политиках сертификации коммерческой платформы. Запрещается содержимое, связанное с религией, политикой, азартными играми и продолжительными развлечениями. [Обязательное исправление]

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

Приложения-агрегаторы контента должны иметь механизм, позволяющий пользователям сообщать издателю приложения о проблеме или неуместном содержимом. [Обязательное исправление]

Снимок экрана: пройденный сценарий приложения-агрегатора контента для сообщения о проблемах.

Аналогичные платформы и службы

[Обязательное исправление]

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.1.3.

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

Названия функций

Имена функций приложений в кнопках и другом тексте пользовательского интерфейса не должны использовать терминологию, зарезервированную для Teams и других продуктов Майкрософт. Например, "Начать собрание", "Позвонить" или "Начать чат" — это названия функций, используемых корпорацией Майкрософт в Microsoft Teams. При необходимости укажите имя приложения, чтобы прояснить различие, например Начать собрание Contoso.

Проверка подлинности

[Обязательное исправление]

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.1.4 и содержит рекомендации для разработчиков по проверке подлинности своих приложений с помощью внешних служб.

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

Развернуть, чтобы узнать больше

Проверка подлинности с помощью внешних служб

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

  • Процессы входа, выхода и регистрации:

    • В приложениях, зависящих от внешних учетных записей или служб, должен быть предусмотрен простой и понятный интерфейс регистрации, а также входа в учетную запись и выхода из нее. [Обязательное исправление]
    • При выходе пользователей из приложения они не должны выходить из Teams. [Обязательное исправление]
    • Приложения, зависящие от внешних учетных записей или служб, должны предоставить новым пользователям следующий шаг для регистрации или связи с издателем приложения, чтобы узнать больше о службах и получить доступ к ним. Путь вперед должен быть доступен в манифесте приложения, подробном описании AppSource и интерфейсе первого запуска приложения (приветственное сообщение бота, настройка вкладки или страница конфигурации). [Обязательное исправление]
    • Приложения, для которых администратор клиента должен завершить однократную настройку, должны вызывать зависимость от администратора клиента для настройки приложения (прежде чем любой другой пользователь клиента сможет установить и использовать приложение). Зависимость должна быть вызвана в манифесте приложения, подробном описании AppSource, всех точках касания при первом запуске (приветственное сообщение бота, настройка вкладки или страница конфигурации), тексте справки, который считается необходимым в рамках ответа бота, расширениях создания или статичном содержимом вкладки. [Обязательное исправление]
  • Возможности общего доступа к содержимому: в справочной документации (или других ресурсах) по приложениям, требующим проверки подлинности во внешней службе для общего доступа к содержимому в каналах Teams, должно быть понятно описано, как отсоединить содержимое или прекратить общий доступ к нему, если такая же функция поддерживается во внешней службе. Это не означает, что в вашем приложении Teams обязательно должна присутствовать возможность прекращения общего доступа.

"Audio" (Аудио);

  • Если основной целью приложения является прослушивание музыки, оно должно поддерживать по крайней мере один совместный область с комплексным рабочим процессом, характерным для приложения. Например, общий доступ к списку воспроизведения, настройка или закрепление списка воспроизведения и синхронное прослушивание музыки. [Обязательное исправление]

  • Приложения, опубликованные с основным намерением позволить пользователям слушать музыку в Teams, рекомендуется включать совместное прослушивание. [Предлагаемое исправление]

Безопасность

Этот раздел соответствует политике коммерческой сертификации Майкрософт no 1140.3.

К началу страницы

Финансовые сведения

[Обязательное исправление]

Этот раздел соответствует политике коммерческой сертификации Майкрософт под номером 1140.3.1 и содержит рекомендации по передаче финансовой информации в интерфейсе Teams и уведомляет разработчиков о сценариях ограниченной оплаты в мобильной версии приложения Teams (Android и iOS).

Развернуть, чтобы узнать больше

Приложения не должны запрашивать у пользователей платежи в интерфейсе Teams и передавать пользователям финансовую информацию через интерфейс бота. [Обязательное исправление]

validation-financial-info

Вы можете предоставить ссылку на безопасные внешние службы платежей, только если вы объявили об этом в условиях использования, политике конфиденциальности, на странице профиля или веб-сайта до того, как пользователь согласился использовать приложение. [Обязательное исправление]

Не поддерживайте оплату через приложение для товаров или услуг, запрещенных общей политикой №100.10 "Недопустимое содержимое". [Обязательное исправление]

Приложения, работающие в версии Teams для iOS или Android, должны соответствовать следующим рекомендациям:

  • Приложения не должны включать покупки из приложения, пробные предложения или пользовательский интерфейс, который предназначен для продажи пользователей в платные версии или интернет-магазины для приобретения другого содержимого, приложений или надстроек. [Обязательное исправление]

    validation-financial-info-in-app-purchase

    validation-online-store

  • Если для вашего приложения требуется учетная запись, пользователи могут бесплатно зарегистрировать учетную запись. Использование термина бесплатное или бесплатная учетная запись запрещается. [Обязательное исправление]

  • Вы можете определить, активируется ли учетная запись на неопределенный срок или на ограниченное время. По истечении срока действия учетной записи приложение не должно отображать пользовательский интерфейс, текст или ссылки, указывающие на необходимость оплаты. [Обязательное исправление]

  • Кроме того, политика конфиденциальности и условия использования вашего приложения не должны содержать элементов интерфейса или ссылок, предназначенных для коммерческих целей. [Обязательное исправление]

боты;

[Обязательное исправление]

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.3.2.

Развернуть, чтобы узнать больше

Работая с приложениями, использующими службу Microsoft Azure Bot (такими как боты и расширения для сообщений), необходимо соблюдать все требования, определенные в Условиях использования веб-служб Майкрософт.

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

validation-bot-confirmation

Внешние домены

[Обязательное исправление]

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.3.3 и содержит рекомендации для разработчиков по использованию ограниченных доменов в свойстве манифеста validDomains приложения.

Развернуть, чтобы узнать больше

Не включайте домены вне контроля организации (включая подстановочные знаки) и службы туннелирования в конфигурации домена приложения. Предусмотрены следующие исключения:

  • Если ваше приложение использует SharePoint, можно включить связанный корневой сайт SharePoint в качестве допустимого домена с помощью свойства контекста {teamSiteDomain}. [Обязательное исправление]

  • Не используйте домены верхнего уровня, такие как .com, .in и .org , в качестве допустимого домена. [Обязательное исправление]

  • Не используйте .onmicrosoft.com или в качестве допустимого домена, в котором onmicrosoft не под вашим контролем. Однако вы можете использовать yoursite.com в качестве допустимого домена, в котором ваш сайт находится под вашим контролем, даже если домен содержит подстановочный знак. [Обязательное исправление]

  • Если ваше приложение является Приложением PowerApp, созданным на платформе Microsoft Power Platform, необходимо включить apps.powerapps.com в качестве допустимого домена, чтобы приложение было доступным и функциональным в Teams.

  • Внешние домены, объявленные для отправки, не должны содержать URL-адреса. Например, www или https. [Обязательное исправление]

  • Если приложение использует OAuthCard Служба Bot Azure, необходимо включить token.botframework.com в качестве допустимого домена, иначе кнопка Войти не будет работать. Не следует объявлять .botframework.com как подстановочные знаки с этим доменным именем. [Обязательное исправление]

  • URL-адреса OpenAPI должны находиться под контролем партнера.

  • Следующие внешние домены не разрешены: [Обязательное исправление]

    • *.azurewebsites.net
    • *.azureedge.com
    • *.microsoft.com
    • *.microsoftonline.com
    • *.onmicrosoft.com
    • go.microsoft.com
    • teams.microsoft.com

При использовании подстановочных знаков (*) применяются следующие правила:

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

Например, *.*.domain.com является допустимым, но foo.*.myteam.domain.com является недопустимым.

Конфиденциальные данные

[Обязательное исправление]

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

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

Общие функциональные возможности и производительность

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.

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

К началу страницы

Запуск внешних функций

[Обязательное исправление]

Приложения не должны вывести пользователей из Teams для основных пользовательских сценариев. Содержимое приложений и взаимодействия должны выполняться в рамках возможностей Teams, таких как боты, адаптивные карточки, вкладки и диалоговые окна (в TeamsJS версии 1.x они называются модулями задач).

Развернуть, чтобы узнать больше
  • Пользователь должен оставаться в приложении Teams, а не переходить на внешний сайт или приложение. В сценариях, которые требуют внешних функций, приложение должно получать явное разрешение пользователя для запуска функций. [Обязательное исправление]

  • Текст кнопки пользовательского интерфейса, которая запускает внешние функции, должен включать содержимое, указывающее, что пользователь покидает экземпляр Teams. Например, добавьте текст Перейти в Contoso.com или Просмотреть в Contoso.com. [Обязательное исправление]

  • Добавьте значок всплывающего окна, чтобы сообщить пользователям, что они перемещаются за пределы Teams. Вы можете использовать всплывющий значок справа от ссылки. [Обязательное исправление]

  • Если вам не удается добавить значок всплывающего окна, можно реализовать любой из следующих параметров, чтобы сообщить пользователю, что он перемещается за пределами Teams: [Обязательное исправление]

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

Совместимость

[Обязательное исправление]

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

  • Microsoft Windows
  • macOS
  • Microsoft Edge
  • Google Chrome
  • iOS
  • Android

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

Время отклика

[Обязательное исправление]

Приложения Teams должны реагировать в течение разумного интервала времени или отображать индикатор загрузки или ввода, сообщение или предупреждение.

  • Вкладки должны реагировать в течение двух секунд или отображать сообщение о загрузке либо предупреждение. [Обязательное исправление]
  • Боты должны отвечать на команды пользователей в течение двух секунд или отображать индикатор ввода. [Обязательное исправление]
  • Расширения для сообщений должны отвечать на команды пользователей в течение двух секунд. [Обязательное исправление]
  • Уведомления должны отображаться в течение двух секунд после действия пользователя. [Обязательное исправление]

Приложения на основе искусственного интеллекта

Изучите ресурсы, предназначенные для того, чтобы помочь вам с ответственными методами искусственного интеллекта (ИИ) на каждом этапе инноваций, таких как Microsoft RAI Toolkit и HAX Toolkit Project.

Этот раздел соответствует политике коммерческой платформы Майкрософт для приложений с содержимым, созданным ИИ , и политике Коммерческой платформы Майкрософт для приложений, использующих возможности распознавания лиц.

Приложения с содержимым, созданным ИИ

  • Приложение не должно создавать, содержать и предоставлять доступ к нежелательному, вредоносному или оскорбительному содержимому искусственного интеллекта в соответствии с существующими политиками коммерческой платформы, описанными в версии 100.10. [Обязательное исправление]

    • Рассмотрите возможность использования любого из следующих вариантов:
      • Используйте библиотеку ИИ Teams, интерфейс, ориентированный на Teams, для общих языковых моделей на основе GPT и обработчиков намерений пользователей. [Предлагаемое исправление]
      • Использование перехватчиков модерации, которые можно использовать для регулирования ответов бота с помощью API модерации. [Предлагаемое исправление]
      • Добавьте возможность масштабирования бесед, которая помогает отслеживать беседы и вмешиваться в ситуации, когда беседы сбились с пути. [Предлагаемое исправление]
  • Приложение должно предоставлять пользователям приложения механизмы для передачи разработчику неприемлемого, вредоносного или оскорбительного содержимого с помощью любого из следующих механизмов: [Обязательное исправление]

    • Описание приложения, включая идентификатор почты или ссылку на портал для регистрации проблемы.
    • В механизме приложения регистрируется проблема вместе с конкретной ссылкой на неподходящее содержимое.
  • Вы должны своевременно принять меры по сообщаемой проблеме. [Обязательное исправление]

  • Приложение должно четко описать функциональные возможности ИИ, прежде чем клиент получит предложение в соответствии с политикой 100.1.3 и предложить пользователю просмотреть сведения в рамках функций в приложении. [Обязательное исправление].

    Снимок экрана: описание функций ИИ.

Приложения, использующие возможности распознавания лиц

Примечание.

Приложения в этой категории могут пройти дополнительную проверку на соответствие принципам ответственного ИИ Майкрософт.

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

Пакет приложения и описание в Магазине Teams

[Обязательное исправление]

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

Совет

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

  • Включите следующие подробные инструкции по тестированию для проверки отправки приложения.

    • Укажите действия по настройке учетных записей тестирования приложения, если приложение зависит от внешних учетных записей для проверки подлинности.
    • Приведите обзор ожидаемого поведения приложения для основных рабочих процессов в Teams.
    • Четко описать ограничения, условия или исключения из функциональных возможностей, функций и конечных результатов в подробном описании приложения и связанных материалах.
    • Выделите любые учитываемые моменты для тест-инженеров при проверке отправки приложения.
    • Предварительно заполняйте тестовые учетные записи фиктивными данными , чтобы упростить тестирование.
    • Если вы предоставляете тестовые учетные записи, убедитесь, что вы включили стороннюю интеграцию. Кроме того, отключите двухфакторную или многофакторную проверку подлинности.

К началу страницы

Манифест приложения

[Обязательное исправление]

Манифест приложения определяет конфигурацию приложения.

  • Манифест приложения должен соответствовать общедоступной схеме манифеста приложения. Дополнительные сведения см. в справочнике по манифесту приложения. Не отправляйте приложение с помощью предварительной версии манифеста приложения.
  • Если ваше приложение включает бот или расширение для сообщений, сведения в манифесте приложения должны соответствовать метаданным Bot Framework, включая имя бота, логотип, ссылку на политику конфиденциальности и ссылку на условия предоставления услуг.
  • Если приложение использует Microsoft Entra ID для проверки подлинности, добавьте идентификатор Microsoft Entra приложения (клиента) в манифест приложения. Дополнительные сведения см. в справочнике по манифесту приложения.

Использование последней схемы манифеста приложения

  • Если приложение использует единый вход ( SSO), необходимо объявить Microsoft Entra ID в манифесте приложения для проверки подлинности пользователей. [Обязательное исправление]

  • Необходимо использовать общедоступную схему манифеста приложения. Вы можете обновить пакет приложения, чтобы использовать общедоступную версию схемы манифеста приложения 1.10 или более поздней. [Обязательное исправление]

  • При отправке обновления приложения только увеличьте номер версии приложения. Идентификатор приложения обновленного приложения должен соответствовать идентификатору опубликованного приложения. [Обязательное исправление]

  • Наличие дополнительных файлов в пакете приложения недопустимо. [Обязательное исправление]

  • Номер версии должен совпадать в схеме файла манифеста приложения и схеме манифеста приложения дополнительных языков. [Обязательное исправление]

  • Для локализации приложения необходимо использовать схему манифеста приложения версии 1.5 или более поздней. Чтобы использовать схему приложения версии 1.5 или более поздней в файле manifest.json, обновите $schema атрибут до версии 1.5 или более поздней. Обновите manifestVersion свойство до $schema версии (в данном случае 1.5). [Обязательное исправление]

  • При добавлении, обновлении или удалении существующей возможности, добавления или удаления манифеста приложения или метаданных Центра партнеров необходимо увеличить номер версии приложения и отправить новый манифест приложения в учетную запись Центра партнеров для проверки. [Обязательное исправление]

  • Строка версии должна соответствовать стандарту Семантической спецификации версий (SemVer) (MAJOR. НЕЗНАЧИТЕЛЬНЫЕ. PATCH). [Обязательное исправление]

  • Если администраторы приложения должны просматривать разрешения и предоставлять согласие в Центре администрирования Teams, необходимо объявить webapplicationinfo в манифесте приложения. Если webapplicationinfo параметр не объявлен в манифесте приложения, страница Разрешения для вашего приложения в Центре администрирования Teams отображается как ... [Обязательное исправление]

  • В рамках сертификации приложений Teams необходимо отправить рабочую версию манифеста приложения. [Обязательное исправление]

  • Рекомендуется объявить идентификатор Microsoft Partner Network (MPN) в манифесте приложения. Идентификатор MPN помогает определить организацию партнера, которая создает приложение. [Предлагаемое исправление]

  • Области и (или) контекст, объявленные в манифесте приложения, должны быть видны в приложении. [Обязательное исправление]

Значки приложений

[Обязательное исправление]

Значки являются одним из main элементов, которые пользователи видят при просмотре Магазина Teams.

Развернуть, чтобы узнать больше

Значки должны сообщать о бренде и назначении приложения, а также удовлетворять следующим требованиям.

  • Цвет и значок структуры приложения, отправленные в списке приложения, должны совпадать. [Обязательное исправление]

    Снимок экрана: цветной значок и значок контура совпадают.

    Снимок экрана: значок цвета и значок контура не совпадают.

  • Пакет приложения должен содержать две версии значка приложения в формате PNG: цветную и контурную. [Обязательное исправление]

  • Значок Marketplace, загруженный как часть описания приложения в Marketplace в вашей учетной записи Центра партнеров, должен соответствовать значку цвета, указанному в пакете приложения. [Обязательное исправление]

  • Цветная версия значка должна иметь размер 192x192 пикселя. Символ значка может быть любого цвета или цветов, но он должен быть размещен на сплошном или полностью прозрачном квадратном фоне. [Обязательное исправление]

  • Версия с контуром значка отображается в следующих сценариях.

    • Когда приложение используется и находится в панели приложений в левой части Teams.
    • Когда пользователь закрепляет расширение для сообщений вашего приложения.
  • Контур должен иметь размер 32x32 пикселя и может быть белым с прозрачным фоном или прозрачным с белым фоном. Значок не должен иметь дополнительных заполнений вокруг символа. [Обязательное исправление]

  • Пакет приложения должен содержать значки правильного размера и формата. Значки должны соответствовать сведениям в метаданных описания в Магазине Teams. [Обязательное исправление]

Дополнительные сведения см. в правилах для значков.

Описания приложений

У вас должно быть краткое и длинное описание приложения. Описание приложения помогает улучшить возможности обнаружения приложений в Магазине Teams. Описания в конфигурации приложения и Центре партнеров должны быть одинаковыми.

На рисунке показан пример адекватного описания приложения в приложении Teams.

На рисунке показан неудающийся сценарий для неправильного описания приложения.



Развернуть, чтобы узнать больше

Описания не должны напрямую или с помощью предложения отменять другой бренд (принадлежащий Корпорации Майкрософт или иным образом). Убедитесь, что описание не содержит утверждений, которые не могут быть подтверждены. Например, Гарантированное 200-процентное повышение эффективности.

  • Описание приложения не должно содержать сравнительную маркетинговую информацию. Например, не используйте логотипы конкурентов или товарные знаки в списке предложений, включая теги или другие метаданные, ссылающиеся на конкурирующие предложения или marketplace. [Обязательное исправление]

    На рисунке показан пример сравнительной маркетинговой информации в описании приложения.

  • Гиперссылка контактных данных, начало работы, справка или регистрация в описании приложения. [Предлагаемое исправление]

    На рисунке показан пример сведений о контактах с гиперссылкой в описаниях приложения.

    На рисунке показан пример контактных данных, которые не содержат гиперссылки в описаниях приложений.

  • Описание приложения должно идентифицировать целевую аудиторию, кратко и четко объяснить его уникальность и уникальность, определять поддерживаемые продукты Майкрософт и другое программное обеспечение, а также включать все предварительные требования или требования для его использования. Вы должны четко описать любые ограничения, условия или исключения из функциональных возможностей, функций и конечных результатов, как описано в описании и связанных материалах, прежде чем клиент получит ваше предложение. Объявленные возможности должны относиться к основным функциям и описанию вашего предложения. [Обязательное исправление]

  • При обновлении имени приложения замените старое имя приложения новым именем в метаданных предложения в манифесте приложения, AppSource и везде, где это применимо. [Обязательное исправление]

  • Ограничения и зависимости учетных записей должны быть указаны в манифесте Описание приложения, AppSource и Центр партнеров. Например:

    • Корпоративная учетная запись
    • Платная подписка
    • Другая лицензия или учетная запись
    • Язык
    • Набор телефонных сетей общего пользования (ТСОП)
    • Региональная зависимость
    • Время для резервирования переводчиков или живых агентов
    • Функциональные возможности на основе ролей
    • Зависимость от собственного приложения

    На рисунке показан пример ограничений, описанных в описании приложения.

    На рисунке показан пример ограничений, не описанных в описаниях приложений.

  • Если ваше приложение поддерживается для определенных регионов или географических расположений, необходимо выделить зависимость этого региона в описании приложения в манифесте приложения, Центре партнеров и AppSource для этого предложения.

  • Если вам нужно ссылаться на Teams, напишите первую ссылку в списке приложений как Microsoft Teams. Последующие упоминания можно сократить до Teams. [Обязательное исправление]

    На рисунке показан пример правильной ссылки на Teams в описании приложения.

    На рисунке показан пример неправильной ссылки на Teams в описании приложения.

Краткое описание

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

Рекомендуется:

  • Сократить описание до одного предложения.
  • Сначала привести наиболее важные сведения.
  • Включить ключевые слова, которые, скорее всего, будут искать клиенты.
  • Эффективно использовать доступное ограничение символов. Например, не повторяйте название приложения.

Не рекомендуется:

[Предлагаемое исправление]

Использовать в кратком описании слово приложение.

Длинное описание

Длинное описание должно содержать привлекательное описание, в котором подчеркивается ценностное предложение вашего приложения, основная аудитория и целевая отрасль. Хотя описание может содержать до 4000 символов, рекомендуется иметь краткое описание около 1000 символов.

Рекомендуется:

  • Отформатировать описание с помощью Markdown.

  • Использовать активные формы речи и обращаться к пользователям напрямую. Например, Вы можете….

  • Перечислите ключевые преимущества, чтобы подчеркнуть преимущества использования приложения. Добавьте до трех преимуществ.

  • Добавьте ключевое ценностное предложение приложения в Teams.

  • Представить маркированный список функций, чтобы описание было легче прочитать.

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

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

  • Добавить ссылку на справку или поддержку.

  • Использовать наименование Microsoft 365 вместо Office 365.

  • При описании работы приложения с Teams (или Microsoft 365) использовать следующие выражения:

    • … работает с Microsoft Teams.
    • … работа в Microsoft Teams.
    • … в Microsoft Teams.
    • … для Microsoft Teams.
    • … интегрируется с Microsoft Teams.
    • ... создано для...
    • ... разработано для...
    • .. предназначен для...

Не рекомендуется:

[Обязательное исправление]

  • Использовать более 500 слов.

  • Сокращать Microsoft до MS или MSFT.

    На рисунке показан пример сокращения майкрософт как MS или MSFT впервые в описании приложения.

    На рисунке показан пример первого сокращения майкрософт как MS или MSFT в описании приложения.

  • Указывать, что приложение предлагается корпорации Майкрософт, в том числе путем использования слоганов или фраз Майкрософт.

    На рисунке показан пример того, как не указывать предложение Майкрософт в описании приложения.

    Рисунок, показывающий, как написать описание приложения без использования слоганов и слоганов Майкрософт.

  • Использовать следующие выражения, если вы не сертифицированный партнер корпорации Майкрософт:

    • … сертифицировано для…
    • … на платформе…
  • Включать опечатки, грамматические ошибки.

  • Неоправданно прописывать весь манифест приложения, длинное описание AppSource или содержимое приложения.

    На рисунке показан пример длинного описания приложения без ошибок.

    На рисунке показан пример длинного описания приложения с опечатками и ошибками.

  • Включать ссылки на AppSource.

    На рисунке показан пример сценария сбоя со ссылками на AppSource в подробном описании приложения.

  • Добавлять непроверенные утверждения. Например, наилучшее, главное и лучшее по рейтингу, если отсутствует источник утверждения.

  • Сравнивать ваше предложение с другими предложениями на рынке.

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

Снимки экрана

Снимки экрана позволяют заранее получить наглядное представление о приложении в дополнение к названию, значку и описаниям приложения.



Развернуть, чтобы узнать больше

Помните следующее:

  • Можно опубликовать до пяти снимков экрана на одно приложение.
  • Поддерживаются форматы PNG, JPEG и GIF.
  • Размеры должны быть 1366x768 пикселей.
  • Максимальный размер 1024 КБ.

Рекомендуется:

  • Сосредоточьтесь на возможностях приложения. Например, как пользователи могут общаться с ботом.

  • Добавить содержимое, которое точно представляет ваше приложение.

  • Разумно использовать текст.

  • С помощью цветной рамки выделять снимки экрана, которые отражают вашу фирменную символику и содержат маркетинговый контент.

  • Используйте снимки экрана с высоким разрешением, которые являются резкими и содержат разборчивый и четко читаемый текст. [Обязательное исправление]

  • По крайней мере на одном снимку экрана должна быть показана функциональность приложения на мобильных устройствах. [Обязательное исправление]

    Снимок экрана: пройденный сценарий работы приложения на мобильных устройствах.

  • Можно опубликовать до пяти снимков экрана на одно приложение. В списке приложений должно быть не менее трех и не более пяти снимков экрана. [Обязательное исправление]

  • Используйте макеты, которые точно изображают фактический пользовательский интерфейс приложения в интересах конечных пользователей. На снимках экрана должен быть точно показан фактический пользовательский интерфейс приложения или сценарии, относящиеся к приложению и связанные с ним. [Обязательное исправление]

    Снимок экрана: сбойный сценарий с дополнительным контентом, используемым на снимке экрана.

    Снимок экрана: сценарий сбоя с фактическим пользовательским интерфейсом приложения.

  • Должен изображать функциональные возможности приложения или интеграцию с Teams. [Обязательное исправление]

    Снимок экрана: сбойный сценарий с функциональностью или интеграцией приложения.

  • Предоставленные снимки экрана не должны неправильно ссылаться на Microsoft Teams как MS, MSFT или MS Teams. [Обязательное исправление]

  • Если приложение Teams расширяемо в клиентах Microsoft 365 (Microsoft 365, Outlook и Microsoft Teams), на снимках экрана должны быть показаны функции приложения в других клиентах Microsoft 365. [Обязательное исправление]

    Снимок экрана: пройденный сценарий функциональности приложения Teams в клиентах MS 365.

  • Чтобы пользователь четко понимал возможности приложения, необходимо указать субтитры на снимках экрана. [Обязательное исправление]

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

  • Если приложение поддерживает вкладки в качестве возможности, снимки экрана, показывающие приложение в контексте вкладки Teams в списке приложений, должны содержать хром команды. [Обязательное исправление]

    Снимок экрана: пройденный сценарий снимок экрана с возможностью вкладки.

Не рекомендуется:

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

    Снимок экрана: сценарий сбоя несвязанных функций приложения в Teams.

Видео

Видео в списке приложений — один из наиболее эффективных способов сообщить, почему люди должны использовать ваше приложение. Вы можете добавить URL-адрес видео YouTube или Vimeo, который предоставляет ценность вашего приложения. Кроме того, рекомендуется добавить видео, в котором представлено демонстрационное руководство или пошаговое руководство по сценарию приложения. [Предлагаемое исправление]

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

  • Видео должно быть коротким, четким, привлекательным и хорошим качеством.

  • В видео должно быть показано, как настроить и использовать приложение.

  • Видео должно быть в форме повествования.

  • Продолжительность видео должна быть в пределах 60–90 секунд для видео со значением, а рекомендуемая длительность для пошагового видео — 3–5 минут. [Предлагаемое исправление]

  • Перед отправкой видеосвязи в списке приложений необходимо отключить рекламу из параметров учетной записи YouTube или Vimeo. [Обязательное исправление]

  • В видео должны быть выделены функциональные возможности приложения и интеграция с Teams. [Обязательное исправление]

  • Видео должно быть доступно в виде функциональной ссылки. [Обязательное исправление]

  • Видео должно быть в формате https://www.example.com/123456789.

    Снимок экрана: сценарий неудачного видео, отправленного в рамках списка приложений в Центре партнеров.

  • Видео можно просмотреть в первой позиции экрана или видео карусели на страницах приложения (Магазин Teams и центр Администратор) и AppSource. [Предлагаемое исправление]

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

Дополнительные сведения о критериях для создания видео со значением приложения или пошагового видео см. в контрольном списке для создания видео.



Политика конфиденциальности

[Обязательное исправление]

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

  • Если используется общий шаблон политики конфиденциальности, добавьте ссылку на службы, приложения или платформы в области политики конфиденциальности. Вам не нужно указывать приложение Teams в область, если вы включаете ссылку на службы, приложения и платформы. Процесс проверки приложения интерпретирует эти ссылки, чтобы включить ваше приложение Teams вместе с другими службами или веб-сайтами.
  • Здесь должно быть показано, как вы производите сбор, хранение и удаление данных пользователя. Необходимо описать меры безопасности, используемые для защиты данных.
  • Обязательно включите ваши контактные данные.
  • Не включайте недействующие URL-адреса или URL-адреса для бета-версий и промежуточных версий.
  • Не следует включать ссылки на AppSource.
  • Не следует требовать проверку подлинности для доступа к политике конфиденциальности.
  • Не следует включать ссылки на пользовательский интерфейс для коммерческих целей или на магазин.
  • Должен иметь ту же ссылку в манифесте приложения и AppSource.

Условия использования

[Обязательное исправление]

Чтобы написать Условия использования, используйте следующие правила.

  • Должны быть конкретными и применимыми к вашему предложению.
  • Должны размещаться в вашем собственном домене.
  • Должны использовать безопасную (HTTPS) ссылку.
  • Для доступа к Условиям использования не должна требоваться проверка подлинности.
  • Должен иметь ту же ссылку в манифесте приложения и AppSource.

[Обязательное исправление]

URL-адреса поддержки вашего приложения не должны требовать проверки подлинности. Например, пользователям должно быть разрешено связываться с вами без входа.

Развернуть, чтобы узнать больше

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

validation-support-links-auth

Локализация

[Обязательное исправление]

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

  • Содержимое метаданных приложения должно совпадать на en-us других языках локализации. [Обязательное исправление]

  • Поддерживаемые языки должны отображаться в описании приложения AppSource. Например, это приложение доступно на языке X (X= локализованный язык). [Обязательное исправление]

  • Если параметры клиента пользователя не соответствуют ни одному из дополнительных языков, язык по умолчанию используется в качестве окончательного резервного языка. localizationInfo Обновите свойство, указав правильный язык по умолчанию, поддерживаемый приложением. [Обязательное исправление]

  • localizationInfo Обновите свойство на правильный язык по умолчанию, поддерживаемый приложением, или добавьте локализованное содержимое для манифеста приложения и длинного и краткого описания Центра партнеров. [Обязательное исправление]

Приложения, связанные с предложением SaaS

Этот раздел соответствует политике коммерческой платформы Майкрософт no 1140.5. Если вы создаете приложение Teams, связанное с предложением SaaS (программное обеспечение как услуга), убедитесь, что оно соответствует этим рекомендациям.

Общие
  • Независимые поставщики программного обеспечения должны поддерживать для нескольких пользователей (подписчиков) в одном клиенте возможность управлять собственной подпиской и назначать лицензии пользователям в клиенте.
  • Предложение должно соответствовать всем техническим требованиям к приложениям Teams, связанным с предложением SaaS.
  • Приложения Teams, связанные с предложением SaaS, должны соответствовать всем требованиям, определенным в разделе 1000. Программное обеспечение как услуга (SaaS).
  • subscriptionOffer сведения, указанные в файле манифеста приложения, должны быть правильными. В манифесте приложения добавьте или обновите узел subscriptionOffer с использованием значения publisherId.offerId. Например, если ИД издателя имеет значение contoso1234, а ИД предложения имеет значение offer01, в манифесте приложения укажите значение contoso1234.offer01.
  • Связанное предложение SaaS для приложения Teams должно находиться в AppSource, а предварительные предложения не принимаются для утверждения в Магазине Teams.

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

Домашняя страница предложения SaaS и управление лицензиями
  • Ознакомьте подписчиков с тем, как использовать продукт.

  • Разрешите подписчикам назначать лицензии.

  • Предоставьте различные способы взаимодействия с поддержкой проблем, таких как вопросы и ответы, база знаний и электронная почта.

  • Проверяйте пользователей, чтобы убедиться, что у них нет лицензии, назначенной другому пользователю.

  • Уведомляйте пользователей после назначения лицензии.

  • Руководство по добавлению приложения в Teams и началу работы с помощью чат-бота Teams или электронной почты.

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


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

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

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

Совет

Вы можете добавить видео о том, как работает управление приложениями и лицензиями, чтобы помочь команде с тестированием.

К началу страницы

Вкладки

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.2. Если приложение содержит вкладку, убедитесь, что оно соответствует этим рекомендациям.

Совет

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


Установки
  • Настройка табуляции не должна завершаться новым пользователем. Покажите сообщение о том, как завершить действие или рабочий процесс. [Обязательное исправление]

    На рисунке показан пример вкладки с тупиком при настройке.

  • Пользователь не должен покидать интерфейс настройки вкладки в Teams, чтобы создать содержимое за пределами Teams, а затем вернуться в Teams, чтобы закрепить его. Экран настройки вкладки должен описывать важность настройки и способы настройки. [Обязательное исправление]

    validation-tabs-set-up-profile-name

  • Экран настройки вкладки не должен внедрять весь веб-сайт. Сохраняйте фокус в интерфейсе настройки. Например, если вы создаете приложение управления проектами, которое позволяет пользователям настроить проект в канале, сохраняйте фокус экрана настройки вкладки на том, чтобы позволить пользователю выбрать проект из вашего приложения для настройки в канале. [Обязательное исправление]

    validation-tabs-setup-configuration-exp

    validation-tabs-set-up-configuration-screen

  • Приложения, требующие ввода URL-адреса при настройке вкладки, должны:

    • Предоставьте пользователю соответствующее руководство по получению или созданию URL-адреса. [Обязательное исправление]

    • Проверьте URL-адрес, соответствующий функциональным возможностям приложения в соответствии с описанием приложения. [Обязательное исправление]

      Снимок экрана: пример конфигурации вкладки с способом создания URL-адреса пользователем.

      Снимок экрана: пример настройки вкладки без пути вперед для создания URL-адреса пользователем.

  • Гиперссылка на контактные данные на экране конфигурации вместо обычного текста, чтобы помочь пользователям связаться с вами по вопросам поддержки. [Обязательное исправление]

  • Для простого первого запуска рекомендуется гиперссылка на URL-адрес службы поддержки или адрес электронной почты на экране конфигурации. [Предлагаемое исправление]


Представления
  • В области экрана входа не должны использоваться большие логотипы. [Обязательное исправление]

    validation-views-app-login

  • Содержимое можно упростить, разбив его на несколько вкладок.

    val-views-multiple-tabs

  • Заголовки вкладок не должны повторяться. Удалите повторяющиеся логотипы из I-фрейма, так как на платформе табуляции уже отображаются значок и имя приложения. [Предлагаемое исправление]

    На рисунке показан пример вкладки без повторяющихся заголовков и логотипов.

    На рисунке показан пример вкладки с повторяющимися заголовками и логотипами.


Навигации

Ниже представлены правила для структуры навигации.

  • Вкладки не должны предоставлять навигацию, которая конфликтует с основной навигацией Teams. Если вы предоставляете навигацию слева на вкладке, она не должна включать только значки или значки с текстом с накоплением. Он не должен быть сворачиваемой направляющей с возможностью просмотра значков с текстом с накоплением (имитируя панель навигации Teams). Добавьте значки с текстом в строке или только текстом или используйте меню гамбургера вместо вкладки слева. [Обязательное исправление]

    Разрабатывайте свое приложение с использованием базовых и расширенных компонентов пользовательского интерфейса Fluent.

    На рисунке показан пример навигации на вкладке, которая не конфликтует с основной навигацией Teams.

    На рисунке показан пример левой панели навигации, конфликтующей с основной навигацией Teams.

  • Если вкладка имеет панель инструментов на левой панели без компонента навигации, панель инструментов должна оставить интервал в 20 пикселей от левой навигации Teams. [Обязательное исправление]

    validation-nav-spacing-between-toolbar

  • Вторичные и третичные страницы на вкладке должны открываться в представлении второго уровня (L2) и третьего уровня (L3) в области вкладки main, которая осуществляется с помощью навигации с помощью навигации или навигации влево. Для навигации по вкладке также можно использовать следующие компоненты:

    • Кнопки назад

    • Заголовки страниц

    • Меню-гамбургеры

      Снимок экрана: пример диалогового окна в собрании с несколькими уровнями навигации.

  • Глубокие ссылки на вкладках не должны ссылаться на внешнюю веб-страницу, а в Teams. Например, диалоговые окна или другие вкладки. [Обязательное исправление]

    validation-nav-view-button-not-linked-static-tab

  • Вкладки не должны разрешать пользователям переходить за пределы Teams для основного интерфейса приложения. Вкладки могут перенаправлять за пределы Teams во второстепенных рабочих процессах. Например, чтобы создать запрос в службу поддержки. [Обязательное исправление]

    validation-nav-core-workflow-within-configuration

    validation-nav-core-workflow-redirects-outside

  • Горизонтальная прокрутка не должна присутствовать на вкладке собрания. [Обязательное исправление]

  • Диалоговые окна собрания, используемые в приложении, не должны разрешать горизонтальную прокрутку. Используйте диалоговые окна собрания с осторожностью и для сценариев, ориентированных на выполнение задач. Вы можете указать ширину I-кадра диалогового окна собрания в диапазоне поддерживаемых размеров, чтобы учесть различные сценарии. [Обязательное исправление]

  • Диалоговые окна, используемые в приложении, не должны разрешать горизонтальную прокрутку. Диалоговые окна позволяют выбрать различные размеры, чтобы сделать содержимое адаптивным без необходимости горизонтальной прокрутки. При необходимости можно использовать представление этапа (полноэкранный компонент пользовательского интерфейса для отображения веб-содержимого), чтобы завершить рабочий процесс без горизонтальной прокрутки. [Обязательное исправление]

  • Горизонтальная прокрутка на вкладке в личном чате, канале и на вкладке сведений о собрании в любом область запрещена, если прокручивается весь холст вкладки, если на вкладке не используется бесконечный холст с фиксированными элементами пользовательского интерфейса. [Обязательное исправление]

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

    На рисунке показан пример горизонтальной прокрутки на канбан-доске.

    На рисунке показан пример представления списка с множеством компонентов.

    На рисунке показан пример горизонтальной прокрутки на белой доске с бесконечным холстом и фиксированной доской.

    На рисунке показан пример горизонтальной прокрутки в представлении списка.

  • Пользователь должен иметь возможность перейти в предыдущее рабочее состояние. [Обязательное исправление]

     Снимок экрана: доступный параметр кнопки

    Снимок экрана: сценарий сбоя, в котором отсутствует доступный параметр кнопки

  • Горизонтальная прокрутка в адаптивных карточках не должна присутствовать в Teams. [Обязательное исправление]

  • Нижняя панель, используемая для навигации на вкладках, не должна конфликтовать с навигацией собственного мобильного приложения Teams. [Обязательное исправление]

    На рисунке показан пример вкладки, конфликтующей с навигацией по собственному мобильному приложению Teams.


Удобство использования
  • Содержимое не должно усекаться или перекрываться на вкладке. [Обязательное исправление]

    validation-usability-content-truncations

  • Пользователи должны иметь возможность отменить последнее действие на вкладке. [Обязательное исправление]

  • Вкладки в личном контексте могут собирать содержимое из общих экземпляров приложения. Например, приложение управления проектами с настраиваемой вкладкой, которая позволяет участникам канала комментировать проект на карточках канбан, должно объединять этот контент и отображаться в личном приложении. [Предлагаемое исправление]

  • Вкладки должны реагировать на темы Teams. Когда пользователь меняет тему, тема приложения должна отражать сделанный выбор. [Предлагаемое исправление]

    На рисунке показан пример вкладки, реагирующей на тему в Teams.

    На рисунке показан пример табуляции, не реагирующей на тему в Teams.

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

    Снимок экрана: пример вкладки со шрифтом Calibri вместо собственного шрифта Teams.

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

  • Вкладки должны соответствовать структуре взаимодействия с Teams, например, навигация по страницам, расположение и использование диалогов, информационные иерархии. Дополнительные сведения см. в статье Набор средств пользовательского интерфейса Microsoft Teams Fluent. [Предлагаемое исправление]

  • Возможности вкладки должны быть полностью интерактивны на мобильных устройствах (Android и iOS). [Обязательное исправление]

    Совет

    • Добавьте личный бот вместе с личной вкладкой.
    • Разрешите пользователям делиться содержимым со своей личной вкладки.
  • Вкладка не должна содержать элементы, которые полностью препятствуют или препятствуют рабочим процессам на вкладке. Например, бот внутри вкладки, которую невозможно свернуть. [Обязательное исправление]

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

  • Табуляции не должны иметь нарушенных функциональных возможностей. Ваше предложение должно быть пригодным для использования программным решением и предоставлять функциональные возможности, функции и конечные характеристики, как описано в вашем списке и других связанных материалах. [Обязательное исправление]

  • Если вкладки содержат нижний колонтитул, удалите из нижнего колонтитула все ссылки, не связанные с функциями приложения. [Обязательное исправление]


Выбор области
  • Содержимое целевой страницы настраиваемых вкладок не должно быть задано для индивидуального использования и не должно содержать личное содержимое, например "Мои задачи" или "Моя панель мониторинга". [Обязательное исправление]

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

  • После настройки на целевой странице должно отображаться совместное представление для всей команды. [Обязательное исправление]

  • Если вашему приложению требуется подготовка представления личной области для пользователя с целью повышения эффективности или производительности на рабочем месте, используйте фильтруемые представления, прямые ссылки на личные приложения или перейдите к представлениям уровня L2 или L3 в настраиваемой вкладке и сохраняйте контекст целевой страницы одинаковым для всех пользователей. [Обязательное исправление]

  • Контекст содержимого на целевой странице настраиваемых вкладок должен быть одинаковым для всех участников канала. [Обязательное исправление]

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

  • Настраиваемые вкладки должны фокусироваться на функциях. [Обязательное исправление]

    validation-usability-configurable-nested-tab


К началу страницы

Боты

Этот раздел соответствует политике коммерческой платформы Майкрософт no 1140.4.3.

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

Совет

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


Рекомендации по проектированию ботов
  • Приложение Teams должно соответствовать рекомендациям по проектированию ботов Teams.

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

  • Все неработающие ссылки, ответы или рабочие процессы в приложении должны быть исправлены. [Обязательное исправление]


Команды бота

Анализ входных данных, вводимых пользователем, и прогнозирование его намерений затруднены. Команды бота предоставляют пользователям набор слов или фраз, которые понятны боту.

  • Все команды, поддерживаемые вашим ботом, должны работать правильно, включая универсальные команды, например Привет, Здравствуйте и Справка. [Обязательное исправление]

    На рисунке показан пример реагирования бота на универсальные команды.

    На рисунке показан пример бота без ответа на универсальные команды.

  • Команды бота не должны приводить пользователя к тупику, команды всегда должны предоставлять путь вперед. [Обязательное исправление]

    validation-bot-commands-dead-end

  • Необходимо указать хотя бы одну допустимую команду бота в items.commands.title разделе манифеста приложения и добавить подходящее описание, которое даст пользователю ясность в команде бота и ее использовании. Команды бота, перечисленные в commandLists разделе манифеста приложения, отображаются как предварительно заполненные команды в меню команд бота и предоставляют возможность взаимодействия нового пользователя с ботом. [Предлагаемое исправление]

  • Ответ бота не должен содержать официальные изображения или аватары продуктов Майкрософт. Используйте собственные ресурсы в приложении. Использование образов продуктов Майкрософт в приложении запрещено. Вы можете копировать, изменять, распространять, отображать, лицензировать или продавать изображения продуктов Корпорации Майкрософт, защищенные авторским правом, только если вам предоставлено явное разрешение в рамках лицензионного соглашения End-User , лицензионных условий, сопровождающих содержимое, или в соответствии с правилами корпорации Майкрософт по товарным знакам и торговой марке. [Обязательное исправление]

  • Боты должны отвечать на команды пользователя без отображения индикатора непрерывной загрузки. [Обязательное исправление]

  • Ответ команды справки бота не должен перенаправлять пользователя за пределы Teams. Ответ команды справки бота может перенаправлять пользователя на холст в приложении Teams или предоставлять путь к ответу в адаптивной карточке. [Обязательное исправление]

    На рисунке показан пример ответа бота, перенаправляющего пользователя за пределы Teams.

  • Боты всегда должны предоставлять допустимый ответ на входные данные пользователя, даже если входные данные не имеют значения или неправильные. [Обязательное исправление]

    На рисунке показан пример допустимого ответа на неправильную команду бота.

    На рисунке показан пример недопустимого ответа на неправильную команду бота.

  • Специальные символы, такие как косая черта (/), не должны быть префиксами команд бота. [Обязательное исправление]

    На рисунке показан пример сценария сбоя, в котором специальные символы префиксируются в командах бота.

  • Боты должны предоставлять допустимый ответ на недопустимые команды пользователя. Боты не должны отключать пользователя или отображать ошибку, если пользователь отправляет недопустимую команду бота. [Обязательное исправление]

    На рисунке показан пример бота, предоставляющего путь вперед для недопустимой команды.

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

  • Функциональность бота должна соответствовать область, в которой установлен бот, и он должен указать значение в установленной область. [Обязательное исправление]

  • Боты не должны содержать повторяющиеся команды. [Обязательное исправление]

  • Боты не должны отображать индикатор ввода после ответа на команду пользователя, но могут отображать индикатор ввода при ответе на команду пользователя. [Обязательное исправление]

  • Боты должны предоставить допустимый ответ на команду справки , введенную в нижнем или верхнем регистре, которая предоставляет пользователю путь вперед или позволяет пользователю получить доступ к содержимому справки, связанному с использованием бота. Боты должны предоставить допустимый ответ, даже если пользователь не вошел в приложение. [Обязательное исправление]

    На рисунке показан пример того, как бот не предоставляет допустимый ответ для команды в нижнем или верхнем регистре.

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

  • Боты должны предоставить допустимый ответ на команду help .

    На рисунке показан пример бота, отправляющего допустимый ответ на команду help.

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

    На рисунке показан пример сообщения бота без усечения на мобильных устройствах.

    На рисунке показан пример усечения сообщения бота на мобильных устройствах.

  • Все ссылки в адаптивном карта ответа бота должны быть адаптивными. Любая ссылка, которая выводит пользователя за пределы платформы Teams, должна содержать четкий текст перенаправления, например View in.. or This way to.., всплывающее значок в кнопке действия ответа бота или иметь подходящий текст перенаправления в тексте сообщения ответа бота. [Обязательное исправление]

    На рисунке показан пример кнопки реагирования бота с перенаправлением.

  • Если ваш бот не отвечает или не поддерживает какие-либо команды пользователя и является односторонним ботом, предназначенным только для уведомления пользователей. В манифесте приложения необходимо задать isNotificationOnly значение true. [Обязательное исправление]

    На рисунке показан пример свойства только для уведомлений, для параметра true в манифесте приложения.

    На рисунке показан пример уведомления только бота, который не отвечает на сообщение пользователя.

  • Взаимодействие с ботом не должно быть нарушено на мобильных платформах. Бот должен полностью реагировать на мобильных устройствах. [Обязательное исправление]

Совет

Для личных ботов добавьте вкладку Справка, на которой подробнее описывается, что может сделать ваш бот.


Приветственные сообщения бота
  • Если приложение использует сложный поток настройки (требуется корпоративная лицензия или отсутствует интуитивно понятный поток регистрации), боты в таких приложениях всегда должны отправлять приветствие во время первого запуска.

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

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

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

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

    validation-bot-welcome-message-not-trigger

    validation-bot-wel-message-trigger

  • Боты с уведомлениями должны отправлять приветственное сообщение, в которое указывается, что бот является ботом только для уведомлений, и пользователи не смогут взаимодействовать с ботом. [Обязательное исправление]

    На рисунке показан пример бота, отправляющего приветственное сообщение о том, что это только бот с уведомлениями.

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

    На рисунке показан пример сценария сбоя, в котором бот не имеет пути вперед для пользователя в приветственном сообщении.

    На рисунке показан пример приветственного сообщения бота с четким способом выполнения задачи.

  • Бот, установленный в канале или групповом чате, область не должен отправлять упреждающее приветственное сообщение всем участникам команды в чате 1:1. [Обязательное исправление]

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

  • Бот с уведомлениями может отправлять упреждающее приветственное сообщение в канале, только если оно содержит важную информацию для любого пользователя, чтобы завершить настройку бота или прояснить сценарии активации уведомлений. [Обязательное исправление]

  • Бот, установленный в канале или групповом чате, область не должен отправлять упреждающие сообщения (а не только приветственное сообщение), которые не имеют значения для всех пользователей в канале или групповом чате. Вместо этого он должен отправлять упреждающие сообщения пользователю в чате 1:1. [Обязательное исправление]

  • Бот, установленный в канале или групповом чате, область не должен разрешать пользователям запускать отдельные рабочие процессы. Боты должны выполнять отдельные рабочие процессы в чате 1:1 с пользователем. [Обязательное исправление]

  • Приветственное сообщение бота должно четко обозначить ограничения, связанные с использованием бота в установленной область. [Обязательное исправление]

    На рисунке показан пример ограничения приложения в приветственном сообщении бота.

    На рисунке показан пример бота без ограничений приложения в приветственном сообщении.

  • Приветственное сообщение должно автоматически активироваться при установке приложения в личной область. Если бот не отправляет приветственное сообщение в личной область, пользователь заведет в тупик. Если приложение не включает сложный рабочий процесс настройки, разработчик может активировать приветственное сообщение в канале или групповом чате область. [Обязательное исправление]

    На рисунке показан пример того, как бот не отправляет приветственное сообщение автоматически в личных область.

  • Приветственные сообщения должны запускаться только один раз при установке бота. Приветственные сообщения не должны запускаться каждый раз, когда пользователь вызывает команду справки. Ответ команды справки должен быть ориентирован на включение способа доступа пользователя к справке, связанной с ботом. [Обязательное исправление]

  • Приветственные сообщения не должны запускаться с каждой командой бота. Это считается спамом. [Обязательное исправление]

    На рисунке показан пример запуска ботом приветственного сообщения для любой команды.

  • Содержимое приветственного сообщения должно быть связано с рабочим процессом бота, указанным в длинном описании приложения, и область установки. Приветственное сообщение должно содержать значение, предлагаемое ботом пользователям, которые установили бот в канале, инструкции по настройке бота и краткое описание всех поддерживаемых команд бота. [Обязательное исправление]

  • Бот не должен отправлять несколько приветственных сообщений при активации при установке приложения. [Обязательное исправление]

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

  • Имя приложения в приветственном сообщении должно соответствовать имени приложения в манифесте приложения. [Обязательное исправление]

    На рисунке показан пример имени приложения в приветственном сообщении, которое не совпадает с именем приложения в манифесте приложения.

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

  • Приветственное сообщение не должно перенаправлять пользователя в другое приложение Teams, вместо этого приветственное сообщение должно подталкивать пользователя к выполнению первой задачи и кратко описывать все поддерживаемые команды бота в приложении. [Обязательное исправление]

  • Приветственное сообщение не должно содержать ссылки на какие-либо приложения Marketplace, включая AppSource. [Обязательное исправление]

  • Если в вашем приложении есть сложный рабочий процесс настройки, который требует установки под руководством администратора, не имеет интуитивно понятного и удобного потока регистрации или требует от пользователей выполнить действия по настройке вне интерфейса Teams и вернуться, бот должен отправить упреждающее приветственное сообщение в команде или групповом чате область после установки. [Обязательное исправление]

  • Если бот отправляет приветственное сообщение в канале, он не должен отправлять его пользователям по отдельности (это считается спамом). Приветственное сообщение также должно упоминание пользователя, который добавил бота. [Предлагаемое исправление]

Совет

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


Спам сообщений бота

Боты не должны спамить пользователей, отправляя несколько сообщений в течение короткого времени.

  • Сообщения бота в каналах и чатах: создание отдельных записей может быть расценено как спам. Создайте одну запись с ответами в той же беседе. [Обязательное исправление]

    validation-bot-message-spam-one-message

    validation-bot-message-spam-multiple-message

  • Сообщения бота в личных приложениях:

    • Не отправляйте несколько сообщений в быстрой последовательности. [Обязательное исправление]

      На рисунке показан пример быстрой отправки нескольких сообщений ботом.

    • Вместо этого отправьте одно сообщение со всей информацией. [Обязательное исправление]

    • Старайтесь избегать продолжительных бесед для выполнения одного повторяющегося рабочего процесса. [Обязательное исправление]

    • Используйте форму (или диалоговое окно) для одновременного сбора всех входных данных от пользователя. [Обязательное исправление]

    • Чат-боты для бесед на основе NLP могут использовать продолжительные беседы, чтобы сделать обсуждение более интересным и завершить рабочий процесс.

      validation-bot-message-using-task-module

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

  • Приветствия: не повторяйте одно и то же приветствие через регулярные промежутки времени. Например, при включении нового участника в команду не следует рассылать приветствие другим участникам. Отправьте персональное сообщение новичку. [Обязательное исправление]


Уведомления бота

Содержимое уведомлений бота должно соответствовать области применения этого бота (бот команды, чат-бот или личный бот). [Обязательное исправление]

validation-bot-notification-relevant

validation-bot-notification-not-relevant


Боты и адаптивные карточки

Адаптивные карточки — это рекомендуемый способ отображения сообщений ботов. Карточки должны быть небольшими и содержать не более шести действий. Чтобы отобразить больше содержимого, рекомендуется использовать диалоговое окно или вкладку.

Дополнительные сведения о карточках:

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


Боты с уведомлениями

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

Совет

Предварительный просмотр сведений и предоставление основных действий пользователя в размещенном карта, чтобы пользователю не требовалось переходить за пределы Teams для всех действий (независимо от сложности).


Сведения о метаданных бота
  • Сведения о боте в манифесте приложения (имя бота, логотип, ссылка на конфиденциальность и условия обслуживания) должны соответствовать метаданным Bot Framework. [Обязательное исправление]

  • Убедитесь, что идентификатор бота в манифесте приложения совпадает с идентификатором бота в последней опубликованной версии приложения в Магазине Teams. Изменение идентификаторов ботов в обновлении приложения приводит к окончательной потере всего журнала взаимодействия пользователей с ботом для существующих пользователей приложения и запуск новой цепочки бесед с новым идентификатором бота. [Обязательное исправление]

  • Все изменения в имени приложения, метаданных, приветственном сообщении бота или ответах бота должны быть обновлены с помощью нового имени. [Обязательное исправление]

  • Имя приложения в приветственном сообщении бота или ответы бота должно соответствовать имени приложения в манифесте приложения. [Обязательное исправление]


Бот в совместной область
  • Установка бота в канале или групповом чате область для получения списка команд для отправки упреждающих уведомлений для пользователей, так как чаты 1:1 для триггеров конкретной команды не разрешены. Например, приложение, которое связывает людей для встречи. [Обязательное исправление]

  • Бот в канале или групповом чате, используемый только для получения сообщений или записей для отправки упреждающих уведомлений для пользователей, так как чаты 1:1 запрещены. [Обязательное исправление]

  • Боты, установленные в область для совместной работы, должны предоставлять ценность пользователя в область совместной работы. [Обязательное исправление]

К началу страницы

Расширения для обмена сообщениями

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.4.

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

Совет

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


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

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

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

  • Предварительный просмотр изображений в адаптивных карточках в расширениях для обмена сообщениями должен загружаться должным образом. [Обязательное исправление]

    На рисунке показан пример загрузки изображения предварительного просмотра в адаптивном карта.

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

  • Ответ расширения сообщений карта должен включать значок приложения, чтобы избежать путаницы пользователей. [Обязательное исправление]

  • В приложении не должно быть нарушенных функциональных возможностей. Приложение не должно быть взаимоблокировкой или блокировать выполнение пользователем рабочего процесса в расширении обмена сообщениями. [Обязательное исправление]

  • Расширения обмена сообщениями должны отвечать на запросы или работать так, как предполагалось в области группового чата и канала. [Обязательное исправление]

  • Необходимо включить способ входа или выхода из расширения для обмена сообщениями. [Обязательное исправление]

  • Расширения сообщений, использующие URL-адреса OpenAPI, не должны обеспечивать перенаправление при вызове API. Фактические вызовы API должны обслуживаться из того же домена или поддомена корневого домена.


Команды действий для расширений сообщений на основе действий

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

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

    validation-messaging-extension-no-intermediate-steps

    validation-messaging-extension-intermediate-steps-available

  • Передавать контекст сообщения на следующий этап работы. [Обязательное исправление]

    validation-messaging-extension-app-passes-messages

    validation-messaging-extension-app-doesnot-pass-messages

  • Добавьте название ведущего приложения вместо универсального глагола для команд действий, запускаемых из сообщения чата, публикации канала или призыва к действию в приложениях. Например, используйте команду Начать собрание Skype для запуска собрания, Отправить файл в DocuSign для отправки файла. [Предлагаемое исправление]

    На рисунке показан пример имени ведущего приложения для команды действия.

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

  • Вызов действия сообщения должен позволить пользователю завершить рабочий процесс. Ошибки, пустые ответы или индикаторы непрерывной загрузки, чтобы сделать действие сообщения функциональным по назначению, не должно присутствовать. [Обязательное исправление]

    На рисунке показан пример индикатора непрерывной загрузки, когда бот вызывает команду действия.

  • Повторяющиеся команды действий не должны присутствовать. [Обязательное исправление]

  • Действия с сообщениями должны позволить пользователю завершить рабочий процесс по назначению без недопустимого ответа. [Обязательное исправление]

  • Приложения с расширением обмена сообщениями только на основе действий должны иметь следующее конечное состояние:

    • Опубликуйте соответствующее действие в виде уведомления либо в контексте, где вызывается расширение сообщений, либо в чате бота 1:1 на основе пользовательского сценария. [Обязательное исправление]

    • Разрешить пользователям делиться карточками с другими пользователями на основе выполненных действий. Это позволяет гарантировать, что приложения не выполняют автоматические действия. Например, билет создается на основе сообщения в канале, но приложение не отправляет уведомление или не предоставляет способ запросить у пользователя общий доступ к сведениям о билете после создания билета. [Обязательное исправление]


Предварительный просмотр ссылок (распаковка ссылок)

[Обязательное исправление]

  • Если приложение объявило supportsAnonymizedPayloads свойство в манифесте приложения, а пользователь не установил приложение, ссылка на приложение должна быть развёрнута и отображать диалоговое окно добавления приложения после выбора карта. [Обязательное исправление]

  • Расширения для сообщений должны показывать содержимое распознанных ссылок в окне создания сообщения Teams. Не добавляйте домены, которыми вы не управляете (абсолютные URL-адреса или адреса со знаками подстановки). Например, yourapp.onmicrosoft.com допустимо, а *.onmicrosoft.com не допускается. Домены верхнего уровня также запрещены. Например, *.com или *.org. [Обязательное исправление]

  • Приложения должны объявлять только те, которые находятся в непосредственной собственности издателя приложения в messageHandler разделе распаковки ссылки манифеста приложения. Он не должен содержать *.botframework.com. [обязательное исправление]


Команды поиска
  • Расширения для сообщений на основе поиска должны предлагать текст, который помогает пользователям эффективно выполнять поиск. [Обязательное исправление]

    На рисунке показан пример расширения сообщения с текстом справки для эффективного поиска.

    На рисунке показан пример расширения сообщения без текста справки для эффективного поиска.

  • @mention Исполняемые файлы должны быть понятными, понятными и читаемыми.

    validation-search-commands-unclear-executable

К началу страницы

Диалоги

[Обязательное исправление]

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.5.

Развернуть, чтобы узнать больше

Диалоговое окно (называемое модулем задач в TeamsJS версии 1.x) должно содержать значок и краткое имя приложения, с которым он связан. Диалоговые окна не должны внедрять все приложение и отображать только компоненты, необходимые для выполнения определенного действия.

Дополнительные сведения см. в разделе Рекомендации по проектированию диалоговых окон Teams.

validation-task-module-displays-component

validation-task-module-embed-app

Совет

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

К началу страницы

Расширения для собраний

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.6.

Совет

Дополнительные сведения о создании высококачественного интерфейса приложения см. в правилах разработки расширений для собраний Teams.


Рекомендации по проектированию расширений собраний
  • Приложения Teams должны следовать рекомендациям по проектированию расширений для собраний.

  • Благодаря работе с приложением для собраний вы можете привлекать участников во время собрания с помощью вкладок в собрании, диалогового окна и функции общего доступа к собранию. Если приложение поддерживает расширение для собраний Teams, необходимо обеспечить адаптивный интерфейс собрания в соответствии с интерфейсом собраний Teams. [Обязательное исправление]

  • Приложения для расширения собраний должны обеспечивать адаптивный интерфейс собрания, соответствующий взаимодействию с собраниями Teams. Интерфейс собрания является обязательным для приложения Teams, которое поддерживает расширяемость собраний, но интерфейсы до и после собрания не являются обязательными. [Обязательное исправление]

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

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

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

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

  • Ваше приложение должно предлагать ценность помимо предоставления только пользовательских сцен в режиме "Вместе" в Teams. [Обязательное исправление]

  • Необходимо объявить groupChat как область в configurableTabs и meetingDetailsTab, meetingChatTabи meetingSidePanel как свойство контекста в манифесте приложения, чтобы включить приложение для собраний на мобильных устройствах Teams. [Обязательное исправление]

  • Холсты собрания не должны завершать участников собрания. На холстах собраний должно отображаться корректное сообщение об ошибке для ограничений приложений, таких как зависимость для конкретного региона. [Обязательное исправление]

  • В заголовке холста собрания должно отображаться правильное имя приложения, чтобы не запутать участника собрания. [Обязательное исправление]

  • Необходимо включить параметр для пользователя, чтобы выйти из расширения собрания или выйти из него. [Обязательное исправление]

  • Вкладки собрания на мобильных платформах должны содержать соответствующие рабочие процессы. Пустые страницы не должны присутствовать на вкладке собрания. [Обязательное исправление]

  • Этап собрания — это сфокусированный, интуитивно понятный и совместный холст для участия. Этап собрания не должен внедрять полный интерфейс веб-сайта. [Обязательное исправление]

  • Приложение не должно отображать экран непрерывной загрузки, ошибку или неработающую функциональность, которая завершает работу пользователя или блокирует завершение рабочего процесса в сценарии собрания. [Обязательное исправление]

    На рисунке показан пример экрана непрерывной загрузки в приложении.

  • Приложение не должно открывать новый экземпляр Teams при запуске собрания. Холсты собраний — это расширение возможностей Teams, которые способствуют совместной работе в режиме реального времени, а новые собрания всегда должны открываться в активном экземпляре Teams. [Обязательное исправление]

  • Приложения для собраний должны выполнять рабочие процессы на платформе Microsoft Teams без перенаправления на платформу на основе чатов конкурентов. [Обязательное исправление]

    На рисунке показан пример приложения, перенаправляющегося на платформу на основе чата конкурентов.

  • Если приложение поддерживает представления на основе ролей и некоторые рабочие процессы недоступны для всех участников, рекомендуется реализовать надлежащий обмен сообщениями для участников на вкладке и боковой панели, указав, что приложение предназначено для просмотра организатора, а также предоставить сведения о том, как участники получают заметки о собрании, элементы действий и повестки дня обновления. [Обязательное исправление]

    На рисунке показан пример приложения без пути вперед для участников в представлении на основе ролей.


Интерфейс перед собранием и после собрания
  • Для экранов до собрания и после собрания следует придерживаться общих правил по разработке вкладок. Дополнительные сведения см. в правилах разработки Teams. [Обязательное исправление]

  • Вкладки должны иметь упорядоченную структуру с отображением нескольких элементов. Например, при наличии более 10 опросов см. пример макета. [Обязательное исправление]

  • При экспорте результатов опроса приложение должно уведомлять пользователей, например сообщением Результаты успешно скачаны. [Обязательное исправление]

    На рисунке показан пример того, как вкладка не выполняет рекомендации по проектированию вкладок.


Взаимодействие с участниками собрания
  • Во время собраний приложения должны использовать только темную тему. Дополнительные сведения см. в правилах разработки Teams. [Обязательное исправление]

  • При наведении курсора на значок приложения во время собраний должна отображаться подсказка с названием приложения. [Обязательное исправление]

    validation-in-meeting-exp-display-app-names

  • Расширения для сообщений должны одинаково работать как во время собраний, так и за их рамками. [Обязательное исправление]


Вкладки собрания
  • Вкладка должна быстро реагировать. [Обязательное исправление]

  • Должны сохраняться размеры полей и компонентов. [Обязательное исправление]

  • Если на вкладке несколько уровней навигации, должна быть кнопка "Назад". [Обязательное исправление]

    На рисунке показан пример присутствующих кнопки

    На рисунке показан пример отсутствующей кнопки

  • На вкладке должно быть не более одной кнопки закрытия. Это может сбить пользователей с толку, так как уже есть встроенная кнопка заголовка для закрытия вкладки. [Обязательное исправление]

  • Не должен иметь горизонтальную прокрутку. [Обязательное исправление]

    На рисунке показан пример вкладки в собрании с вертикальной прокруткой.

    На рисунке показан пример вкладки


Диалоговые окна в собрании
  • Должны использоваться ограниченно и только в несложных и ориентированных на задачу сценариях. [Обязательное исправление]

  • Должны отображать содержимое в одном столбце и не иметь нескольких уровней навигации. [Обязательное исправление]

    На рисунке показан пример макета одного столбца для диалогового окна собрания.

    На рисунке показан пример макетов нескольких столбцов для диалогового окна собрания.

  • Не должны использовать диалоговые окна. [Обязательное исправление]

  • Должны находиться в центре сцены собрания. [Обязательное исправление]

    На рисунке показан пример диалога в собрании, не совпадающего с центром этапа собрания.

  • Должны закрываться, когда пользователь нажимает кнопку или выполняет действие. [Обязательное исправление]

  • Режим "Вместе": убедитесь, что вы учитываете следующие рекомендации для создания сцены: [Обязательное исправление]

    • Все изображения имеют формат PNG.
    • Окончательный пакет со всеми изображениями не должен превышать разрешение 1920x1080. Разрешение — это четное число. Это разрешение является требованием для успешного отображения сцен.
    • Максимальный размер сцены — 10 МБ.
    • Максимальный размер каждого изображения — 5 МБ. Сцена — это коллекция из нескольких изображений. Ограничение применяется для каждого отдельного изображения.
    • Выберите параметр Прозрачный при необходимости. Этот флажок доступен на правой панели при выборе изображения. Перекрывающиеся изображения должны быть помечены как прозрачные, чтобы указать, что это перекрывающиеся изображения сцены.

Этап общего собрания

Чтобы использовать API shareAppContentToStage , необходимо объявить правильные разрешения RSC. В манифесте приложения необходимо настроить authorization свойство . Обновите свойство как nameMeetingStage.Write.Chat и type свойство как Delegated в resourceSpecific поле . [Обязательное исправление]

Функцию общей сцены собрания можно запустить только в классическом приложении Teams. Однако возможность использования общей сцены собрания должна поддерживаться и работать при просмотре на мобильных устройствах. [Обязательное исправление]

К началу страницы

Connector

  1. Имя соединителя должно совпадать с именем приложения в приложении и манифесте приложения.

    Снимок экрана: несоответствие имени приложения между приложением и манифестом приложения.

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

    Снимок экрана: ошибка при настройке соединителя пользователем.

Уведомления

Этот раздел соответствует политике Коммерческой платформы Майкрософт no 1140.4.7.

Если приложение использует API веб-канала действий, предоставляемые Microsoft Graph, убедитесь, что оно соответствует приведенным ниже рекомендациям.

Совет

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



Рекомендации по проектированию уведомлений
  • Приложения Teams должны соответствовать рекомендациям по проектированию уведомлений веб-канала действий.

  • Нерелевантный, неправильный, не отвечающий или неработающий рабочий процесс не должен присутствовать после выбора пользователем уведомления в веб-канале действий Teams. Пользователи не должны быть заблокированы для завершения рабочего процесса после выбора уведомления веб-канала действий. [Обязательное исправление]

  • Добавьте имя приложения в уведомление веб-канала действий, чтобы конечные пользователи понимали источник или триггер уведомления без путаницы. [Обязательное исправление]

  • Приложение должно активировать уведомления для всех сценариев уведомлений, упомянутых в подробном описании приложения, интерфейсе первого запуска приложения и в сценариях, объявленных activityTypes в манифесте приложения. [Обязательное исправление]

  • Уведомления должны отображаться в течение пяти секунд после действий пользователя. [Обязательное исправление]

  • Вы должны указывать ограничения уведомлений (если таковые есть) в длинном описании приложения или при первом запуске приложения. [Обязательное исправление]


Общие
  • Все триггеры уведомлений, указанные в конфигурации приложения, должны работать. [Обязательное исправление]
  • Уведомления должны быть переведены на поддерживаемые языки, настроенные для вашего приложения. [Обязательное исправление]
  • Уведомления должны отображаться в течение пяти секунд после действий пользователя. [Обязательное исправление]
  • Уведомления должны быть локализованы в соответствии с поддерживаемыми языками для всех платформ, на которых совместимо ваше приложение. [Обязательное исправление]

Аватары
  • Аватар уведомления должен соответствовать цветному значку вашего приложения. [Обязательное исправление]
  • Уведомления, запускаемые пользователем, должны включать аватар пользователя. [Обязательное исправление]

Спам
  • Приложения не должны отправлять пользователю более 10 уведомлений в минуту. [Обязательное исправление]
  • Боты и веб-канал действий не должны запускать повторяющиеся уведомления. [Обязательное исправление]
  • Уведомления должны быть полезными для пользователей и не использоваться для тривиальных или неактуальных событий. [Обязательное исправление]

Навигация и макет
  • Уведомления должны соответствовать структуре и порядку работы ленты новостей Teams. [Обязательное исправление]
  • Когда пользователь выбирает уведомление, он должен направляться на соответствующее содержимое в пределах Teams. [Обязательное исправление]

К началу страницы

Программа соответствия приложений Microsoft 365 требованиям

Этот раздел соответствует политике коммерческой платформы Майкрософт no 1140.6.

Развернуть, чтобы узнать больше

Программа соответствия приложения Microsoft 365 требованиям предназначена для того, чтобы помочь организациям оценивать риски и управлять ими, анализируя сведения о безопасности и соответствии требованиям для вашего приложения. Если вы публикуете приложение в Магазине Teams, необходимо выполнить следующие уровни программы:

  • Проверка издателя: помогает администраторам и конечным пользователям убедиться в подлинности разработчиков приложений, интегрированных с платформой удостоверений Майкрософт. По завершении в диалоговом окне согласия Microsoft Entra и на других экранах отображается синяя проверенная эмблема. Дополнительные сведения см. в статье Добавление для приложения метки "Проверенный издатель". [Обязательное исправление]

    На рисунке показан пример синего проверенного значка в диалоговом окне согласия Microsoft Entra.

  • Аттестация издателя: процесс, в ходе которого вы делитесь общими сведениями, сведениями об обработке данных, безопасности и соответствии нормативным требованиям, чтобы помочь потенциальным клиентам принять обоснованное решение об использовании вашего приложения. [Предлагаемое исправление]

Для приложения, которое не указано ранее, вы не сможете пройти аттестацию издателя, пока оно не будет доступно в Магазине Teams. Если вы обновляете уже указанное приложение, выполните аттестацию издателя перед отправкой последней версии приложения.

К началу страницы

Реклама

Этот раздел соответствует политике коммерческой платформы Майкрософт №1140.7.

Приложения не должны отображать рекламу, включая динамическую рекламу, баннерную рекламу и рекламу в сообщении. [Обязательное исправление]

На рисунке показан пример неудачного сценария рекламы в Teams.

К началу страницы

Приложения на основе криптовалют

Вы должны продемонстрировать соответствие всем законам, в которых распространяется приложение, если ваше приложение: [Обязательное исправление]

  • Упрощает транзакции или передачу криптовалют в приложении.

  • Рекламирует содержимое, связанное с криптовалютой.

  • Позволяет пользователям хранить хранимую криптовалюту или получать доступ к ней.

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

  • Поощряет или облегчает добычу криптовалютных токенов.

  • Упрощает участие пользователей в первоначальных предложениях монет.

  • Вознаграждает или поощряет пользователей криптовалютными токенами для выполнения задачи.

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

К началу страницы

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

  • Рабочие процессы или содержимое в приложении должны быть связаны с область. [Обязательное исправление]
  • Все возможности приложения должны быть функциональными и правильно работать, как описано в подробном описании AppSource или манифеста приложения. [Обязательное исправление]
  • Приложения должны всегда уведомлять пользователя перед скачиванием любого файла или исполняемого файла в среде пользователя. Любой призыв к действию (CTA), основанный на тексте или иным образом, который дает пользователю понять, что файл или исполняемый файл скачиваются в действии пользователя, разрешен в приложении. [Обязательное исправление]
  • Приложения с зависимостью от региона должны уведомлять пользователей об ошибке во всех применимых возможностях, если они пытаются использовать его в неподдерживаемом регионе. [Обязательное исправление]

К началу страницы

Мобильные устройства

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

    На рисунке показан пример мобильной надстройки, запрашивающей оплату.

  • Использование слов "БЕСПЛАТНО", "БЕСПЛАТНАЯ ПРОБНАЯ ВЕРСИЯ" или "ПОПРОБОВАТЬ БЕСПЛАТНО" разрешено на рабочем столе или в веб-приложении без каких-либо ограничений или соображений.

  • Использование слова FREE в качестве обычного текста в контексте пробной версии или обновления приложения разрешено на мобильных устройствах.

  • Использование слова FREE в контексте пробной версии или обновления приложения со ссылкой, которая ведет к целевой странице без сведений об оплате или ценах, разрешено на мобильных устройствах. Обычный текст для сигнала о том, что приложение ПЛАТНОЕ разрешено на мобильных устройствах.

  • Использование слова FREE в качестве обычного текста в контексте пробной версии или обновления приложения, связанного с сведениями о ценах, не допускается на мобильных устройствах. [Обязательное исправление]

  • Использование слова FREE в контексте пробной версии или обновления приложения и связанной со ссылкой, которая ведет к целевой странице со сведениями о ценах или платежными данными на мобильных устройствах, запрещено. [Обязательное исправление]

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

    На рисунке показан пример сведений о ценах на мобильных устройствах.

  • Платежи для цифровых товаров в приложении не разрешено на мобильных устройствах. [Обязательное исправление]

    На рисунке показан пример оплаты цифровых товаров на мобильных устройствах.

  • Приложения Teams должны предоставлять соответствующие мобильные возможности для нескольких устройств. [Обязательное исправление]

  • Возможности, которые не поддерживаются на мобильных устройствах, не должны быть недоступными для пользователя и должны предоставлять корректное сообщение о сбое, если это применимо. [Обязательное исправление]

К началу страницы

Приложения, доступные для клиентов Microsoft 365

Общие

  • Приложения, предназначенные для расширения приложений Teams в клиентах Microsoft 365, должны использовать схему версии 1.13 или более поздней.

  • URL-адрес поддержки вашего приложения должен содержать содержимое, относящегося к приложению Teams, расширяемого по всем клиентам Microsoft 365, и не должен вызывать только один клиент.

  • В описании приложения Необходимо указать соответствующую ссылку на приложение Teams, расширяемое для клиентов Microsoft 365.

  • Если приложение Teams расширяемо в клиентах Microsoft 365, содержимое, предоставляемое в разделе Начало работы, вход, регистрация, выход, страницы справки или пересылка сообщений, должно вызывать все клиенты.

Совместимость

Приложения Teams, расширяемые в клиентах Microsoft 365, должны быть полностью адаптивными и функциональными в последних версиях клиентов Microsoft Edge и Google Chrome. Пользователь должен иметь возможность вызывать и продолжать использовать личные вкладки или расширения сообщений на следующих устройствах:

  • Outlook для Windows и Интернета.
  • Microsoft 365 на компьютере, в Интернете и Android.
  • Microsoft Teams на настольных компьютерах и в Интернете.
  • Microsoft Teams для Android и iOS.

Мобильные устройства

Пользователи должны иметь возможность запускать приложение из всплывающего меню действий в клиенте Microsoft 365 на мобильных устройствах. Имя приложения должно отображаться правильно на панели действий. [Обязательное исправление]

Запуск приложения из всплывающего меню действий

Пользователи должны иметь возможность успешно запускать и переключаться между несколькими статическими вкладками в клиенте Microsoft 365 на мобильных устройствах. Вкладки должны загружаться должным образом. Если статических вкладок больше трех, остальные вкладки должны быть видны в разделе Дополнительно . [Обязательное исправление]

Интерфейс с несколькими вкладками

Если приложение использует единый вход, оно должно успешно пройти проверку подлинности пользователя. Единый вход позволяет пользователям выполнять вход с помощью одного набора учетных данных в несколько независимых программных систем. Пользователи могут получить доступ ко всем необходимым приложениям без использования разных учетных данных для проверки подлинности. [Обязательное исправление]

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

Приложение должно завершить работу экземпляра учетной записи пользователя, когда пользователь переключился или вышел из него в клиенте Microsoft 365 на мобильном устройстве. [Обязательное исправление]

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

  • Пользователи должны иметь возможность вернуться в предыдущее рабочее состояние. Если пользователь находится на корневой странице, обратная навигация должна завершить экземпляр приложения в клиенте Microsoft 365 на мобильном устройстве. [Обязательное исправление]

  • Приложения, поддерживающие прямую связь с рабочим процессом, должны иметь возможность перенаправлять пользователя на соответствующую целевую страницу. [Обязательное исправление]

Навигация по вкладкам

  • Индикатор хода выполнения должен отображаться при загрузке приложения и автоматически закрывать его после загрузки приложения. [Обязательное исправление]

  • Экран ошибки должен отображаться, когда приложение не загружается в таких экземплярах, как некогерентная или неисправная сеть, время ожидания или сбой проверки подлинности и т. д. [Обязательное исправление]

К началу страницы

Приложения Teams, расширяемые в виде подключаемого модуля для Microsoft Copilot для Microsoft 365

Подключаемый модуль не должен управлять поведением LLM

Краткие описания приложения, параметра и команды не должны содержать следующее:

  1. Инструктивные фразы. Например, если пользователь произнесет X, игнорировать, удалять, сбрасывать, новые инструкции, отвечать полужирным шрифтом или ничего не выводить.
  2. Подробный, цветочный или маркетинговый язык.
  3. Превосходные утверждения, такие как #1, удивительные или лучшие.
  4. URL-адреса, эмодзи или скрытые символы, такие как шестнадцатеричные, двоичные или нетрадиционные символы.
  5. Грамматические ошибки и ошибки препинания.

Осведомленность пользователей

В длинном описании приложения должно быть четко описано следующее:

  • Совместимость приложения с Copilot. Например, используйте Contoso в Copilot для поиска и подведения итогов по задачам.

  • Предоставьте хотя бы один запрос на использование подключаемым модулем расширения сообщений в Copilot. Например, каковы билеты с высоким приоритетом, назначенные мне на этой неделе в Contoso.

    Снимок экрана: сценарий прохода с примером запроса на использование расширения сообщений в качестве подключаемого модуля в Copilot.

    Снимок экрана: сценарий сбоя без примера запроса на использование расширения сообщений в качестве подключаемого модуля в Copilot.

Качество отклика

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

    Снимок экрана: пример приложения, на котором показано, Microsoft 365 Chat ответ приложения содержит предварительный просмотр и содержимое в одном ответе.

  • Адаптивные карточки в Microsoft 365 Chat ответе должны иметь по крайней мере одну кнопку действия.

  • Кнопки действий, присутствующие в Microsoft 365 Chat адаптивных карточек ответа, должны быть функциональными.

    Снимок экрана: пример заголовка сведений, дополнительных полей пользователей и кнопки действия в ответе адаптивной карточки.

  • Microsoft 365 Chat должны реагировать точно и не отображать ошибку, когда пользователь запрашивает один параметр.

  • Microsoft 365 Chat должны реагировать точно и не показывать ошибку, когда пользователь запрашивает несколько параметров.

  • Microsoft 365 Chat должны реагировать точно и не показывать ошибку, когда пользователь запрашивает дальнейшие действия.

  • Расширение сообщений должно содержать по крайней мере два параметра для улучшения взаимодействия с пользователем в Microsoft 365 Chat.

К началу страницы

Следующее действие

См. также