Base de Conhecimento

Microsoft Teams no n8n: mensagens automáticas

  • microsoft teams, n8n, mensagens, automação, microsoft 365, webhook
  • Usuários acharam útil: 0

Registre o app no Microsoft Entra, crie a credencial Teams OAuth2, envie mensagens em canal e chat e veja o gatilho, os limites e o webhook do app Workflows.

Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Microsoft Teams no n8n: mensagens automáticas

Capa da Redação Eleven Host para o tutorial: Microsoft Teams no n8n: mensagens automáticas Arte: Eleven Host

Microsoft Teams no n8n significa mandar mensagem em canal ou chat por um nó do fluxo, mas exige conta corporativa ou escolar do Microsoft 365 e, em muitos casos, a ajuda do administrador da empresa para aprovar as permissões.

O Incoming Webhook antigo do Teams foi aposentado em maio de 2026. Para mensagens automáticas pelo n8n, use o nó Microsoft Teams com conta corporativa ou o webhook do app Workflows.

Atualizado em 17/11/2026. Em 17/11/2026, na versão estável n8n 2.48.4, publicada em 13/11/2026, o nó Microsoft Teams está na versão 2, a padrão, e existe também o Microsoft Teams Trigger.

O que o nó faz

O nó Microsoft Teams consome a API do Teams. Pelo campo Resource você escolhe o que mexer: Channel Message, Chat Message, Channel, Chat, Chat Member, Online Meeting, Task e Activity Notification. Em Channel Message e Chat Message há, entre outras, a operação Create, e só em Chat Message existe Send and Wait for Response.

Mais sobre servidores virtuais está na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Quem pode usar e o que esperar do administrador

O Microsoft Graph informa que conta pessoal da Microsoft não é suportada para enviar mensagem em canal nem em chat. Só vale conta corporativa ou escolar, do Microsoft 365 com Entra ID. O passo a passo da credencial do n8n manda marcar contas de organização e pessoais ao registrar o app, mas isso não faz o Teams pessoal funcionar.

O administrador também entra na história: vários escopos que o n8n pede exigem consentimento de administrador no Microsoft Entra, como ChannelMessage.Read.All e TeamMember.Read.All. Sem essa aprovação o login da credencial falha.

Onde o n8n roda

Só enviar mensagem não exige endereço público: o n8n chama o Graph de dentro para fora. Já o gatilho e o Send and Wait pedem endereço público, como mostram os passos 5 e 6, e a URL de retorno do login também usa o endereço do n8n. Quando o n8n fica numa VPS própria, o artigo O que é servidor VPS: guia simples para iniciantes explica o básico.

Passo 1: registrar o app no Microsoft Entra

Primeiro crie, no n8n, a credencial Microsoft Teams OAuth2 API, só para copiar a OAuth Callback URL. Depois acesse aka.ms/appregistrations e clique em Register an application. Preencha Name e Supported account types. Em Redirect URI (optional), escolha a plataforma Web e cole a URL copiada. Clique em Register.

Copie o Application (client) ID para o campo Client ID da credencial. Em Certificates & secrets, use + New client secret e Add, e copie o Value, não o ID do segredo, para o Client Secret.

Passo 2: a credencial e o consentimento

No campo Authentication do nó, a opção padrão é Teams OAuth2, e é a que recomendamos. A credencial Microsoft Teams OAuth2 API já traz uma lista de escopos, entre eles Chat.ReadWrite, ChannelMessage.ReadWrite e TeamsActivity.Send. Outra opção é o Service Principal (App-Only).

O Service Principal não envia mensagem: sem usuário logado, ficam indisponíveis as ações e os gatilhos de chat e também as operações Create, Reply, Delete e Undo Delete de Channel Message. Permissão de aplicação só vale para migração. Use a Teams OAuth2.

Clique em Connect my account. Os escopos são pedidos no login, tudo ou nada: se um deles não estiver aprovado, o login falha, por exemplo com o código AADSTS65004. Aprovar na página de permissões do app no Entra não destrava. O administrador aprova pelo próprio login, na opção "Consent on behalf of your organization", ou pelo fluxo de pedido de consentimento. Escopo novo pede nova aprovação e reconexão.

Passo 3: mensagem em um canal

Adicione o nó Microsoft Teams, com Resource Channel Message e operação Create. Preencha Team, por lista, por ID ou por From URL, e Channel. Depois escolha o Content Type, Text (o padrão) ou HTML, e escreva a Message.

O campo Mentions aceita pessoas e tags de equipe. Em Options há Mention Placement, com início ou fim da mensagem, e Reply to ID, para responder a uma mensagem; a operação Reply faz o mesmo e é mais fácil de achar. Com menções, o Teams trata a mensagem como HTML, e a quebra de linha pede <br>.

Passo 4: mensagem em um chat

Em Resource Chat Message e operação Create, informe o Chat, o Content Type e a Message. O chat precisa existir: a API de mensagens não cria chat novo.

Desligue o Include Link to Workflow

