O que são aplicativos do Microsoft Teams?

  • 10 minutos

Um aplicativo criado na Plataforma do Microsoft Teams estende o cliente do Microsoft Teams (Web, dispositivo móvel e desktop) com serviços e aplicativos Web que você hospeda. A Plataforma do Teams oferece um conjunto abrangente e flexível de pontos de extensibilidade, construções de interface do usuário e APIs para você aproveitar ao criar seu aplicativo. Seu aplicativo pode ser tão simples quanto incorporar seu site existente em uma guia para sua equipe ou um aplicativo multifacetado e cheio de recursos envolvendo os usuários em toda a extensão do cliente do Teams. Você pode escolher integrar um aplicativo existente ou criar uma nova experiência criada inteiramente para o Teams.

Com a Plataforma do Microsoft Teams, você poderá ampliar seus serviços com informações específicas do contexto disponíveis nas várias APIs do Microsoft Teams, como informações sobre a equipe ou canal em que seu aplicativo está instalado ou mensagens das quais seu aplicativo foi acionado. Você poderá criar aplicativos para um usuário individual, uma equipe, toda a sua organização ou publicar seu aplicativo na loja de aplicativos pública para que todos possam usar.

O que constitui um aplicativo Microsoft Teams?

Os aplicativos criados na Plataforma do Microsoft Teams consistem em três componentes principais:

  • O cliente do Microsoft Teams fornece os pontos de extensão e os elementos da interface do usuário que seu aplicativo usará para envolver os usuários.
  • Seu pacote do aplicativos do Teams é instalado no Microsoft Teams. Ele contém um ícone pequeno, um ícone grande e um arquivo JSON de manifesto. O arquivo de manifesto contém os metadados de seu aplicativo (como o nome do aplicativo, o nome do desenvolvedor, etc.), que pontos de extensibilidade seu aplicativo usa (como guias e extensões de mensagens) e ponteiros para os serviços Web que potencializam seu aplicativo (como a ID do seu bot ou a URL da sua guia).
  • Seus serviços Web que você hospeda, fornecem as APIs e a lógica que alimentam seu aplicativo.

É importante ter em mente que a Plataforma do Microsoft Teams não é um serviço de hospedagem; os serviços Web que alimentam seu aplicativo devem ser hospedados por você e acessíveis por HTTPS pela Internet.

Onde o cliente do Teams pode ser estendido?

Há vários locais onde o cliente do Microsoft Teams pode ser estendido para permitir que os usuários interajam com seu aplicativo. Dependendo do cenário, você poderá escolher se concentrar em um único ponto de extensão (como um bot de conversa pessoal) ou combinar vários pontos de extensão.

Equipes, canais e chats em grupo

Equipes, canais e chats de grupo permitem que várias pessoas colaborem. Os aplicativos que estendem o contexto tornam-se disponíveis para todos os membros do grupo ou conversa, geralmente com foco na ativação de outros fluxos de trabalho colaborativos ou desbloqueio de novas interações sociais. O aplicativo terá acesso a APIs que permitem obter informações sobre os membros da conversa, os canais em uma equipe e metadados sobre a equipe ou a conversa.

Eles podem ser expandidos com:

  • Bots de conversação, chamada e mídia online interagindo com membros da conversa por meio de chat e respondendo a eventos (como um novo membro sendo adicionado ou um canal sendo renomeado). Todas as conversas com um bot neste contexto serão visíveis a todos os membros do canal ou grupo, portanto é necessário garantir que a conversa seja relevante para todos.
  • Separadores de chat de canal e grupo que fornecem uma experiência Web incorporada em ecrã inteiro configurada para o canal ou chat de grupo no qual está instalado. Todos os membros irão interagir no mesmo aplicativo Web compartilhado, portanto, uma experiência de aplicativo de página única sem estado é típica.
  • Webhooks e conectores que permitem aos serviços externos publicar mensagens na conversação. Você poderá aproveitar os cartões e as ações dos cartões para criar mensagens avançadas e acionáveis. Os webhooks fornecem um método simples, não autenticado e unilateral para postar mensagens em um canal, enquanto os conectores fornecem uma experiência completa um pouco mais robusta.

Aplicativos pessoais

Os aplicativos pessoais são a parte do aplicativo Teams que se concentra nas interações com um único usuário. A experiência é única para cada usuário individual. Esta parte do aplicativo poderá ser fixada no trilho de navegação esquerdo - permitindo aos usuários acesso com um clique.

Eles podem conter:

  • Bots de conversação, chamada e mídia online tendo uma conversa individual com o usuário. Por se tratar de uma conversa privada, se o aplicativo precisar ter uma conversa mais longa com um usuário ou fornecer uma notificação relevante apenas para um único usuário, normalmente é melhor ter essa interação em um aplicativo pessoal.
  • Guias pessoais proporcionando uma experiência na Web incorporada em tela inteira.

Mensagens

