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

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

Примечание.

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

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

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

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

Вкладки

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

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

Уведомление предоставляет значение в Teams, если:

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

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

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

[Необходимо исправить]

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

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

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

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

   

   

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

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

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

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

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

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

  

  

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

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

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

Боты

[Необходимо исправить]

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

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

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

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

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

[Необходимо исправить]

Этот раздел соответствует политике Коммерческой платформы Майкрософт 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 в его собственный интерфейс через прямую ссылку с протоколом , например , или , запустите прямую ссылку в новом окне, вызвав window.open метод или используя тег привязки с target="_blank".webex:mailto:tel:

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

• Пользователь должен оставаться в приложении 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 Cloud Partner (идентификатор CCP), ранее известный как Microsoft Partner Network (MPN ID) в манифесте приложения. Идентификатор CCP помогает определить партнерская организация, которая создает приложение. [Хорошо для исправления]

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

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

[Необходимо исправить]

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

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

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

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

  

  

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

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

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

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

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

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

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

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

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

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

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

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

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

  

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

  

  

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

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

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

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

  

  

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

• Если вам нужно ссылаться на Teams, напишите первую ссылку в списке приложений как Microsoft 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.

  

  

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

  

  

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

  • … сертифицировано для…
  • … на платформе…

• Включать опечатки, грамматические ошибки.

• Неоправданно прописывать весь манифест приложения, длинное описание 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 в списке приложений, должны содержать хром команды. [Необходимо исправить]

  

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

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

  

Видео

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

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

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

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

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

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

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

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

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

• Видео должно быть в формате https://www.youtube.com/watch?v=:id или https://youtu.be/:id для YouTube и https://vimeo.com/:id Для Vimeo.

  

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

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

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

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

[Необходимо исправить]

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

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

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

[Необходимо исправить]

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

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

Ссылки на службу поддержки

[Необходимо исправить]

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

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

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

Локализация

[Необходимо исправить]

• Если ваше приложение поддерживает локализацию, в пакет приложения должен быть включен файл с переводами на другие языки, которые отображаются в зависимости от языкового параметра 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, чтобы закрепить его. Экран настройки вкладки должен описывать важность настройки и способы настройки. [Необходимо исправить]

  

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

  

  

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

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

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

    

    

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

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

Представления

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

  

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

  

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

  

  

Навигация

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

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

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

  

  

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

  

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

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

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

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

    

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

  

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

  

  

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

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

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

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

  

  

  

  

  

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

  

  

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

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

  

Юзабилити

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

  

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

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

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

  

  

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

  

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

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

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

  Совет

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

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

  

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

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

Выбор области

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

  

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

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

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

  

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

  

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

Боты

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

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

Совет

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

Рекомендации по проектированию ботов

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

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

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

Команды бота

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

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

  

  

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

  

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

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

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

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

  

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

  

  

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

  

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

  

  

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

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

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

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

  

  

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

  

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

  

  

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

  

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

  

  

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

Совет

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

Бот сначала запускает взаимодействие с пользователем

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

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

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

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

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

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

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

    

    

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

  

  

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

  

  

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

  

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

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

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

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

  

  

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

  

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

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

  

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

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

  

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

  

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

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

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

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

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

Совет

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

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

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

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

  

  

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

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

    

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

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

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

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

    

    

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

  

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

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

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

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

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

• Проектирование адаптивной карточки
• Справочные материалы о карточках

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

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

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

Совет

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

Сведения о метаданных бота

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

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

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

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

Бот в совместной область

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

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

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

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

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

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

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

Совет

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

Рекомендации по проектированию расширений обмена сообщениями

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

  

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

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

  

  

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

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

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

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

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

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

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

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

  

  

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

  

  

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

  

  

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

  

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

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

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

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

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

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

[Необходимо исправить]

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

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

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

Команды поиска

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

  

  

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

  

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

Диалоги

[Необходимо исправить]

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

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

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

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

Совет

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

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

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

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

Совет

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

Рекомендации по проектированию расширений собраний

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

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

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

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

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

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

  

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

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

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

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

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

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

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

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

  

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

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

  

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

  

Интерфейс перед собранием и после собрания

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

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

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

  

Взаимодействие с участниками собрания

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

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

  

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

Вкладки собрания

• Вкладка должна быстро реагировать. [Необходимо исправить]

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

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

  

  

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

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

  

  

Диалоговые окна в собрании

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

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

  

  

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

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

  

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

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

  • Все изображения имеют формат 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 и на других экранах отображается синяя проверенная эмблема. Дополнительные сведения см. в статье Добавление для приложения метки "Проверенный издатель". [Необходимо исправить]

  

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

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

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

Реклама

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

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

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

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

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

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

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

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

• Поощряет или позволяет пользователям выполнять транзакцию или передачу данных на основе криптовалют за пределами платформы 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 365 Copilot

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

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

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

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

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

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

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

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

  

  

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

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

  

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

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

  

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

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

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

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

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

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

Создание учетной записи Центра партнеров

См. также

• Протестируйте и отладьте ваше приложение
• Подготовка отправки в Магазине Teams
• Включение предложения SaaS в приложение Teams
• Стратегизируйте и выполняйте рост приложения
• Проверка приложения на портале разработчика для Teams