M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Conectores do Teams e webhooks: status da desativação e como substituí-los por fluxos de trabalho

By ·

Os conectores do Office 365 e os webhooks de entrada baseados em conectores no Teams foram desativados em maio de 2026. Este guia explica o que deixou de funcionar, o que está substituindo esses recursos, como fazer a migração e onde o Workflows ainda apresenta diferenças.

Automatically translated with AI from the original post. Read the English original

Os conectores do Teams, incluindo o conector Incoming Webhook, deixaram de existir. A Microsoft Learn afirma que os conectores do Office 365 no Teams foram desativados em maio de 2026 e que, agora, a forma de receber solicitações de webhook e publicar no Teams é o aplicativo Workflows. Um fluxo de trabalho criado com o gatilho Quando uma solicitação de webhook do Teams é recebida substitui a URL antiga do conector.

Pontos-chave

  • Segundo a Microsoft Learn, os conectores do Office 365 no Teams, incluindo os webhooks de entrada baseados em conectores, foram desativados em maio de 2026. A janela final de implantação no blog de desenvolvedores foi de 18 a 22 de maio de 2026.
  • A substituição é o aplicativo Workflows no Teams, que é o Power Automate. Use o gatilho "Quando uma solicitação de webhook do Teams é recebida" ou um modelo pronto.
  • Um fluxo de trabalho tem sua própria URL de webhook, portanto, todos os sistemas que enviam mensagens precisam ser alterados para usá-la, porque a URL antiga do conector não funciona mais.
  • Os payloads MessageCard são renderizados, mas os botões HttpPost não funcionam. Use Adaptive Cards para conteúdo interativo.
  • Os fluxos de trabalho pertencem a um proprietário, não a um canal. Adicione coproprietários para que o fluxo não fique órfão quando o proprietário sair.

Este artigo explica o que foi desativado, o que substitui esses recursos, como fazer a migração e quais diferenças ainda podem causar problemas.

O que foi desativado e quando

A desativação durou quase dois anos, e a data mudou várias vezes. O blog de desenvolvedores do Microsoft 365 registra a sequência:

  • Julho de 2024: primeiro plano para bloquear novos conectores a partir de 15 de agosto de 2024 e interromper todos os conectores em 1º de outubro de 2024.
  • Julho de 2024: desativação adiada para dezembro de 2025.
  • Outubro de 2025: prazo de migração adiado para 31 de março de 2026.
  • Fevereiro de 2026: suporte a Message Card adicionado ao Workflows, e o bot do Workflows passou a poder publicar em canais compartilhados. O prazo foi adiado para 30 de abril de 2026.
  • 14 de abril de 2026 (atualização final): a implantação começa em 18 de maio de 2026 e é concluída em 22 de maio de 2026. Depois disso, os conectores deixam de funcionar.

Os itens afetados são os conectores do Office 365 no Teams, incluindo conectores baseados em webhook, como o Incoming Webhook, e conectores de terceiros que publicam em uma URL. O blog observa que a mudança de URL de webhook se aplica aos conectores baseados em webhook, não aos conectores de consulta, como o RSS.

Se algo ainda publica por meio de um conector antigo, trate-o como quebrado ou prestes a quebrar e planeje a migração agora.

O que substitui os conectores

A Microsoft indica três caminhos na Learn:

  1. Aplicativo Workflows (Power Automate) para webhooks de entrada. Use um modelo predefinido ou o gatilho Quando uma solicitação de webhook do Teams é recebida.
  2. O conector do Power Automate para ISVs e equipes de produto. A Microsoft Learn o descreve como a forma escalável e segura de mover dados para dentro e para fora do Teams de forma programática.
  3. Um app do Teams com mensagens proativas, para que os usuários possam configurar mensagens com base em eventos de gatilho do seu sistema.

Para a maioria dos administradores e de quem escreve scripts, o caminho 1 é a substituição direta.

Como migrar um webhook para Workflows

A página de suporte da Microsoft sobre webhooks de entrada não pôde ser lida no momento em que este artigo foi preparado, então os passos abaixo seguem o blog de desenvolvedores e a referência do conector na Learn.

  1. Liste todos os conectores em uso. Verifique os canais que usavam Gerenciar canal > Conectores e os sistemas que enviam alertas, como ferramentas de monitoramento, build ou tickets.
  2. No Teams, abra o app Workflows. O blog de desenvolvedores informa que também é possível abri-lo a partir de um chat ou canal, em Mais opções (...).
  3. Escolha um modelo de webhook predefinido ou comece do zero com o gatilho Quando uma solicitação de webhook do Teams é recebida.
  4. Selecione a equipe e o canal, salve e copie a URL do gatilho a partir do fluxo de trabalho no Power Automate.
  5. Substitua a URL antiga do conector no sistema de envio pela nova.
  6. Dê nome, descreva e teste o fluxo de trabalho e adicione coproprietários.
  7. Envie um POST de teste e confirme que a mensagem aparece.

O gatilho aceita apenas solicitações POST. A referência do conector na Learn informa que solicitações GET não são suportadas.

Formato do payload e cartões

O corpo do gatilho pode conter um array de Adaptive Cards. A referência mostra uma mensagem com um array attachments cujo contentType é application/vnd.microsoft.card.adaptive. Um único corpo de Message Card também é aceito.

