Criar Webhooks de entrada

Importante

Os Conectores do Microsoft 365 (anteriormente denominados conectores Office 365) estão prestes a descontinuar e a criação de novos Conectores do Microsoft 365 será bloqueada em breve. Para obter mais informações sobre a agenda e como a aplicação Fluxos de Trabalho fornece uma experiência mais flexível e segura, veja Descontinuação dos conectores do Microsoft 365 no Microsoft Teams.

Como pode criar um webhook no Teams?

Se já tiver criado Office 365 Conectores:

  • Criar um conector do Power Automate: o Power Automate melhora as aplicações de Fluxos de Trabalho amplamente utilizadas no Teams. É a abordagem dimensionável e segura para transmitir dados através de programação para dentro e para fora do Teams. Se adotar este método, pode criar modelos de fluxo de trabalho para publicar alertas do seu produto em canais do Teams. Esta abordagem simplifica a adoção pelo utilizador do novo método. Para obter mais informações, veja Power Automate para programadores empresariais, ISVs e parceiros.

  • Atualizar a sua aplicação Teams: pode melhorar a sua aplicação teams atual. Por exemplo, pode permitir que os utilizadores configurem mensagens proativas com base em eventos de acionador no seu sistema. Para obter mais informações, veja como os bots podem publicar em canais através de mensagens proativas.

Problemas conhecidos

  • A aplicação de fluxos de trabalho não pode publicar em canais privados como um bot de fluxo. No entanto, pode publicar em nome de um utilizador.
  • Os fluxos de trabalho suportam apenas Cartões Ajustáveis. Não suporta a mensagem mais antiga card formato que os Conectores Office 365 utilizam. O suporte para a utilização de mensagens card formato em Fluxos de Trabalho fica disponível a partir de meados de outubro. Para obter mais informações, veja como converter mensagens de conector card formato em Cartão Ajustável.
  • Os fluxos de trabalho não oferecem conectores de terceiros, como o DataDog e o Jenkins.
  • Os fluxos de trabalho só podem ser criados no seu ambiente predefinido.

Limites

Os fluxos de trabalho estão ligados apenas a utilizadores específicos (referidos como proprietários do fluxo de trabalho) e não a uma equipa ou canal do Teams. Os fluxos de trabalho podem tornar-se fluxos órfãos na ausência de um proprietário se não forem atribuídos coproprietários. Para manter a continuidade no processo de negócio automatizado pelo fluxo, os administradores podem adicionar um ou mais coproprietários e conceder-lhes controlo total sobre o fluxo de trabalho. Também podem adicionar autenticação para ligações, se existirem, e ativar o fluxo se este tiver sido desativado. Para obter mais informações, veja Gerir fluxos órfãos.

Um Webhook recebido permite que as aplicações externas partilhem conteúdos em canais do Microsoft Teams. Os webhooks são usados como ferramentas para rastrear e notificar. Os webhooks fornecem um URL exclusivo para enviar um payload JSON com uma mensagem no formato card. Os cartões são contentores de interface de utilizador que incluem conteúdo e ações relacionadas com um único artigo. Você pode usar os cartões nos seguintes recursos:

  • Bots
  • Extensões de mensagens
  • Conectores

Observação

  • O limite de tamanho da mensagem é de 28 KB. Quando o tamanho exceder os 28 KB, receberá um erro. Para obter mais informações, consulte Limites e especificações do Microsoft Teams.
  • Se mais de quatro solicitações forem feitas em um segundo, a conexão do cliente será limitada até que a janela seja atualizada durante a taxa fixa. Uma lógica de repetição com um recuo exponencial pode mitigar a limitação de taxa para casos em que os pedidos excedem os limites num segundo. Para evitar atingir os limites de taxa, veja Respostas HTTP 429.

Principais funcionalidades dos Webhooks recebidos

A tabela a seguir fornece os recursos e a descrição de um Webhook de Entrada:

Recursos Descrição
Envie cartões adaptáveis usando um Webhook de Entrada Cartões Adaptáveis pode ser enviado por meio de Webhooks de Entrada. Para obter mais informações, consulte Enviar Cartões Adaptáveis usando Webhooks de Entrada.
Suporte a mensagens acionáveis Os cartões de mensagens acionáveis são suportados em todos os grupos do Microsoft 365, incluindo o Teams. Se você enviar mensagens por meio de cartões, deverá usar o formato de cartão de mensagem acionável. Para obter mais informações, veja Mensagens acionáveis legadas card referência e mensagens card playground.
Suporte independente a mensagens HTTPS Os cartões fornecem informações de forma clara e consistente. Qualquer ferramenta ou estrutura que possa enviar solicitações HTTPS POST pode enviar mensagens para o Teams por meio de um Webhook de Entrada.
Markdown compatível Todos os campos de texto em cartões de mensagens acionáveis suportam Markdown básico. Não use a marcação HTML em seus cartões. O HTML será ignorado e tratado como texto sem formatação.
Configuração com escopo Um Webhook recebido está no âmbito e configurado ao nível do canal.
Definições de recursos seguros As mensagens são formatadas como cargas JSON. Essa estrutura declarativa de mensagens impede a inserção de código mal-intencionado.

