Motivos comuns para falhas na validação do aplicativo

Os aplicativos podem encontrar problemas comuns durante o processo de envio da Loja do Microsoft Teams. Este artigo destaca esses problemas e fornece orientações para ajudá-lo a preparar seu aplicativo antes de enviá-lo para revisão. Para aumentar a probabilidade de seu aplicativo passar no processo de envio da Loja do Teams, evite os cenários de falha comuns e siga as diretrizes de validação da Loja do Microsoft Teams e as políticas de Certificação do Marketplace Comercial.

A seguir estão os motivos mais comuns para seu aplicativo ser rejeitado:

Descrição inadequada do aplicativo

Uma ótima descrição do aplicativo destaca os benefícios do seu aplicativo e incentiva os clientes a baixá-lo. A tabela a seguir contém erros comuns nas descrições dos aplicativos que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
O manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo do Teams) e a descrição completa do AppSource não contêm hiperlinks para botões de chamada para ação, como Inscrever-se, Começar, Ajuda ou Fale Conosco.
O manifesto do aplicativo e a descrição longa não mencionam quaisquer limitações ou dependências de contas ou serviços externos necessários para concluir experiências de entrada, saída e inscrição.
Contém formas abreviadas, abreviadas ou preteridas de nomes de produtos padrão da Microsoft. Por exemplo, abreviar Microsoft como MS ou MSFT, referenciar a primeira instância do Microsoft Teams como Teams em vez de Microsoft Teams ou usar O365 em vez de Microsoft 365.

Ao se referir a marcas comerciais, produtos e serviços da Microsoft, você deve seguir as Diretrizes de marca e marca registrada da Microsoft.
O destaque da proposta de valor do aplicativo e dos principais recursos nas descrições curtas e completas no manifesto do aplicativo está ausente.
Contém erros tipográficos, erros gramaticais, uso de maiúsculas desnecessárias, código ou conteúdo duplicado.
A referência a produtos aos quais o aplicativo dá suporte, como Teams, Outlook e Microsoft 365, está ausente.
Contenha conteúdo de marketing comparativo ou ofertas concorrentes na descrição do aplicativo ou em outros metadados.
Contém afirmações exageradas sobre o aplicativo, como #1, incrível ou o melhor.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para a descrição do aplicativo.

Capturas de tela inadequadas

As capturas de tela fornecem uma maneira visualmente atraente de retratar a finalidade e os recursos do seu aplicativo para clientes em potencial. A tabela a seguir contém erros comuns em capturas de tela que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
Contém menos de três capturas de tela que retratam as funcionalidades do aplicativo.
Capturas de tela da funcionalidade do aplicativo em clientes Web, desktop e dispositivos móveis do Teams, se suportados, estão ausentes.
As legendas para ajudar os usuários a entender claramente os recursos do aplicativo estão ausentes.
As capturas de tela para mostrar o aplicativo no contexto de uma guia do Teams, se o aplicativo der suporte a guias, estão ausentes.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para capturas de tela.

Incompatibilidade entre o Partner Center e o manifesto do aplicativo

Se os seguintes campos no Partner Center e o manifesto do aplicativo não corresponderem, seu aplicativo poderá não passar no envio da Teams Store:

  • Descrição do aplicativo
  • Nome do desenvolvedor
  • Termos de Uso
  • URLs da Política de Privacidade
  • Ícones de aplicativo (color.png e outline.png)
  • Nome do aplicativo

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para o manifesto do aplicativo.

Violação das diretrizes de domínios válidos

O envio do seu aplicativo deve seguir as diretrizes para domínios externos na Política de Certificação do Marketplace Comercial da Microsoft. Para que seu aplicativo seja aprovado na revisão, verifique se os domínios listados nas matrizes e messageHandlers no manifesto do aplicativo estão sob o validDomains controle direto da sua organização e não incluem domínios de teste ou de não produção.

Para obter mais informações, consulte as diretrizes de validação da Teams Store para domínios externos.

Instruções de teste ausentes ou incompletas

