Integração: Enviar Mensagem no Slack
O nó Enviar Mensagem no Slack permite que seu workflow envie mensagens automáticas diretamente em canais ou para usuários do seu workspace Slack. Com ele, você pode notificar equipes sobre novos registros, alertar responsáveis sobre aprovações pendentes, comunicar resultados de processos e muito mais — tudo sem intervenção manual.
Ao contrário de nós como Aprovação ou Solicitar Resposta de Formulário, o nó Slack avança imediatamente após o envio da mensagem, sem aguardar interação do destinatário.
Pré-requisito: Configurar Conexão Slack
Para utilizar este nó, é necessário ter uma conexão Slack configurada no seu Space. A conexão é feita via OAuth, o que significa que você autoriza o Hashdata a enviar mensagens em nome do seu workspace de forma segura.
Existem duas formas de criar a conexão:
-
Pelo menu de Integrações: Acesse Configurações → Integrações → clique em Nova conexão → selecione Slack. Uma janela de autorizaç ão do Slack será exibida. Faça login na sua conta Slack, escolha o workspace e clique em Permitir. A conexão será salva e estará disponível para todos os workflows do Space.
-
Diretamente no painel do nó: Ao configurar o nó Enviar Mensagem no Slack no editor de workflow, clique no campo Conexão e selecione a opção Criar nova conexão. O popup de autorização OAuth será aberto sem que você precise sair do workflow. Após autorizar, a conexão é salva automaticamente no Space e já fica selecionada no nó.
Durante a criação da conexão, você precisará autorizar o app Hashdata no seu workspace Slack. Essa autorização é feita uma única vez por workspace. Apenas administradores do workspace Slack ou usuários com permissão para instalar apps podem concluir essa etapa. Caso você não tenha essa permissão, entre em contato com o administrador do seu Slack para solicitar a aprovação.
Configuração
Após adicionar o nó Enviar Mensagem no Slack ao canvas, clique sobre ele para abrir o painel de configuração. Preencha os campos conforme descrito abaixo.
| Campo | Descrição | Obrigatório |
|---|---|---|
| Conexão | Selecione a conexão Slack previamente configurada no Space. Se ainda não houver nenhuma, utilize a opção Criar nova conexão para autorizar agora. | Sim |
| Tipo de destinatário | Escolha entre Canal (envia a mensagem em um canal público ou privado do workspace) ou Usuário direto (envia como mensagem direta — DM — para um usuário específico). | Sim |
| Canal / Usuário | Selecione o canal ou o usuário de destino a partir da lista carregada automaticamente da sua conta Slack. A lista é populada com base na conexão selecionada. | Sim |
| Título da mensagem | Texto curto exibido como cabeçalho ou destaque da mensagem no Slack. Ideal para identificar rapidamente o assunto, por exemplo: Nova solicitação de compra recebida. | Sim |
| Conteúdo da mensagem | Corpo da mensagem enviada. Suporta texto livre e variáveis do workflow no formato {{nome_do_campo}} para incluir dados dinâmicos, como nome do solicitante, valor aprovado, data, entre outros. | Sim |
| Botões de ação (opcional) | No momento, o único botão de ação é "Editar resposta", que abrirá a resposta para ser alterada. | Não |
Use variáveis no formato {{nome_do_campo}} no título e no conteúdo da mensagem para torná-las dinâmicas e relevantes para cada instância do workflow. Por exemplo, se o seu formulário possui um campo chamado nome_solicitante, você pode escrever: Nova solicitação recebida de {{nome_solicitante}}. As variáveis disponíveis são todas as respostas coletadas em formulários anteriores no mesmo workflow.
Saídas do Nó
O nó Enviar Mensagem no Slack possui duas saídas possíveis no canvas, permitindo que você trate situações de sucesso e erro de forma independente:
Sucesso
A saída Sucesso é acionada quando a mensagem é enviada com êxito ao Slack. Isso ocorre quando a conexão está ativa, o destinatário (canal ou usuário) é válido e o app Hashdata possui as permissões necessárias no workspace.
A partir dessa saída, você pode conectar qualquer outro nó para continuar o fluxo — por exemplo, um nó Definir Status para registrar que a notificação foi enviada, ou um nó de Aprovação para aguardar uma decisão.
Erro
A saída Erro é acionada quando o envio da mensagem falha por qualquer motivo, como:
- A conexão Slack foi revogada ou expirou
- O canal selecionado foi excluído ou o bot foi removido
- O usuário de destino não existe mais no workspace
- Problemas temporários de conectividade com a API do Slack
Ao tratar a saída Erro, você pode, por exemplo, enviar uma notificação por email para o administrador do workflow, definir um status de falha na instância ou tentar uma rota alternativa.
Se um administrador do workspace Slack revogar as permissões do app Hashdata, todas as execuções futuras que utilizarem aquela conexão seguirão pela saída Erro. Para resolver, acesse Configurações → Integrações, remova a conexão com problema e crie uma nova conexão autorizada.
Exemplos de Uso
Notificação de nova solicitação
Um workflow com gatilho em formulário pode usar este nó para avisar automaticamente o canal #solicitacoes sempre que uma nova resposta for enviada. O conteúdo da mensagem pode incluir o nome do solicitante, o tipo de pedido e um link para visualizar a resposta completa.
Alerta de aprovação pendente
Após um nó de Aprovação ser criado, você pode adicionar um nó Enviar Mensagem no Slack antes dele para notificar os aprovadores pelo Slack — de forma complementar ao email — de que há uma aprovação aguardando a ação deles.
Confirmação de exportação
Em workflows que exportam dados para planilhas ou realizam chamadas a sistemas externos, utilize este nó ao final do fluxo para notificar o canal responsável de que o processo foi concluído com sucesso.
Dicas e Boas Práticas
- Prefira canais a usuários diretos para notificações de equipe, pois canais permitem que múltiplos membros acompanhem o processo sem depender de uma única pessoa.
- Use botões de ação quando quiser capturar uma decisão rápida no Slack sem exigir que o usuário acesse a plataforma Hashdata.
- Gerencie as conexões centralmente: uma mesma conexão Slack pode ser reutilizada em múltiplos workflows do Space, sem necessidade de reautorizar.
- Teste o nó antes de publicar o workflow, utilizando a função de execução de teste do editor, para garantir que a mensagem chega corretamente ao destino esperado.