Criar webhooks e conectores
Webhooks e conectores ajudam a conectar os serviços Web a canais e equipes no Microsoft Teams. Webhooks são retorno de chamada HTTP definido pelo usuário que notifica os usuários sobre qualquer ação que tenha ocorrido no canal do Teams. É uma maneira de um aplicativo 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
Webhooks e conectores estão disponíveis apenas no ambiente do GCC (Government Community Cloud), mas não estão disponíveis em ambientes do DOD (GCC-High e Departamento de Defesa).
Somente o tipo de conector webhook de entrada está disponível em GCC-High ambiente e os administradores do locatário precisam carregar manualmente para exibir o aplicativo na página conectores.
Você pode optar por criar um aplicativo de bot de notificação do Teams que não seja Webhooks de entrada. Eles funcionam da mesma forma, mas o bot de notificação tem mais funcionalidades. Para obter mais informações, consulte criar bot de notificação com JavaScript ou exemplo de notificação do Webhook de entrada. Para começar, baixe e explore o Teams Toolkit. Para obter mais informações, consulte Documentos do Teams Toolkit.
Webhooks de saída
Os webhooks ajudam o Teams a se integrarem a aplicativos externos. Com webhooks de saída, você pode enviar mensagens de texto de um canal para um serviço Web. Depois de configurar os Webhooks de Saída, os usuários podem @mention remover o Webhook e enviar uma mensagem para um serviço Web. O serviço responde dentro de 10 segundos à mensagem com um texto ou um cartão. Para obter mais informações, consulte criar Webhooks de saída.
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 ou enviar mensagens como respostas às mensagens existentes.
Webhooks recebidos
Os Webhooks Recebidos ajudam a postar mensagens de aplicativos para o Teams. Se o Webhooks de entrada estiver habilitado para uma equipe em qualquer canal, ele exporá o ponto de extremidade HTTPS, que aceita json formatado corretamente 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, confira criar Webhooks de entrada.
Bot de notificação ou Webhook de entrada
Antes de começar a aprender a criar Webhooks de entrada, você também pode querer saber que pode criar um bot de notificação usando o Teams Toolkit ou enviar notificações de feed de atividades usando o Microsoft API do Graph. Bots de notificação e notificações de feed de atividades podem habilitar uma experiência mais personalizável para atender a diferentes cenários de negócios. Para obter mais informações, consulte planejar o envio de notificações de aplicativo.
| API de notificação | Bot de notificação | Webhook de entrada | |
|---|---|---|---|
| O que é isso? | Uma API Web RESTful | Um aplicativo do Teams | Um recurso do Teams |
| Instalação necessária | Sim | Sim | Não |
| Cenários adequados | • Notifique os usuários sobre informações urgentes ou críticas. • Exibir conteúdo avançado que requer a ação do usuário no painel main do Teams. • Receber notificação do sistema operacional com som. • Texto de visualização localizado em Atividade. |
• Receba notificações e mensagens regulares periodicamente, por exemplo, receba notificação diária das tarefas da equipe. • Receber notificações e mensagens com base em eventos reais. Por exemplo, depois que os companheiros de equipe carregarem arquivos, você receberá notificações. |
Comunique-se com aplicativos externos e receba notificações e mensagens de outros aplicativos. |
| Configuração de escopo | • Um único usuário • Uma lista de usuários • Usuários em um chat • Usuários em uma equipe |
• Canal do Teams • Chat em grupo • Chat pessoal |
Canal do Teams |
| Processo de mensagem | Um aplicativo do Teams faz uma chamada de API REST para disparar uma notificação na Atividade no Teams. A chamada de API passa o link profundo para carregar conteúdo no painel main. | Um bot de notificação funciona como um aplicativo do Teams. Você pode definir sua lógica de negócios para processar dados e mostrar dados em um formato personalizado. | O Webhook é um recurso do Teams em vez de um aplicativo do Teams, portanto, ele só recebe e mostra dados sem processamento. |
| Recuperar contexto do Teams | O aplicativo pode usar APIs do Graph para trabalhar com dados do Microsoft 365. | O bot de notificação pode recuperar o contexto do Teams, como informações de canal ou usuário e mensagens. | Não |
| Enviar cartão adaptável | Não | Sim | Sim |
| Enviar uma mensagem de boas-vindas | Sim | Sim | Não |
| Gatilho com suporte | Todos os gatilhos têm suporte. | Todos os gatilhos têm suporte. Se você usar o Teams Toolkit, poderá obter rapidamente um projeto de modelo com os seguintes gatilhos: • Gatilho de tempo hospedado em funções do Azure. • Reestifique o gatilho HTTP hospedado no serviço de aplicativo do Azure. • Gatilho HTTP hospedado no Azure Functions. |
Todos os gatilhos têm suporte. |
| Criar ferramentas | Início rápido – Microsoft Graph | • Visão geral do Kit de Ferramentas do Teams para Visual Studio Code • Visão geral do Kit de Ferramentas do Teams para Visual Studio • CLI do Teams Toolkit • SDK do TeamsFx |
Nenhuma ferramenta é necessária. |
| Recurso de nuvem necessário | Microsoft Entra aplicativo | Estrutura do Bot do Azure | Nenhum recurso é necessário. |
| Tutorial | • Enviar notificações de feed de atividades para usuários no Microsoft Teams • Enviar notificação do feed de atividades |
Compilar um bot de notificação com JavaScript | Exemplo de notificação do Webhook de entrada |
Conectores para Grupos do Microsoft 365
Os conectores para Grupos do Microsoft 365 permitem criar uma página de configuração personalizada para o Webhook de entrada e empacotá-los como parte de um aplicativo do Teams. Você envia mensagens principalmente usando cartões de conector para Grupos do Microsoft 365 e pode adicionar um conjunto limitado de ações cartão a elas. Por exemplo, um conector meteorológico que permite que os usuários selecionem um local e qualquer hora do dia, para receber atualizações sobre o clima de amanhã. Eles estão configurados no nível do canal, mas são instalados no nível da equipe. Para obter mais informações, consulte criar conectores para Grupos do Microsoft 365.
Observação
Você pode distribuir o conector para Grupos do Microsoft 365 aplicativo teams para nosso 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 o Webhooks de entrada, você pode enviar mensagens postando uma carga JSON na 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