Considerações para a integração do Microsoft Teams

Você pode tornar os aplicativos Web adequados aos recursos sociais e colaborativos do Microsoft Teams, integrando-os adequadamente ao Teams.

Os diferentes tipos de aplicativos que você pode integrar ao Teams são os seguintes:

  • Aplicativos autônomos: um aplicativo autônomo é um aplicativo de página única ou grande e complexo. O usuário pode usar alguns aspectos dele no Teams.
  • Aplicativos de colaboração: um aplicativo já criado para os recursos sociais e colaborativos inerentes ao Teams.
  • Microsoft SharePoint: uma página do SharePoint que você deseja exibir no Teams.

Você pode mapear e seguir as diretrizes apropriadas aplicáveis ao seu cenário de integração. Este documento fornece uma visão geral dos recursos do Teams, requisitos do SharePoint para armazenamento de arquivos e dados, requisitos de API, autenticação e vinculação profunda do seu aplicativo com o Teams.

Conheça os recursos da plataforma Teams

Importante

Os Conectores do Microsoft 365 (anteriormente chamados de Conectores do Office 365) estão se aproximando do preterimento, e a criação de novos Conectores do Microsoft 365 será bloqueada em breve. Para obter mais informações sobre a agenda e como o aplicativo Fluxos de trabalho oferece uma experiência mais flexível e segura, consulte desativação dos conectores do Microsoft 365 no Microsoft Teams.

Como você pode criar um webhook no Teams?

  • Para postar automaticamente em um chat ou canal quando uma solicitação de webhook for recebida, use os modelos de fluxo de trabalho predefinidos ou crie um fluxo de trabalho do zero usando o gatilho Quando uma solicitação de webhook do Teams for recebida . Para obter mais informações, consulte Enviar mensagens no Teams usando webhooks de entrada.

  • Para obter mais informações sobre o gatilho Quando uma solicitação de webhook do Teams é recebida , consulte Microsoft Teams - Webhook.

Se você já criou conectores do Office 365:

  • Criar um conector do Power Automate: o Power Automate aprimora os aplicativos de Fluxos de Trabalho amplamente usados no Teams. É a abordagem escalonável e segura para transmitir dados programaticamente dentro e fora do Teams. Se você adotar esse método, poderá criar modelos de fluxo de trabalho para postar alertas do seu produto nos canais do Teams. Essa abordagem simplifica a adoção do novo método pelo usuário. Para obter mais informações, consulte Power Automate para desenvolvedores corporativos, ISVs e parceiros.

  • Atualize seu aplicativo Teams: Você pode aprimorar seu aplicativo Teams atual. Por exemplo, você pode permitir que os usuários configurem mensagens proativas com base em eventos de gatilho em seu sistema. Para obter mais informações, veja como os bots podem postar em canais por meio de mensagens proativas.

Problemas conhecidos

  • O aplicativo Fluxos de trabalho pode postar como um bot de fluxo em canais compartilhados. O suporte para postagem como um bot de fluxo em canais privados está em desenvolvimento. Atualmente, os fluxos de trabalho podem postar mensagens em nome de um usuário.
  • Os fluxos de trabalho dão suporte ao formato de Cartões Adaptáveis e Cartão de Mensagem (não há suporte para renderização de botão).

Limites

Os fluxos de trabalho são vinculados apenas a usuários específicos (chamados de proprietários do fluxo de trabalho) e não a uma equipe ou canal do Teams. Os fluxos de trabalho poderão se tornar fluxos órfãos na ausência de um proprietário se nenhum coproprietário for atribuído. Para manter a continuidade no processo de negócios automatizado pelo fluxo, os administradores podem adicionar um ou mais coproprietários e conceder a eles controle total sobre o fluxo de trabalho. Eles também podem adicionar autenticação para conexões, se houver, e habilitar o fluxo se ele tiver sido desabilitado. Para obter mais informações, consulte gerenciar fluxos órfãos.

Cenários de integração: aplicativos autônomos, aplicativos de colaboração, SharePoint

Seu aplicativo Teams deve incluir recursos colaborativos necessários e esperados. Para trabalhar com a integração de aplicativos, é importante familiarizar-se com a terminologia de desenvolvimento do Teams.

Recursos comuns do aplicativo Funcionalidades da plataforma Teams
Página da Web inserida, página inicial ou modo de exibição da Web Guias
Guias estendidas pelo Microsoft 365
Compartilhar atalhos e extensões Extensões de mensagens
Extensões de mensagem para Outlook
Atalhos e extensões de ação Extensões de mensagens
Chatbots Bots
Notificação de canal Bots
Webhooks de entrada
Conectores para Grupos do Microsoft 365
Serviços externos de mensagem Bots
Webhooks de saída
Modais Caixas de diálogo (chamadas de módulos de tarefas no TeamsJS v1.x)
Cartões com conteúdo avançado Cartões Adaptáveis

Determinar um subconjunto de funcionalidade

Cenários de integração: Aplicativos autônomos

A integração de todos os recursos de um aplicativo existente ao Teams geralmente leva a uma experiência de usuário forçada ou não natural, especialmente em aplicativos maiores. Comece com os recursos mais impactante e aqueles que se integram mais naturalmente ao Teams. Você pode permitir que os usuários iniciem o aplicativo principal e acessem seu conjunto completo de recursos.