Observação

  • Bots do Teams, extensões de mensagens, Webhook de entrada e Bot Framework suporte a Cartões Adaptáveis. O Cartão Ajustável é uma arquitetura de plataforma de card aberta que é utilizada em todas as plataformas, como Windows, Android e iOS. Os conectores do Teams não suportam Cartões Ajustáveis. No entando, é impossível criar um fluxo que publicam Cartões Adaptáveis para um canal Teams.
  • Para mais informações sobre cartões e webhooks, veja Cartões Adaptáveis e Webhooks de Entrada.

Criar um webhook de entrada

Para adicionar um Webhook de Entrada a um canal do Teams, siga as seguintes etapas:

  1. No cliente Do Novo Teams, selecione Teams e navegue para o canal onde pretende adicionar um Webhook recebido.

  2. Selecione Mais opções ••• no lado direito do nome do canal.

  3. Selecione Gerir canal.

    Captura de ecrã a mostrar a opção Gerir canal em Mais opções para o Teams 2.1.

    Para os membros que não são administradores do canal, a opção Gerir canal está disponível na opção Abrir detalhes do canal no canto superior direito de um canal.

    Captura de ecrã a mostrar a opção Gerir canal para utilizadores não administradores.

  4. Selecione Editar.

    Captura de ecrã a mostrar a opção de edição em A opção Conectores para adicionar um Webhook recebido.

  5. Pesquise para Webhook de Entrada e selecione Adicionar.

    Captura de ecrã a mostrar a opção Adicionar para adicionar um Webhook recebido.

    É apresentada a caixa de diálogo Webhook recebido.

  6. Selecione Adicionar.

    Captura de ecrã a mostrar a opção Adicionar na caixa de diálogo Webhook Recebido.

    Observação

    Se já tiver adicionado um Webhook de Receção, é apresentada a opção Configurar . Selecione Configurar para criar um Webhook recebido.

  7. Indique um nome para o webhook e carregue uma imagem, se necessário.

  8. Selecione Criar.

    Captura de ecrã a mostrar os campos de nome e imagem a preencher para criar o webhook.

  9. Copie e guarde o URL de webhook exclusivo presente na caixa de diálogo. A URL mapeia o canal e você pode usá-la para enviar informações ao Teams.

  10. Selecione Concluído. O webhook está agora disponível no canal do Teams.

    Captura de ecrã a mostrar o URL de webhook exclusivo.

A representação gráfica seguinte fornece os passos para criar um Webhook recebido:

A representação gráfica mostra os passos para criar um Webhook recebido.

Importante

Pode criar uma aplicação do Teams de bot de notificação com o Teams Toolkit que não seja um Webhook recebido. Funcionam da mesma forma, mas o bot de notificação tem mais funcionalidades. Para obter mais informações, veja Build notification bot with JavaScript or Incoming Webhook notification sample (Compilar o bot de notificação com JavaScript ou o Exemplo de notificação de Webhook recebido).

Pode criar e enviar mensagens acionáveis através de um Webhook ou conector recebido para Grupos do Microsoft 365. Para obter mais informações, consulte Criar e enviar mensagens.

Observação

No Teams, selecione Definições>Permitir aos membros> criar, atualizar, e remover conectores, para que qualquer membro da equipe possa adicionar, modificar ou excluir um conector.

Exemplo

Referência de código de exemplo

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

Remover Webhooks recebidos

Para remover um Webhook de Entrada de um canal do Teams, siga as seguintes etapas:

  1. No cliente Novo Teams, selecione o ícone do Teams e navegue para o canal onde pretende remover um Webhook recebido.

  2. Selecione Mais opções ••• no lado direito do nome do canal.

  3. Selecione Gerir canal.

    Captura de ecrã a mostrar a opção Gerir canal em Mais opções.

  4. Selecione Editar.

    Captura de ecrã a mostrar a opção editar na opção Conectores.

  5. No painel esquerdo, selecione Configurado.

  6. Em Webhook recebido, selecione 1 Configurado.

    Captura de ecrã a mostrar como configurar para ver a lista dos conectores.

  7. Selecione Gerenciar.

    Captura de ecrã a mostrar como gerir o conector que pretende remover.

  8. Selecione Remover.

    Selecionar remover

    É apresentada a caixa de diálogo Remover Configuração.

  9. Selecione as caixas de verificação necessárias.

  10. Selecione Remover.

    Captura de ecrã a mostrar como remover um Webhook recebido do canal do Teams.

O webhook foi removido do canal do Teams.

Exemplo de código

Nome do exemplo Descrição .NET Node.js
Webhook de entrada Este exemplo mostra como implementar e utilizar um Webhook recebido. View Exibir

Confira também