Criar webhooks de saída

Os Webhooks ajudam o Microsoft Teams a se integrar a aplicativos externos. No Teams, os Webhooks de saída atuam como bot e pesquisam mensagens em canais usando @menção. Os Webhooks de saída permitem que os usuários enviem mensagens para serviços Web sem executar todo o processo de criação de bots por meio de Microsoft Bot Framework. Os Webhooks de saída postam dados do Teams para qualquer serviço capaz de aceitar o conteúdo JSON.

Principais recursos de Webhooks de Saída

Envie notificações para qualquer serviço Web externo.
Responda com mensagens de texto avançadas, incluindo cartões e imagens.
Receber mensagens em canais públicos e não no escopo pessoal ou privado.
Envie HTTP POST para o serviço Web e obtenha resposta.

Observação

Os Webhooks de saída não podem acessar nenhuma outra APIs, como recuperar a lista ou a lista de canais em uma equipe.

Este guia passo a passo ajuda você a criar Webhooks de saída no Teams. Você verá a seguinte saída:

A captura de tela mostra webhooks de saída no canal do Teams.

Pré-requisitos

10 minutos restantes

Certifique-se de instalar as seguintes ferramentas e configurar seu ambiente de desenvolvimento:

	Instalar	Para usar...
	Microsoft Teams	O Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamadas em um só lugar.
	Visual Studio 2022	Você pode instalar a versão corporativa no Visual Studio 2022 e instalar as cargas de trabalho ASP.NET e desenvolvimento da Web. Use a versão mais recente.
	Túnel de desenvolvimento	Os recursos do aplicativo Teams (bots de conversa, extensões de mensagem e webhooks de entrada) precisam de conexões de entrada. Um túnel conecta seu sistema de desenvolvimento ao Teams. O túnel de desenvolvimento é uma ferramenta poderosa para abrir com segurança seu localhost para a Internet e controlar quem tem acesso. O túnel de desenvolvimento está disponível no Visual Studio 2022 versão 17.7.0 ou posterior. ou você também pode usar o ngrok como um túnel para conectar seu sistema de desenvolvimento ao Teams. Não é necessário para aplicativos que incluem apenas guias. Esse pacote é instalado no diretório do projeto (usando npm `devDependencies`).

Observação

Depois de baixar o ngrok, inscreva-se e instale authtoken.

Configurar o ambiente local

9 minutos restantes

Abra Exemplos do Microsoft-Teams.
Selecione Código.
No menu suspenso, selecione Abrir com o GitHub Desktop.
Selecione Clonar.

8 minutos restantes

Criar um túnel

túnel de desenvolvimento
ngrok

Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa de pesquisa, insira ASP.NET. Nos resultados da pesquisa, selecione ASP.NET Core Aplicativo Web.
Selecione Avançar.
Insira o nome do projeto e selecione Avançar.
Selecione Criar.

Uma janela de visão geral é exibida.
Na lista suspensa 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 pop-up:
1. Conta: insira uma conta Microsoft ou GitHub.
2. Nome: insira um nome para o túnel.
3. Tipo de túnel: na lista suspensa, selecione Temporário.
4. Acesso: Na lista suspensa, selecione Público.
Clique em OK.

Uma janela pop-up aparece mostrando que o túnel de desenvolvimento foi criado com êxito.
Clique em OK.

Você pode encontrar o túnel que você criou na lista suspensa de depuração da seguinte maneira:
Selecione F5 para executar o aplicativo no modo de depuração.
Se uma caixa de diálogo Aviso de Segurança for exibida, selecione Sim.

Uma janela pop-up será exibida.
Selecione Continuar.

A página inicial do túnel de desenvolvimento é aberta em uma nova janela do navegador e o túnel de desenvolvimento agora está ativo.
Vá para o Visual Studio, selecione Exibir > Saída.
No menu suspenso Do console de saída , selecione Túneis de Desenvolvimento.

O console de saída mostra a URL do túnel de desenvolvimento.

Use o ngrok ou o Prompt de Comando para criar um túnel para os pontos de extremidade HTTPS disponíveis publicamente do servidor Web localmente. Execute o seguinte comando no ngrok:

ngrok http --host-header=localhost 3978

Dica

Se você encontrar ERR_NGROK_4018, siga as etapas fornecidas no Prompt de Comando para se inscrever e autenticar o ngrok. Em seguida, execute o comando ngrok http --host-header=localhost 3978.

A janela mostra a URL HTTPS.

A captura de tela mostra a URL HTTPS do ngrok.

Vá para o Teams e selecione Teams no painel esquerdo.
Vá para uma equipe desejada, selecione Mais opções (•••) e selecione Gerenciar equipe.
Selecione a guia Aplicativos na barra de navegação.
Selecione Criar um webhook de saída no canto inferior direito da janela.
Insira os seguintes detalhes:
- Nome: o título do webhook na @mention guia.
- URL de retorno de chamada: a URL gerada a partir de ngrok que aceita cargas JSON e recebe solicitações POST do Teams. Para usar o api/Sample ou api/authenticatedSample, faça o seguinte:
  - Para exemplo de api, copie e cole a URL ou ngrok e anexe-a dev tunnel com /api/sample.
  - Para api authenticatedSample, copie e cole a URL ou ngrok e anexe-a dev tunnel com /authenticatedSample?id=contoso.
- Descrição: uma cadeia de caracteres detalhada que aparece no perfil cartão e no aplicativo de nível de equipe dashboard.
- Imagem de perfil (opcional): ícone de aplicativo para o webhook.
Selecione Criar. O Webhook de saída é adicionado ao canal da equipe atual.
Uma Hash-based Message Authentication Code (HMAC) caixa de diálogo é exibida. Você pode usar o token de segurança no arquivo AuthProvider.cs para autenticar chamadas entre o Teams e quaisquer serviços externos designados.

Observação

O Webhook de Saída está disponível para os usuários da equipe, somente se a URL for válida e os tokens de autenticação do servidor e do cliente forem iguais. Por exemplo, um handshake HMAC.

Compilar e executar o serviço

3 minutos restantes

Abra o Visual Studio.
Vá para Arquivo>Abrir>Projeto/Solução....
Na pasta csharp , selecione Arquivo WebhookSampleBot.sln .
Vá para o arquivo AuthProvider.cs . Atualize contoso e M365x712764 adicione HMAC.
Pressione F5 para executar o projeto.
Selecione Sim se a caixa de diálogo a seguir for exibida:

Uma página da Web exibe informações de host local.

Interagir com o aplicativo no Teams

2 minutos restantes

Vá para o Teams e selecione Teams no painel esquerdo.
Vá para a conversa do General>New.
Para invocar um Webhook de saída no canal, @menção o nome do Webhook de saída 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 exibe uma nova mensagem.