Criar webhooks e conectores

Artigo
12/20/2023

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.

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.

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.

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. Os bots de notificação podem habilitar uma experiência mais personalizável para atender a diferentes cenários de negócios.

Saiba mais sobre as diferenças entre um bot de notificação e o Webhook de entrada para que você possa escolher as soluções certas para seus cenários:

	Bot de notificação	Webhook de entrada
O que é isso?	Um aplicativo do Teams	Um recurso do Teams
Instalação necessária	Sim	Não
Cenários adequados	• 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	• Canal do Teams • Chat em grupo • Chat pessoal	Canal do Teams
Processo de mensagem	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 bot de notificação pode recuperar o contexto do Teams, como o canal ou informações do usuário, mensagens etc.	Não
Enviar cartão adaptável	Sim	Sim
Enviar uma mensagem de boas-vindas	Sim	Não
Gatilho com 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	• 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	Estrutura do Bot do Azure	Nenhum recurso é necessário.
Tutorial	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.

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.

Próxima etapa

Criar Webhooks de saída