Criar pacote de aplicativos do Teams

Você precisa de um pacote de aplicativos, no entanto, planeja distribuir seu aplicativo do Microsoft Teams. Um pacote válido é um arquivo ZIP que contém o seguinte:

  • Manifesto do aplicativo: descreve como seu aplicativo está configurado, incluindo suas características, recursos necessários e outros atributos importantes.
  • Ícones do aplicativo: cada pacote requer uma cor e um ícone de contorno para seu aplicativo.

O Teams não hospeda seu aplicativo

Quando um usuário instala seu aplicativo no Teams, instala um pacote de aplicativo que contém apenas um arquivo de configuração (também conhecido como manifesto do aplicativo) e os ícones do aplicativo. A lógica e o armazenamento de dados do aplicativo são hospedados em outro lugar, como no localhost durante o desenvolvimento e nos Serviços Web do Azure. O Teams acessa esses recursos via HTTPS.

Ilustração mostrando a hospedagem de aplicativos para aplicativos do Teams

Manifesto do aplicativo

O arquivo de manifesto do aplicativo deve estar no nível superior do pacote com o nome manifest.json.

Ao publicar no repositório do Teams, certifique-se de que seu manifesto faça referência ao esquema mais recente.

Ícones do aplicativo

Seu pacote de aplicativos deve incluir duas versões .png do ícone de seu aplicativo: Uma versão colorida e de contorno.

Observação

Se seu aplicativo tiver um bot ou uma extensão de mensagens, seus ícones também serão incluídos no registro do serviço de Bot do Microsoft Azure.

Para que seu aplicativo passe na revisão do repositório do Teams, esses ícones devem atender aos requisitos de tamanho a seguir.

Ícone de cor

A versão colorida do seu ícone é exibida na maioria dos cenários do Teams e deve ter 192 x 192 pixels. Seu símbolo de ícone (96 x 96 pixels) pode ser qualquer cor, mas deve estar em um plano de fundo quadrado sólido ou totalmente transparente.

O Teams corta automaticamente seu ícone para exibir um quadrado com cantos arredondados em vários cenários e uma forma hexagonal em cenários do bot. Para cortar o símbolo sem perder detalhes, inclua 48 pixels de preenchimento ao redor do símbolo.

Teams de cores e diretrizes de design.

Ícone de contorno

Um ícone de contorno é exibido em dois cenários:

  • Quando seu aplicativo estiver em uso e "hospedado" na barra de aplicativos no lado esquerdo do Teams.
  • Quando um usuário fixa a extensão de mensagens do aplicativo.

O ícone deve ter 32 x 32 pixels. Ele pode ser branco com um plano de fundo transparente ou transparente com um plano de fundo branco (nenhuma outra cor é permitida). O ícone de contorno não deve ter nenhum preenchimento extra ao redor do símbolo.

Diretrizes de design do ícone de estrutura do Teams.

Práticas recomendadas

Ilustração mostrando como projetar os ícones do aplicativo.

Fazer: siga as diretrizes precisas do ícone de contorno

Os valores RGB de branco usados no seu ícone devem ser vermelho: 255, verde: 255,azul: 255. Todas as outras partes do ícone de contorno devem ser totalmente transparentes, com o canal alfa definido como 0.

Ilustração mostrando como não projetar ícones do aplicativo.

Não: corte em uma forma quadrada circular ou arredondada

O ícone de cor enviado no pacote do aplicativo deve ser quadrado. Não arredonde os cantos do ícone. O Teams ajusta automaticamente o raio do canto.

Não: copiar outras marcas

Seus ícones não devem imitar produtos protegidos pelos direitos autorais que você não possui. Por exemplo, um design semelhante a um produto ou marca da Microsoft.

Exemplos

Veja como os ícones de aplicativo aparecem em diferentes recursos e contextos do Teams.

Aplicativo pessoal

Exemplo mostrando a aparência de um ícone de aplicativo em um aplicativo pessoal.

Bot (canal)

Exemplo mostrando como um ícone de aplicativo fica em um bot dentro do canal.

Extensão de mensagem

<alt text>

Próxima etapa

Escolha como você planeja distribuir seu aplicativo:

Confira também

Gerencie seus aplicativos com o Portal do Desenvolvedor do Microsoft Teams