Criar webhooks e conectores
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 uma mensagem sms ou um cartão. 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 a Microsoft Graph API. 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 principal 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 principal. | 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 nas Funções do Azure. |
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 | Aplicação Microsoft Entra | 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 dos 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. Envia mensagens principalmente através de cartões de conector para Grupos do Microsoft 365 e pode adicionar-lhes um conjunto limitado de ações de cartões. 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, consulte Criar conectores para Grupos do Microsoft 365.
Observação
Pode distribuir o conector da aplicação Teams do Microsoft 365 Groups 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de