Considerações para a integração do Microsoft Teams
Pode tornar as aplicações Web adequadas às funcionalidades sociais e colaborativas do Microsoft Teams ao integrá-las corretamente no Teams.
Os diferentes tipos de aplicações, que pode integrar no Teams, são os seguintes:
- Aplicações autónomas: uma aplicação autónoma é uma aplicação de página única ou grande e complexa. 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 pretende apresentar no Teams.
Você pode mapear e seguir as diretrizes apropriadas aplicáveis ao seu cenário de integração. Este documento fornece uma descrição geral das capacidades do Teams, requisitos do SharePoint para armazenamento de ficheiros e dados, requisitos de API, autenticação e ligação profunda da sua aplicação com o Teams.
Conheça os recursos da plataforma Teams
Importante
Os Conectores do Microsoft 365 (anteriormente denominados conectores Office 365) estão prestes a descontinuar e a criação de novos Conectores do Microsoft 365 será bloqueada em breve. Para obter mais informações sobre a agenda e como a aplicação Fluxos de Trabalho fornece uma experiência mais flexível e segura, veja Descontinuação dos conectores do Microsoft 365 no Microsoft Teams.
Como pode criar um webhook no Teams?
Para publicar automaticamente num chat ou canal quando um pedido de webhook é recebido, utilize os modelos de fluxo de trabalho predefinidos ou crie um fluxo de trabalho do zero com o acionador Quando um pedido de webhook do Teams é recebido . Para obter mais informações, consulte Publicar um fluxo de trabalho quando um pedido de webhook é recebido no Microsoft Teams..
Para obter mais informações sobre o acionador Quando um pedido de webhook do Teams é recebido , consulte Microsoft Teams – Webhook.
Se já tiver criado Office 365 Conectores:
Criar um conector do Power Automate: o Power Automate melhora as aplicações de Fluxos de Trabalho amplamente utilizadas no Teams. É a abordagem dimensionável e segura para transmitir dados através de programação para dentro e para fora do Teams. Se adotar este método, pode criar modelos de fluxo de trabalho para publicar alertas do seu produto em canais do Teams. Esta abordagem simplifica a adoção pelo utilizador do novo método. Para obter mais informações, veja Power Automate para programadores empresariais, ISVs e parceiros.
Atualizar a sua aplicação Teams: pode melhorar a sua aplicação teams atual. Por exemplo, pode permitir que os utilizadores configurem mensagens proativas com base em eventos de acionador no seu sistema. Para obter mais informações, veja como os bots podem publicar em canais através de mensagens proativas.
Problemas conhecidos
- A aplicação de fluxos de trabalho não pode publicar em canais privados como um bot de fluxo. No entanto, pode publicar em nome de um utilizador.
- Os fluxos de trabalho suportam apenas Cartões Ajustáveis. Não suporta a mensagem mais antiga card formato que os Conectores Office 365 utilizam. Os fluxos de trabalho não suportam a utilização da mensagem card formato. Para obter mais informações, veja como converter mensagens de conector card formato em Cartão Ajustável.
- Os fluxos de trabalho não oferecem conectores de terceiros, como o DataDog e o Jenkins.
- Os fluxos de trabalho só podem ser criados no seu ambiente predefinido.
Limites
Os fluxos de trabalho estão ligados apenas a utilizadores específicos (referidos como proprietários do fluxo de trabalho) e não a uma equipa ou canal do Teams. Os fluxos de trabalho podem tornar-se fluxos órfãos na ausência de um proprietário se não forem atribuídos coproprietários. Para manter a continuidade no processo de negócio automatizado pelo fluxo, os administradores podem adicionar um ou mais coproprietários e conceder-lhes controlo total sobre o fluxo de trabalho. Também podem adicionar autenticação para ligações, se existirem, e ativar o fluxo se este tiver sido desativado. Para obter mais informações, veja Gerir fluxos órfãos.
Cenários de integração: Aplicações autónomas, aplicações de colaboração, SharePoint
Seu aplicativo Teams deve incluir recursos colaborativos necessários e esperados. Para trabalhar com a integração de aplicações, é 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 Separadores expandidos no Microsoft 365 |
| Compartilhar atalhos e extensões |
Extensões de mensagens Extensões de mensagens para o Outlook |
| Atalhos e extensões de ação | Extensões de mensagens |
| Chatbots | Bots |
| Notificação de canal |
Bots Webhooks recebidos Conectores para Grupos do Microsoft 365 |
| Serviços externos de mensagem |
Bots Webhooks de envio |
| Modais | Caixas de diálogo (referidas como 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: aplicações autónomas
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.
- Mapear os casos de uso do seu aplicativo para recursos de plataforma do Teams.
- 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 pode integrar a sua página como um separador 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: Aplicações autónomas, aplicações 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: aplicações autónomas, aplicações 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: Aplicações autónomas, aplicações de colaboração, SharePoint
Microsoft Entra ID é o fornecedor de identidade do Teams. Se a sua aplicação utilizar um fornecedor de identidade diferente, tem de fazer um exercício de mapeamento de identidades ou combinar com Microsoft Entra ID.
O Teams tem mecanismos de início de sessão único (SSO) com Microsoft Entra ID para aplicações de terceiros. Também fornece a documentação de orientação para fluxos de autenticação para outros fornecedores de identidade através de normas como o OAuth e o OpenID Connect, conhecidos como OIDC.
Importante
As aplicações de terceiros estão disponíveis na Cloud da Comunidade Governamental (GCC), mas não estão disponíveis para GCC-High e Departamento de Defesa (DOD). 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, só pode utilizar o SSO e não pode adicionar outro Microsoft Entra ID se quiser que o SSO funcione para outra aplicação, uma vez que o ID é a aplicação SharePoint.
Saiba mais sobre autenticação no Teams.
Siga as diretrizes de design do Teams
Cenários de integração: aplicações autónomas, aplicações de colaboração
Siga as Diretrizes de design do Teams para tornar seu aplicativo nativo do Teams. Não pode migrar um conteúdo de aplicação existente para um separador do Teams. Para obter mais informações sobre a estrutura da aplicação, veja Sistema Fluent Design.
Maximizar a vinculação profunda
Cenários de integração: Aplicações autónomas, aplicações 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: Aplicações autónomas, aplicações 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, o bot envia uma mensagem de boas-vindas quando está instalado ou um novo utilizador adere a 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 aos utilizadores 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.