Criar Webhooks de Envio
Os webhooks ajudam o Microsoft Teams a integrar-se com aplicações externas. No Teams, os Webhooks de Envio atuam como bot e procuram mensagens em canais através de @mention. Os Webhooks de Envio permitem que os utilizadores enviem mensagens para serviços Web sem executar todo o processo de criação de bots através do Microsoft Bot Framework. Os Webhooks de Envio publicam dados do Teams em qualquer serviço capaz de aceitar o payload JSON.
Principais funcionalidades dos Webhooks de Envio
- Enviar notificações para qualquer serviço Web externo.
- Responda com mensagens de texto formatado, incluindo cartões e imagens.
- Receber mensagens em canais públicos e não no âmbito pessoal ou privado.
- Envie HTTP POST para o serviço Web e obtenha resposta.
Observação
Os Webhooks de Envio não podem aceder a outras APIs, como obter a lista ou lista de canais numa equipa.
Este guia passo a passo ajuda-o a criar Webhooks de Envio no Teams. Verá o seguinte resultado:
Pré-requisitos
Certifique-se de que instala as seguintes ferramentas e configura o seu ambiente de desenvolvimento:
| Instalar | Para usar... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams para colaborar com todas as pessoas com quem trabalha através de aplicações para chat, reuniões e ligar para todos num único local. | |
| Visual Studio 2022 | Pode instalar a versão empresarial no Visual Studio 2022 e instalar as cargas de trabalho de desenvolvimento web e ASP.NET. Utilize a versão mais recente. | |
| Túnel de desenvolvimento | As funcionalidades da aplicação Teams (bots de conversação, extensões de mensagens e webhooks recebidos) precisam de ligações de entrada. Um túnel liga o seu sistema de desenvolvimento ao Teams. O túnel Dev é uma ferramenta avançada para abrir de forma segura o seu localhost na Internet e controlar quem tem acesso. O túnel Dev está disponível no Visual Studio 2022 versão 17.7.0 ou posterior. ou também pode utilizar o ngrok como um túnel para ligar o seu sistema de desenvolvimento ao Teams. Não é necessário para aplicações que incluam apenas separadores. Este pacote é instalado no diretório do projeto (com o npm devDependencies). |
Observação
Depois de transferir o ngrok, inscreva-se e instale o authtoken.
Configurar o ambiente local
Abra Microsoft-Teams-Samples.
Selecione Código.
No menu pendente, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Criar Webhooks de saída
Criar um túnel
Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa de pesquisa, introduza ASP.NET. Nos resultados da pesquisa, selecione ASP.NET Core Web App.
Selecione Avançar.
Introduza Nome do projeto e selecione Seguinte.
Selecione Criar.
É apresentada uma janela de descrição geral.
Na lista pendente de depuração, selecione Túneis de Desenvolvimento (sem túnel ativo)>Criar um Túnel....
Uma janela pop-up será exibida.
Atualize os seguintes detalhes na janela de pop-up:
- Conta: introduza uma conta Microsoft ou GitHub.
- Nome: introduza um nome para o túnel.
- Tipo de Túnel: na lista pendente, selecione Temporário.
- Acesso: na lista pendente, selecione Público.
Selecione OK.
É apresentada uma janela de pop-up que mostra que o túnel dev foi criado com êxito.
Selecione OK.
Pode encontrar o túnel que criou na lista pendente de depuração da seguinte forma:
Selecione F5 para executar a aplicação no modo de depuração.
Se for apresentada uma caixa de diálogo Aviso de Segurança , selecione Sim.
Uma janela pop-up será exibida.
Selecione Continuar.
A home page do túnel dev é aberta numa nova janela do browser e o túnel dev está agora ativo.
Aceda ao Visual Studio e selecione Ver > Saída.
No menu pendente Consola de saída , selecione Túneis Dev.
A consola Output (Saída ) mostra o URL do túnel dev.
Aceda ao Teams e selecione Teams no painel esquerdo.
Aceda a uma equipa que pretenda, selecione Mais opções (•••) e, em seguida, selecione Gerir equipa.
Selecione o separador Aplicações na barra de navegação.
Selecione Criar um webhook de saída no canto inferior direito da janela.
Introduza os seguintes detalhes:
Nome: o título do webhook no @mention separador.
URL de chamada de retorno: o URL gerado a partir do ngrok que aceita payloads JSON e recebe pedidos POST do Teams. Para utilizar o
api/Sampleouapi/authenticatedSample, faça o seguinte:Para o exemplo de API, copie e cole o URL ou
ngroke acrescente-odev tunnelcom/api/sample.Para api authenticatedSample, copie e cole o URL ou
ngroke acrescente-odev tunnelcom/authenticatedSample?id=contoso.
Descrição: uma cadeia detalhada que aparece no cartão de perfil e no dashboard da aplicação ao nível da equipa.
Imagem de perfil (opcional): ícone de aplicação para o seu webhook.
Selecione Criar. O Webhook de Envio é adicionado ao canal da equipa atual.
É
Hash-based Message Authentication Code (HMAC)apresentada uma caixa de diálogo. Pode utilizar o token de segurança no ficheiro AuthProvider.cs para autenticar chamadas entre o Teams e quaisquer serviços externos designados.Observação
O Webhook de Envio está disponível para os utilizadores da equipa, apenas se o URL for válido e os tokens de autenticação de servidor e cliente forem iguais. Por exemplo, um handshake HMAC.
Criar e executar o serviço
Abra o Visual Studio.
Aceda a Ficheiro>Abrir>Projeto/Solução....
Na pasta csharp , selecione WebhookSampleBot.sln ficheiro.
Aceda a AuthProvider.cs ficheiro. Atualize
contosoparaM365x70471008e adicione HMAC.
Pressione F5 para executar o projeto.
Selecione Sim se a caixa de diálogo a seguir for exibida:
Uma página Web apresenta informações do anfitrião local.
Interagir com a aplicação no Teams
Aceda ao Teams e selecione Teams no painel esquerdo.
Aceda a Conversação Geral>Nova.
Para invocar um Webhook de Envio no canal, @mention o nome do Webhook de Envio e selecione o ícone Enviar .
Observação
Você pode enviar mensagens de texto, cartão Hero e Cartão Adaptável como anexo com o Webhook de Saída.
O chat da reunião apresenta uma nova mensagem.
Desafio completo
Encontrou algo assim?
Parabéns!
Concluiu o tutorial para começar a utilizar uma aplicação Webhook de Envio!
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.
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