Criar webhooks e conectores

  • Artigo

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?

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. O suporte para a utilização de mensagens card formato em Fluxos de Trabalho fica disponível a partir de meados de outubro. 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.

Webhooks e conectores ajudam a conectar os serviços Web a canais e equipes no Microsoft Teams. Os webhooks são chamadas de retorno HTTP definidas pelo utilizador que notificam os utilizadores sobre qualquer ação que tenha ocorrido no canal do Teams. É uma forma de uma aplicação obter dados em tempo real. Os conectores permitem aos usuários se inscreverem para receber notificações e mensagens dos serviços da Web. Eles expõem um ponto de extremidade HTTPS para o seu serviço postagem mensagens na forma de cartões.

Importante

  • Os webhooks e conectores só estão disponíveis no ambiente GCC (Government Community Cloud), mas não estão disponíveis em ambientes GCC-High e do Departamento de Defesa (DOD).

  • Apenas o tipo de conector Do Webhook recebido está disponível no GCC-High ambiente e os administradores de inquilinos têm de carregar manualmente para apresentar a aplicação na página de conectores.

  • Pode optar por criar o bot de notificação da aplicação Teams para além dos Webhooks recebidos. Funcionam da mesma forma, mas o bot de notificação tem mais funcionalidades. Para obter mais informações, veja Build notification bot with JavaScript or Incoming Webhook notification sample (Bot de notificação de compilação com JavaScript ou Exemplo de notificação de Webhook recebido). Para começar, transfira e explore o Teams Toolkit. Para obter mais informações, veja Documentos do Teams Toolkit.

Webhooks de saída

Os webhooks ajudam o Teams a se integrarem a aplicativos externos. Com Webhooks de Envio, pode enviar mensagens SMS de um canal para um serviço Web. Depois de configurar os Webhooks de Envio, os utilizadores podem @mention Enviar Webhook e enviar uma mensagem para um serviço Web. O serviço responde dentro de 10 segundos à mensagem com um texto ou um card. Para obter mais informações, consulte Criar Webhooks de Envio.

Observação

Os Webhooks de Saída são configurados por equipe e não podem ser incluídos como parte de um aplicativo normal do Teams.

Conectores

Os conectores permitem que os usuários se inscrevam para receber notificações e mensagens dos serviços Web. Eles expõem o ponto de extremidade HTTPS do serviço para postar mensagens nos canais do Teams, geralmente na forma de cartões.

Observação

Os conectores não podem atualizar mensagens nem enviar mensagens como respostas a mensagens existentes.

Webhooks recebidos

Os Webhooks Recebidos ajudam a postar mensagens de aplicativos para o Teams. Se os Webhooks recebidos estiverem ativados para uma equipa em qualquer canal, expõe o ponto final HTTPS, que aceita JSON corretamente formatado e insere as mensagens nesse canal. Por exemplo, você pode criar um Webhook de entrada em seu canal DevOps, configurar sua compilação e, simultaneamente, implantar e monitorar serviços para enviar alertas. Para obter mais informações, consulte Criar Webhooks recebidos.

Bot de notificação ou Webhook recebido

Antes de começar a aprender a criar Webhooks recebidos, também poderá querer saber que pode criar um bot de notificação com o Teams Toolkit ou enviar notificações do feed de atividades com o Microsoft API do Graph. Os bots de notificação e as notificações do feed de atividades podem permitir uma experiência mais personalizável para satisfazer diferentes cenários empresariais. Para obter mais informações, veja Planear o envio de notificações de aplicações.

  API de Notificação Bot de notificação Webhook de entrada
O que é isso? Uma API Web RESTful Uma aplicação do Teams Uma funcionalidade do Teams
Instalação necessária Sim Sim Não
Cenários adequados • Notifique os utilizadores sobre informações urgentes ou críticas.
• Apresentar conteúdo avançado que requer a ação do utilizador no painel main do Teams.
• Receber notificação do sistema operativo com som.
• Texto de pré-visualização localizado em Atividade.		 • Receber notificações e mensagens regulares periodicamente, por exemplo, receber notificações diárias de tarefas de equipa.
• Receber notificações e mensagens com base em eventos reais. Por exemplo, quando os colegas de equipa carregarem ficheiros, receberá notificações.		 Comunique com aplicações externas e receba notificações e mensagens de outras aplicações.
Configuração do âmbito • Um único utilizador
• Uma lista de utilizadores
• Utilizadores numa conversa
• Utilizadores numa equipa		 • Canal do Teams
• Conversa de grupo
• Conversa pessoal		 Canal do Teams
Processo de mensagem Uma aplicação do Teams faz uma chamada à API REST para acionar uma notificação em Atividade no Teams. A chamada à API transmite a ligação avançada para carregar conteúdo no painel main. Um bot de notificação funciona como uma aplicação do Teams. Pode definir a lógica de negócio para processar dados e mostrar dados num formato personalizado. O Webhook é uma funcionalidade do Teams em vez de uma aplicação do Teams, pelo que só recebe e mostra dados sem processamento.
Obter contexto do Teams A aplicação pode utilizar Graph APIs para trabalhar com dados do Microsoft 365. O bot de notificação pode obter o contexto do Teams, como informações e mensagens do canal ou do utilizador. Não
Enviar Cartão Ajustável Não Sim Sim
Enviar uma mensagem de boas-vindas Sim Sim Não
Acionador suportado Todos os acionadores são suportados. Todos os acionadores são suportados.
Se utilizar o Teams Toolkit, pode obter rapidamente um projeto de modelo com os seguintes acionadores:
• Acionador de tempo alojado nas funções do Azure.
• Restify HTTP trigger hosted on Azure app service (Acionador HTTP restify alojado no serviço de aplicações do Azure).
• Acionador HTTP alojado no Azure Functions.		 Todos os acionadores são suportados.
Ferramentas de Criação Guia de Introdução - Microsoft Graph • Descrição Geral do Teams Toolkit para Visual Studio Code
• Descrição Geral do Teams Toolkit para Visual Studio
• CLI do Teams Toolkit
• SDK teamsFx		 Não são necessárias ferramentas.
Recurso da cloud necessário Microsoft Entra aplicação Azure Bot Framework Não são necessários recursos.
Tutorial • Enviar notificações do feed de atividades aos utilizadores no Microsoft Teams
• Enviar notificação do feed de atividades		 Compilar um bot de notificação com JavaScript Exemplo de notificação de Webhook recebido

Conectores para Grupos do Microsoft 365

Os conectores para Grupos do Microsoft 365 permitem-lhe criar uma página de configuração personalizada para o webhook recebido e empacotá-los como parte de uma aplicação do Teams. Pode enviar mensagens principalmente através de cartões de conector para Grupos do Microsoft 365 e pode adicionar um conjunto limitado de ações card às mesmas. Por exemplo, um conector meteorológico que permite aos utilizadores selecionar uma localização e qualquer hora do dia, para receber atualizações sobre a meteorologia de amanhã. Estão configurados ao nível do canal, mas estão instalados ao nível da equipa. Para obter mais informações, veja Criar conectores para Grupos do Microsoft 365.

Observação

Pode distribuir o conector para Grupos do Microsoft 365 aplicação Teams para a nossa AppStore.

Criar e enviar mensagens

As mensagens acionáveis permitem que os usuários executem ações sem sair do cliente de email, aumentando o envolvimento do usuário. Com o Microsoft 365 e webhooks recebidos, pode enviar mensagens ao publicar um payload JSON no URL do webhook. Para obter mais informações, consulte Criar e enviar mensagens.

Confira também

Funcionalidades do aplicativo mapeados para recursos