Integração: Enviar Mensagem no Microsoft Teams

O nó Enviar Mensagem no Microsoft Teams permite que seu workflow envie mensagens automáticas diretamente em canais de equipes do Microsoft Teams. Utilize esse nó para notificar times, comunicar resultados de aprovações, alertar sobre novas respostas de formulários ou qualquer outro evento relevante do seu processo — tudo sem precisar sair da plataforma Hashdata.

Com esse nó, você mantém as equipes informadas em tempo real, reduzindo atrasos na comunicação e centralizando as notificações nos canais onde as pessoas já trabalham.

Pré-requisito: Configurar Conexão Teams

Antes de utilizar o nó Enviar Mensagem no Microsoft Teams, é necessário configurar uma conexão com sua conta Microsoft 365 pelo fluxo OAuth. Siga os passos abaixo:

1. Acesse Configurações no menu lateral da plataforma.
2. Clique em Integrações.
3. Clique em Nova conexão e selecione Microsoft Teams.
4. Uma janela de autorização da Microsoft será aberta. Faça login com a conta Microsoft 365 que possui acesso às equipes e canais desejados.
5. Conceda as permissões solicitadas para que a Hashdata possa enviar mensagens em nome da conta.
6. Após a autorização, a conexão aparecerá na lista de integrações disponíveis.

Autorização da conta Microsoft 365

A conta Microsoft 365 utilizada na conexão precisa ter permissão para postar mensagens nos canais das equipes que você deseja utilizar no workflow. Conexões criadas por um usuário ficam disponíveis para todos os workflows do mesmo space. Caso a conexão expire ou seja revogada, as instâncias em andamento que tentarem executar o nó falharão — renove a conexão na página de integrações quando necessário.

Configuração do Nó

Ao adicionar o nó Enviar Mensagem no Microsoft Teams ao canvas do workflow, o painel lateral exibirá os campos de configuração abaixo.

Campo	Descrição	Obrigatório
Conexão	Selecione a conexão Teams configurada nas integrações do space. A conexão define qual conta Microsoft 365 será usada para enviar as mensagens.	Sim
Equipe	Selecione a equipe do Microsoft Teams onde a mensagem será enviada. A lista de equipes é carregada automaticamente a partir da conta conectada.	Sim
Canal	Selecione o canal dentro da equipe escolhida. Após selecionar a equipe, os canais disponíveis são carregados automaticamente.	Sim
Título da mensagem	Texto exibido como título no card da mensagem enviada ao Teams. Suporta o uso de {{variável}} para personalização dinâmica.	Sim
Conteúdo da mensagem	Corpo da mensagem enviada ao canal. Suporta o uso de {{variável}} para incluir dados do formulário ou de etapas anteriores do workflow.	Sim
Botões de ação	Adicione botões interativos à mensagem (opcional). Cada botão possui um rótulo e uma URL de destino. Use botões para direcionar os destinatários a formulários, links de aprovação ou páginas externas.	Não

Use variáveis para personalizar as mensagens

Nos campos Título e Conteúdo você pode referenciar respostas de formulários e dados de etapas anteriores usando a sintaxe {{nome_do_campo}}. Por exemplo: Nova solicitação de {{nome_do_solicitante}} recebida em {{data_da_resposta}}. Clique no ícone de variáveis dentro do campo para visualizar todas as variáveis disponíveis para aquele ponto do workflow.

Saídas do Nó

O nó Enviar Mensagem no Microsoft Teams possui duas saídas possíveis no canvas, permitindo que você trate cada cenário de forma independente:

Saída	Quando ocorre	O que fazer
Sucesso	A mensagem foi enviada com êxito ao canal do Teams configurado.	Continue o fluxo normalmente com os próximos nós do workflow.
Erro	Falha no envio da mensagem. Pode ocorrer por conexão expirada, permissões insuficientes, canal removido ou instabilidade temporária da API da Microsoft.	Conecte um nó de Enviar E-mail ou Definir Status para registrar o erro ou notificar um responsável. Verifique também a validade da conexão nas integrações.

Ao conectar nós às duas saídas, seu workflow permanece robusto mesmo em situações de falha na integração com o Teams.

Diferença em Relação ao Slack

Embora o nó Enviar Mensagem no Slack e o nó Enviar Mensagem no Microsoft Teams cumpram funções similares, existe uma diferença importante na estrutura de destino da mensagem:

Aspecto	Slack	Microsoft Teams
Estrutura de destino	Canal ou usuário direto (um nível de seleção)	Equipe → Canal (dois níveis de seleção obrigatórios)
Autenticação	OAuth com conta Slack	OAuth com conta Microsoft 365
Mensagem direta para usuário	Suportado (tipo "usuário")	Não disponível neste nó (apenas canais de equipe)
Botões de ação	Suportado (opcional)	Suportado (opcional)

No Teams, toda mensagem é publicada dentro de um canal, que por sua vez pertence a uma equipe. Isso significa que você sempre precisará selecionar os dois níveis — equipe e canal — antes de configurar o conteúdo da mensagem. No Slack, você pode enviar a mensagem diretamente para um canal ou para um usuário específico, sem a camada de "equipe".

Essa hierarquia adicional do Teams reflete a própria organização da plataforma da Microsoft e é importante considerar ao desenhar seus workflows: certifique-se de que a equipe e o canal selecionados existem e estão acessíveis pela conta conectada.

Exemplo de Uso

Imagine um workflow de aprovação de despesas onde, após a aprovação pelo gestor, é necessário notificar o time financeiro no Teams. Você pode:

1. Iniciar o workflow com o nó Gatilho: Resposta de Formulário (formulário de solicitação de despesa).
2. Adicionar um nó Aprovação para o gestor revisar.
3. Conectar a saída de aprovação ao nó Enviar Mensagem no Microsoft Teams.
4. Configurar o nó para enviar ao canal #financeiro da equipe Financeiro e Contabilidade com o título Despesa aprovada: {{titulo_da_despesa}} e o conteúdo incluindo os detalhes da solicitação via variáveis.
5. Tratar a saída Erro com um nó Enviar E-mail para notificar o administrador caso o envio ao Teams falhe.

Dessa forma, o time financeiro é notificado automaticamente no canal correto, sem necessidade de ação manual após a aprovação.