A seguir estão os pré-requisitos para integrar seu aplicativo ao Teams.

  1. Mapear os casos de uso do seu aplicativo para recursos de plataforma do Teams.
  2. Determinar os pontos de entrada do aplicativo. É para uso pessoal, para colaboração ou para ambos?

Entenda os requisitos e as opções do SharePoint

Cenários de integração: SharePoint

Para integrar uma página do SharePoint como uma guia do Teams, você deve considerar o seguinte:

  • Ele deve ser uma página online moderna do SharePoint.
  • Há suporte apenas para guias pessoais. Não é possível integrar sua página como uma guia de canal.

Como alternativa, você pode criar uma guia do Teams usando a estrutura do SharePoint.

Vise a multilocação

Cenários de integração: aplicativos autônomos, aplicativos de colaboração, SharePoint

Se seu aplicativo for usado por várias organizações, considere a hospedagem multilocatário. Ele torna seu produto escalonável e simplifica a distribuição.

Examine suas APIs

Cenários de integração: aplicativos autônomos, aplicativos de colaboração

As APIs e estruturas de dados do aplicativo devem dar suporte ao aplicativo durante a integração com o Teams. Para estender o suporte, você deve aumentar as APIs e estruturas de dados com informações contextuais sobre o Teams para mapeamento de identidade, suporte a link profundo e incorporar o Microsoft Graph.

Veja como obter contexto para a guia ou bot do Teams.

Entenda as opções de autenticação

Cenários de integração: aplicativos autônomos, aplicativos de colaboração, SharePoint

O Microsoft Entra ID é o provedor de identidade do Teams. Se o aplicativo usar um provedor de identidade diferente, você deverá fazer um exercício de mapeamento de identidade ou combiná-lo com o Microsoft Entra ID.

O Teams tem mecanismos de logon único (SSO) com o Microsoft Entra ID para aplicativos de terceiros. Ele também fornece diretrizes para fluxos de autenticação para outros provedores de identidade usando padrões como OAuth e OpenID Connect, conhecidos como OIDC.

Importante

Os aplicativos de terceiros estão disponíveis na Nuvem da Comunidade Governamental (GCC), mas não estão disponíveis para GCC High, Departamento de Defesa (DoD) e Teams operados pela 21Vianet. Aplicativos de terceiros são desativados por padrão para GCC. Para ativar aplicativos de terceiros para GCC, consulte gerenciar políticas de permissão de aplicativo e gerenciar aplicativos.

Para páginas do SharePoint, você só pode usar o SSO e não pode adicionar outro Microsoft Entra ID se quiser que o SSO funcione para outro aplicativo, pois a ID é o aplicativo do SharePoint.

Saiba mais sobre autenticação no Teams.

Siga as diretrizes de design do Teams

Cenários de integração: aplicativos autônomos, aplicativos de colaboração

Siga as Diretrizes de design do Teams para tornar seu aplicativo nativo do Teams. Você não pode migrar um conteúdo de aplicativo existente para uma guia do Teams. Para obter mais informações sobre design de aplicativo, consulte Sistema Fluent Design.

Maximizar a vinculação profunda

Cenários de integração: aplicativos autônomos, aplicativos de colaboração, SharePoint

Você pode criar links de informações e recursos no Teams. Use links profundospara vincular seu aplicativo ao Teams à medida que eles reúnem várias partes de um aplicativo para uma experiência mais nativa do Teams.

Seja inteligente ao enviar mensagens aos usuários

Cenários de integração: aplicativos autônomos, aplicativos de colaboração, SharePoint

Use um bot em seu aplicativo do Teams para conversas com vários threaded, pois ele oferece mais flexibilidade do que um webhook.

Os bots também permitem que você envie mensagens proativas para usuários ou canais individuais. As mensagens proativas são mensagens não solicitadas disparadas por um evento externo e não uma mensagem enviada a um bot. Por exemplo, seu bot envia uma mensagem de boas-vindas quando é instalado ou um novo usuário ingressa em um canal.

O envio de mensagens proativas requer identificadores específicos do Teams. Você pode capturar as informações buscando lista de participantes ou dados de perfil de usuário, assinando eventos de conversaou usando o Microsoft Graph.

Não envie spam para usuários com mensagens excessivas. Se a funcionalidade do Teams tiver suporte, os usuários poderão definir as configurações de notificação para seu aplicativo. Veja a seguir um exemplo de uma mensagem de notificação: Não me enviar mensagens não solicitadas.

Usar o SharePoint para armazenamento de arquivos e dados

Integration scenarios: Aplicativos autônomos, aplicativos de colaboração, páginas do SharePoint

Quando uma equipe é criada, um conjunto de sites do SharePoint também é provisionado para dar suporte ao armazenamento de arquivos e dados para essa equipe. Seu aplicativo deverá aproveitar esse recurso se ele interagir com arquivos. Use o conjunto de sites para armazenar dados brutos nas Listas do SharePoint e no Microsoft Excel.

Confira também

  • Last updated on