Tenha em mente estes pontos:

  • Os Adaptive Cards são a forma suportada de criar conteúdo interativo.
  • Payloads de MessageCard são renderizados, mas os botões que usam HttpPost não funcionam. O blog de desenvolvedores recomenda migrar para Adaptive Cards se você usar elementos interativos de cartão.

Controle de acesso

Uma melhoria real: o gatilho tem uma configuração de autenticação. A Learn lista três opções.

| Configuração | O que o remetente precisa fazer | |---|---| | Qualquer pessoa | Não enviar cabeçalho de token de autenticação, ou a solicitação falha | | Qualquer usuário do meu locatário | Enviar um token de autenticação | | Usuários específicos do meu locatário | Enviar um token de autenticação, e o usuário precisa estar na lista de permitidos |

Para as opções de locatário, a Learn aponta para o seu guia sobre autenticação OAuth para gatilhos de solicitação HTTP. Se uma ferramenta só consegue enviar um POST simples para uma URL, ela precisa da configuração Qualquer pessoa. Nesse caso, trate a URL como um segredo.

Diferenças em relação ao conector antigo

Planeje estes pontos antes de fazer a troca.

  • Identidade do remetente. A atualização de abril de 2026 do blog de desenvolvedores informa que a personalização do ícone e do nome do bot não está disponível para publicações via webhook. As mensagens exibem a identidade padrão do bot de Workflows.
  • Propriedade. A Learn informa que os fluxos de trabalho são vinculados a proprietários, não a uma equipe ou canal. Se o proprietário sair e não houver coproprietário, o fluxo pode ficar órfão. Adicione coproprietários com controle total.
  • Limites. A referência da Learn indica cerca de 1.000 chamadas de entrada simultâneas para o gatilho e um limite de 28 KB para a ação Publicar adaptive card em um chat ou canal. Payloads maiores retornam o erro "Request Entity too large".
  • Canais privados. As fontes divergem. O blog de desenvolvedores informa que a seleção de canais privados no app Workflows estava programada para ser totalmente disponibilizada até 20 de abril de 2026. Uma página da Learn afirma que os webhooks de Workflows oferecem suporte a canais privados, e outra página da Learn descreve o suporte a canais privados como em desenvolvimento. A referência do conector do Microsoft Teams ainda diz que publicar uma mensagem ou cartão em um canal privado não é suportado atualmente. Teste o canal de destino antes de depender dele.

Erros comuns

  • Migrar apenas o canal e esquecer de alterar a URL no sistema de envio.
  • Deixar uma única pessoa como única proprietária do fluxo de trabalho.
  • Enviar um token para um gatilho configurado como Qualquer pessoa.
  • Manter os botões de MessageCard e esperar que os callbacks funcionem.
  • Presumir que o nome e o ícone antigos do bot são mantidos.

Relacionados

Fontes

Seguir o podcastApple PodcastsSpotify

Perguntas frequentes

Os conectores do Teams ainda funcionam?

Não. A Microsoft Learn afirma que os conectores do Office 365 no Teams, incluindo os webhooks de entrada baseados em conectores, foram desativados em maio de 2026. O blog de desenvolvedores do Microsoft 365 indicou de 18 a 22 de maio de 2026 como a janela final de implantação e afirma que os webhooks precisavam ser migrados antes do início dela.

O que substitui o conector Incoming Webhook no Teams?

O aplicativo Workflows, que roda no Power Automate. De acordo com a Microsoft Learn, você pode usar um modelo predefinido que publica em um chat ou canal quando uma solicitação de webhook é recebida, ou criar um fluxo do zero com o gatilho "Quando uma solicitação de webhook do Teams é recebida".

Preciso de uma nova URL para minha ferramenta de monitoramento ou script?

Sim. Um fluxo de trabalho tem sua própria URL de gatilho, e a referência do conector descreve o gatilho como iniciado por uma solicitação POST para esse endpoint. As páginas que li não informam onde a URL é exibida, então abra o gatilho do fluxo de trabalho no Power Automate para copiá-la. Cole-a no sistema que envia a solicitação POST.

O webhook do Workflows pode publicar botões que chamam de volta o meu sistema?

Não com MessageCard. O blog de desenvolvedores diz que o MessageCard renderiza conteúdo, mas não oferece suporte a botões de ação HttpPost. Para elementos interativos, a Microsoft indica os Adaptive Cards, e a Learn afirma que você precisa configurar o fluxo de trabalho para tratar as respostas.

Quem pode enviar solicitações para um webhook de fluxo de trabalho?

Você escolhe. A referência do conector Microsoft Teams na Learn lista três opções: qualquer pessoa, qualquer usuário do seu locatário ou usuários específicos do seu locatário. Para as opções de locatário, as solicitações precisam incluir um token de autenticação. Para "Qualquer pessoa", não envie nenhum.

Entities in this article

Temas deste artigo:

Microsoft Teams – Ferramenta de colaboração da Microsoft Power Automate – Ferramenta low-code da Microsoft Conector – Conceito Adaptive Cards – Produto

Related articles

Mais artigos sobre Microsoft Teams:

RSS