As mensagens são o coração da colaboração no Teams. Com um comando de ação de extensão de mensagem, seu aplicativo permite que os usuários invoquem a API de seu aplicativo a partir de uma mensagem, enviando o conteúdo da mensagem para seu aplicativo para processamento ou ação. Seu aplicativo pode responder apresentando um formulário (um módulo de tarefa) ao usuário para coletar mais informações, enviando uma resposta à mensagem original ou enviando uma mensagem diretamente ao usuário.

Escrevendo mensagens

Seu aplicativo ajuda os usuários a criar mensagens mais eficazes, permitindo que eles pesquisem ou realizem ações em um sistema externo e insiram os resultados em um formato rico e estruturado completo com botões acionáveis.

Há três maneiras de seu aplicativo ajudar os usuários a criar melhores mensagens:

  • Extensão de mensagens - os comandos de ação apresentam ao usuário um formulário modal (um módulo de tarefa), envia os resultados do formulário ao seu aplicativo e insere uma mensagem diretamente na conversa ou cria parte de uma mensagem que o usuário pode editar antes de enviar para a conversa.
  • Extensão de mensagens - comandos de pesquisa que permitem pesquisar rapidamente um sistema externo, visualizar os resultados dessa pesquisa e inserir o resultado no chat como um rich card.
  • Extensão de mensagens - o desenrolar do link permite que seu aplicativo monitore domínios da Web nos quais você está interessado. Quando uma URL contendo esse domínio é colada na caixa redigir mensagem, a API do seu aplicativo é invocada, permitindo que você adicione um rich card à mensagem com informações adicionais sobre o item ao qual está sendo vinculado.

Aplicativos de reunião

As reuniões permitem colaboração, parceria, comunicação informada e comentários compartilhados. O aplicativo de reunião pode fornecer uma experiência do usuário em cada estágio do ciclo de vida da reunião.

O ciclo de vida da reunião inclui a experiência de aplicativo de pré-reunião, em reunião e pós-reunião, dependendo do status do participante.

Elementos da interface do usuário (IU)

Além disso, para pontos de extensibilidade, a Plataforma do Microsoft Teams fornece elementos da interface do usuário flexíveis para os aplicativos aproveitarem. Esses elementos permitem que você crie experiências avançadas que parecem nativas para o cliente do Teams.

Cartões e ações de cartão

Os cartões são contêineres de interface do usuário definidos por JSON esquematizado, que podem conter várias propriedades e anexos. Podem conter texto formatado, mídia, controles (como caixas suspensas e botões de opção) e botões que acionam as ações do cartão. As ações do cartão podem enviar conteúdos para a API do seu aplicativo, abrir um link, iniciar fluxos de autenticação ou enviar mensagens para conversas. A plataforma do Microsoft Teams oferece suporte a vários tipos de cartões, incluindo cartões adaptáveis, cartões Hero, cartões em miniaturas e muito mais. Eles podem ser combinados em coleções de cartões e exibidos em uma lista ou carrossel.

Módulos de tarefas (caixas de diálogo)

Os módulos de tarefas permitem que você crie experiências pop-up modais em seu aplicativo Teams. Dentro do pop-up, você pode executar seu próprio código HTML/JavaScript personalizado, mostrar um <iframe> como um vídeo do YouTube ou do Microsoft Stream, ou exibir um cartão adaptável. Eles são especialmente úteis para iniciar e concluir tarefas ou exibir informações avançadas, como vídeos ou painéis do Power BI. Uma experiência pop-up costuma ser mais natural para usuários iniciarem e concluírem tarefas em comparação a uma guia ou experiência de bot baseada em conversas.

Seu aplicativo pode criar links profundos de URL para ajudar a navegar pelo usuário através do aplicativo e do cliente do Teams. Você poderá criar um link profundo para a maioria das entidades no Teams, e alguns (como uma nova solicitação de reunião) permitem que você preencha previamente as informações usando cadeias de caracteres de consulta na URL. Por exemplo, o bot de conversa pode enviar uma mensagem a um canal com um link profundo para um módulo de tarefas que resulta no envio de um cartão como uma mensagem individual para um usuário, que por sua vez contém um link profundo para criar um nova reunião com um usuário específico em uma determinada data/hora. Use links diretos para conectar os vários pontos de extensão disponíveis ao seu aplicativo, mantendo o usuário no contexto correto.

Páginas de conteúdo da Web

Uma página de conteúdo da Web é uma página que você hospeda e que pode ser incorporada a uma guia ou módulo de tarefas. Para permitir que sua página da Web seja incorporada a um cliente do Microsoft Teams, é necessário:

  • Ser alojado num ponto final HTTPS.
  • Suporte incorporado num <iframe> pelo cliente do Teams.
  • Inclua o SDK do cliente JavaScript do Microsoft Teams e invoque o método initialize() do SDK no carregamento da página.

Resumo

Uma aplicação do Microsoft Teams é, então, uma coleção de serviços Web, alojados externamente no Microsoft Teams, que tira partido dos pontos de extensibilidade e dos elementos de IU disponibilizados através da Plataforma Microsoft Teams.