A opção Include Link to Workflow vem ligada e acrescenta no fim da mensagem um link para o fluxo. Em mensagem para clientes ou para uma equipe grande, recomendamos desligar: o link mostra o endereço do seu n8n.

Passo 5: pedir uma resposta com Send and Wait

A operação Send and Wait for Response existe só em Chat Message, não em canal. Ela manda a mensagem e pausa o fluxo até alguém responder. O Response Type pode ser Approval, Free Text ou Custom Form. Na aprovação, os botões "Approve" e "Decline" aparecem como links que abrem o n8n.

Por isso quem clica precisa alcançar o endereço do seu n8n, o que pede URL pública em HTTPS. No n8n instalado por você, defina a variável N8N_WEBHOOK_URL com o endereço público. Um exemplo: N8N_WEBHOOK_URL=https://n8n.exemplo.com/. Confira no seu servidor como a variável é aplicada e reinicie o n8n depois. A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0: ainda funciona, mas gera aviso na inicialização.

Passo 6: o Microsoft Teams Trigger

O gatilho tem os eventos New Channel, New Channel Message (o padrão), New Chat, New Chat Message e New Team Member. As opções Watch All Teams, Watch All Channels e Watch All Chats vêm desligadas, e você pode escolher Team, Channel ou Chat. Os eventos de chat não existem com a credencial Service Principal.

Ao publicar o fluxo, o n8n cria uma assinatura por recurso vigiado, e o Graph expira assinaturas do Teams em 3 dias. Desde o n8n 2.45.1 o gatilho renova sozinho, mas só com o n8n no ar. Antes dessa versão, era preciso despublicar e publicar de novo a cada 3 dias. Se a assinatura expirar com o n8n fora do ar, despublique e publique de novo. Uma falha de renovação por limite, token vencido ou consentimento revogado não é refeita e não gera execução com erro: só aparece no log.

O endereço precisa ser público e em HTTPS, com N8N_WEBHOOK_URL definida, como no passo anterior.

Limite de mensagens e erro 429

O Microsoft Graph limita o envio no Teams. Em canal, o limite é de 1 mensagem por segundo por canal e por usuário, e 50 por segundo por app em cada tenant. Em chat, é de 1 por segundo por chat e por usuário, e 20 por segundo por app em cada tenant.

Ao estourar, o Graph responde 429 Too Many Requests, com o cabeçalho Retry-After, que traz os segundos de espera. O nó do n8n não refaz a chamada sozinho. Recomendamos enviar em lotes de 1 com o nó Loop Over Items, colocar um Wait de 1 a 2 segundos entre as mensagens, ligar Retry On Fail nas configurações do nó e juntar vários avisos numa mensagem só. A Microsoft ainda lembra que usar o Teams como arquivo de log viola os termos de uso: envie só o que alguém vai ler.

Sem OAuth: o webhook do app Workflows

Os conectores do Office 365, incluindo o Incoming Webhook, pararam de funcionar no rollout final de 18 a 22 de maio de 2026. O substituto é o app Workflows: no canal, abra More options (...), escolha Workflows, use o modelo Send webhook alerts to a channel, configure, clique em Save e copie o link do webhook. O gatilho no Power Automate é "When a Teams webhook request is received".

Esse caminho aceita Adaptive Card e MessageCard, com limite de 28 KB por mensagem. O fluxo pertence a uma pessoa dona, e não ao canal: se ela sair, o fluxo fica órfão.

Um exemplo: no n8n, um nó HTTP Request com método POST envia um JSON com a Adaptive Card para a URL copiada. Confira o formato no seu ambiente antes de usar. Esse caminho não usa OAuth nem URL pública do n8n, mas só envia. Trate a URL como segredo.

Combinações para começar

Um exemplo: alerta de erro no canal. Um nó Webhook recebe o aviso do monitoramento, um IF separa os casos críticos, e o Channel Message Create envia em Content Type HTML, com menção à tag de plantão e sem o link do fluxo. Para ver outro destino de alertas, veja Slack no n8n: mensagens e alertas automáticos.

Um exemplo: aprovação de reembolso. Um formulário aciona o Send and Wait for Response em um chat do gestor, com Response Type Approval. Um IF segue para a cobrança ou o estorno se aprovado, e avisa no chat se for recusado.

Ordem do caminho

A ordem de preparo é conta corporativa, app no Entra, credencial e nó de envio, com o gatilho por último.

Ao lado de domínios e bancos de dados na nuvem, a Eleven Host tem VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja

Perguntas frequentes

Funciona com conta pessoal do Teams?

Não. O Microsoft Graph informa que conta pessoal não é suportada para enviar mensagem em canal ou em chat. É preciso conta corporativa ou escolar do Microsoft 365.

Posso mandar em canal com Send and Wait?

Não. A operação Send and Wait for Response existe só em Chat Message.

Ainda dá para usar o Incoming Webhook do canal?

Não. Os conectores do Office 365 pararam de funcionar no rollout de 18 a 22 de maio de 2026. A alternativa sem OAuth é o webhook do app Workflows.

Esta resposta lhe foi útil?

Artigos Relacionados