Instruções de teste detalhadas e credenciais ajudam você com uma análise bem-sucedida do seu aplicativo. A tabela a seguir contém erros comuns com instruções de teste e contas de teste que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
A descrição das funcionalidades da versão atual do aplicativo e as etapas de configuração necessárias para que os testadores sigam e testem o aplicativo estão ausentes.
As contas de teste fornecidas são inacessíveis aos testadores. Por exemplo, contas de teste que exigem autenticação multifator para entrar.
As contas de teste fornecidas não suportam o carregamento de aplicativo personalizado.
Várias contas de teste não são incluídas quando o aplicativo dá suporte a escopos colaborativos, como equipes, chats em grupo ou reuniões.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para o pacote do aplicativo e a listagem da Store do Teams.

Bots não funcionais ou parcialmente funcionais

Siga as diretrizes descritas em Projetando seu bot do Microsoft Teams ao desenvolver seu aplicativo de bot. Habilite o bot para informar novos usuários sobre as agregações de valor do seu aplicativo e os pré-requisitos para usar o aplicativo. Planeje e desenvolva seu bot para evitar becos sem saída, mesmo quando a entrada do usuário for irrelevante. A tabela a seguir contém erros comuns com bots que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
O bot não fornece respostas válidas para os comandos com suporte.
Os comandos compatíveis com o bot não funcionam corretamente, incluindo comandos genéricos, como Olá, Olá e Ajuda.
O bot não oferece consistentemente uma resposta válida aos usuários.
O bot não envia uma mensagem de boas-vindas proativa assim que o usuário instala o aplicativo e o executa pela primeira vez.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para bots.

Funcionalidade de aplicativo quebrada

Teste seu aplicativo para verificar sua correção, funcionalidade e uso. Teste seu aplicativo completamente e corrija todos os bugs. Verifique todos os fluxos de trabalho de ponta a ponta que seu aplicativo oferece suporte e teste a compatibilidade do aplicativo nos sistemas operacionais e navegadores de acordo com as políticas de Certificação do Marketplace Comercial. A tabela a seguir contém erros comuns com a funcionalidade do aplicativo que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
O aplicativo fornece uma experiência quebrada aos usuários em qualquer um dos fluxos de trabalho com suporte, como links quebrados e falhas do aplicativo.
Bugs funcionais que impedem o uso posterior do aplicativo.
Carregamento contínuo de superfícies de aplicativos que impedem a conclusão dos fluxos de trabalho declarados que o aplicativo suporta.
Mensagens de erro inesperadas durante o uso do aplicativo em que o recurso do aplicativo não funciona conforme o esperado.
Tenha fluxos de trabalho em que o usuário chega a um beco sem saída e não pode navegar mais no aplicativo.
O aplicativo Teams estendido para Outlook e Microsoft 365 não fornece valor ao usuário no Outlook ou no Microsoft 365.
O aplicativo redireciona os usuários para longe do Teams e não fornece os avisos de isenção de responsabilidade necessários sobre a navegação fora do Teams por meio de links e botões.

Para obter mais informações, consulte as diretrizes de validação da Teams Store para funcionalidade geral e desempenho.

Experiência móvel abaixo do ideal

A experiência do seu aplicativo deve ser consistente entre os clientes da Web, da área de trabalho e móveis do Teams. Oculte fluxos de trabalho incompatíveis com seu aplicativo identificando a plataforma e o problema relevante. A tabela a seguir contém erros comuns na experiência móvel que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
A experiência consumível e ininterrupta na versão móvel do aplicativo está ausente.
Falhas normais se o aplicativo não estiver dando suporte a um fluxo de trabalho específico estão ausentes.
Truncamento de dados ou sobreposição dentro do aplicativo.
Contém recursos de experiência do usuário abaixo do ideal, como rolagem horizontal.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para experiência móvel.

Aplicativos que usam conteúdo gerado por IA sem proteções

Se o aplicativo usa conteúdo gerado por IA, verifique se ele atende aos requisitos para aplicativos com conteúdo gerado por IA de acordo com as políticas de certificação do marketplace comercial da Microsoft. A tabela a seguir contém erros comuns com conteúdo gerado por IA que impedem que os aplicativos passem pelo processo de envio da Loja do Teams:

  Evite o seguinte
Uma indicação no contexto de que o conteúdo do aplicativo é gerado por IA está ausente.
Os usuários não conseguem denunciar conteúdo censurável gerado pela IA no aplicativo.
A moderação do conteúdo gerado por IA para proporcionar um ambiente de trabalho seguro para os usuários está ausente.

Para obter mais informações, consulte as diretrizes de validação da Loja do Teams para aplicativos com conteúdo gerado por IA.

Confira também