Criar Webhooks de saída
O Webhook de Saída atua como um bot e pesquisa mensagens em canais usando @mencionar. Ele envia notificações para serviços Web externos e responde com mensagens avançadas, que incluem cartões e imagens. Ele ajuda a ignorar o processo de criação de bots por meio do Microsoft Bot Framework.
Principais recursos do Webhook de Saída
A tabela a seguir fornece os recursos e a descrição do Webhook de Saída:
Recursos | Descrição |
|---|---|
Configuração com escopo | Os webhooks são definidos no nível da equipe. O processo de configuração obrigatório para cada um adiciona um Webhook de Saída. |
Mensagens reativas | Os usuários devem usar @mencionar para que o webhook receba as mensagens. Atualmente, os usuários só podem enviar mensagens a um Webhook de Saída em canais públicos e não dentro do escopo pessoal ou privado. |
Troca de mensagens HTTP padrão | As respostas aparecem na mesma cadeia da mensagem de solicitação original e podem incluir qualquer conteúdo de mensagem do Bot Framework. Por exemplo, rich text, imagens, cartões e emojis. Embora os Webhooks de Saída possam utilizar cartões, eles não podem utilizar nenhuma ação de cartão, exceto para openURL. |
Suporte ao método de API do Teams | Webhooks de saída enviam um HTTP POST para um serviço Web e obtém uma resposta. Eles não podem acessar nenhuma outra API, como recuperar a lista de participantes ou a lista de canais em uma equipe. |
Criar Webhooks de saída
Criar Webhooks de Saída e adicionar bots personalizados ao Teams.
Para criar um Webhook de Saída, siga estas etapas:
- Selecione Teams no painel esquerdo. A página do Teams é exibida:
- Na página Teams, selecione a equipe necessária para criar um Webhook de Saída e selecione ••••. No menu suspenso, selecione Gerenciar equipe:
- Selecione a guia Aplicativos na página do canal:
- Selecione Criar um Webhook de Saída:
- Digite os seguintes detalhes na página Criar um Webhook de Saída:
- Nome: o título do webhook e a guia @mencionar.
- URL de retorno de chamada: o ponto de extremidade HTTPS que aceita cargas JSON e recebe solicitações POST do Teams.
- Descrição: uma cadeia de caracteres detalhada que aparece no cartão de perfil e no painel do aplicativo no nível da equipe.
- Imagem do perfil: um ícone de aplicativo para seu webhook, que é opcional.
- Selecione Criar. O Webhook de Saída é adicionado ao canal da equipe atual:
Uma caixa de diálogo Hash-based Message Authentication Code (HMAC) é exibida. É um token de segurança usado para autenticar chamadas entre o Teams e o serviço externo designado. O token de segurança do HMAC não expira e é exclusivo para cada configuração.
Observação
O Webhook de Saída estará 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.