Criar webhooks recebidos com Fluxos de Trabalho para o Microsoft Teams

Um Webhook recebido permite que as aplicações externas partilhem conteúdos em chats e canais no Microsoft Teams. Os webhooks são utilizados como ferramentas para controlar e notificar. Pode publicar num canal ou chat quando é recebido um pedido de webhook.

Configurar um fluxo de trabalho de webhook recebido a partir de um modelo

Selecione Mais opções Ícone de mais opções do Microsoft Teamsjunto ao canal ou chat para o qual pretende criar um fluxo de trabalho e, em seguida, selecione Fluxos de trabalho Logótipo do fluxo de trabalho.  

Consoante pretenda que o webhook publique numa conversa ou canal, selecione o modelo de webhook mais adequado às suas necessidades. Cada modelo tem um tipo de autenticação diferente.

Modelos de webhook de chat

  • Publicar numa conversa quando um pedido de webhook é recebido

  • Publicar numa conversa quando um pedido de webhook é recebido de utilizadores específicos

  • Publicar numa conversa quando um pedido de webhook é recebido de utilizadores no meu inquilino

Modelos de webhook de canal

  • Publicar num canal quando um pedido de webhook é recebido

  • Publicar num canal quando um pedido de webhook é recebido de utilizadores específicos

  • Publicar num canal quando um pedido de webhook é recebido de utilizadores no meu inquilino

Captura de ecrã a mostrar modelos de fluxo de trabalho

O modelo de webhook Publicar numa conversa quando um pedido de webhook é recebido pode não estar disponível consoante o tipo de organização. Para obter mais ajuda, contacte o administrador de TI.

Assim que o fluxo de trabalho for aberto, pode alterar o respetivo nome.

Também terá de autenticar com a sua conta para que os seus fluxos de trabalho publiquem no canal ou chat. Se quiser escolher uma conta diferente para autenticar, selecione Mudar de conta Ícone de mais opções do Microsoft Teamse escolha a conta que pretende utilizar.

Quando terminar de atualizar o nome e tiver a conta correta autenticada, selecione Seguinte.

Captura de ecrã a mostrar a opção mudar o nome do fluxo de trabalho e alterar a opção de conta

Na página seguinte, poderá escolher a Equipa, Canal ou Chat na qual esta notificação será publicada. Tenha em atenção que se estiver a utilizar este fluxo de trabalho a partir de uma conversa ou canal, estes campos serão preenchidos automaticamente. Depois de preencher os detalhes necessários, selecione Adicionar fluxo de trabalho.

Assim que o fluxo de trabalho for criado, verá uma nova caixa de diálogo com o URL que pode copiar.

Captura de ecrã a mostrar uma confirmação de que foi adicionado um fluxo de trabalho.

Se alguma vez precisar de copiar novamente o URL do fluxo de trabalho, poderá encontrá-lo ao abrir a aplicação Fluxos de Trabalho no Teams, selecionar o fluxo de trabalho que foi criado, selecionar Editar Ícone de edição do Fluent 2 pequenoe expandir o acionador Quando é recebido um pedido de webhook do Teams. ​​​​​​​

Captura de ecrã a mostrar onde copiar um fluxo de trabalho específico na aplicação Fluxos de Trabalho.

Configurar um fluxo de trabalho de webhook de entrada do zero

Captura de ecrã a mostrar onde encontrar modelos em branco para fluxos de trabalho

  1. Selecione Ver mais aplicações Ícone de mais opções do Microsoft Teamsno lado esquerdo do Teams e, em seguida, abra Fluxos de Trabalho Logótipo do fluxo de trabalho.

  2. Aceda ao separador Criar e selecione Criar do zero junto à barra de pesquisa.

  3. Utilize a barra de pesquisa para procurar o acionador Quando é recebido um pedido de webhook do Teams e selecione-o.

  4. Escolha quem pode acionar o fluxo (tipo de autenticação). Pode escolher entre três tipos de autenticação diferentes:

    1. Qualquer pessoa (esta opção não é autenticada)

    2. Qualquer utilizador no meu inquilino

    3. Utilizadores específicos no meu inquilino

  5. Agora, terá de adicionar uma ação ao fluxo de trabalho. Selecione Novo passo e escolha a ação Publicar cartão no chat ou canal que vem do conector do Teams. 

  6. Agora, irá escolher onde as informações do webhook são publicadas. Selecione o campo pendente Publicar em e selecione a localização. Depois de escolher a localização do canal, chat de grupo ou chat com o flow bot, preencha os outros campos necessários.

  7. Selecione Guardar abaixo do fluxo de trabalho. Depois de guardado, pode regressar à caixa Quando um webhook do Teams é recebido e copiar o URL HTTP POST.

Ao configurar o acionador de webhook, pode adicionar condições opcionais. Aceda ao Menu de acionador Ícone de mais opções do Microsoft Teamse selecione Definições Botão Definições. Desloque-se para a parte inferior e selecione Adicionar Ícone de cruz na parte superior do ecrãna secção Condições do Acionador . Este passo é opcional e não é necessário para que o fluxo de trabalho seja executado.

Saiba mais

Documentação do programador para o conector do webhook do Teams

Procurar e adicionar fluxos de trabalho no Microsoft Teams

​​​​​​​Adicionar ou executar um fluxo de trabalho a partir de uma mensagem

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.