Desbloqueando a Automação Verdadeira: Um Guia Prático para Conectar DecisionRules e N8N
Em um negócio moderno, sua lógica de decisão não pode viver isolada. Você precisa de uma maneira de conectar suas poderosas regras orientadas a negócios no DecisionRules ao restante de sua pilha tecnológica—para enviar notificações, acionar aprovações e orquestrar fluxos de trabalho complexos e multi-sistemas. Este é o poder das plataformas de automação, e a boa notícia é que conectá-las ao DecisionRules é incrivelmente simples.
Como o DecisionRules é uma plataforma orientada a API, qualquer ferramenta de automação que possa fazer uma chamada padrão de API REST é instantaneamente compatível.
Neste guia prático, passo a passo, vamos nos concentrar em uma das plataformas mais populares e flexíveis disponíveis hoje, N8N. Vamos guiá-lo por dois padrões essenciais para construir um poderoso fluxo de automação:
- Executando uma regra do DecisionRules a partir do N8N para automatizar notificações.
- Acionando um fluxo de trabalho N8N para gerenciar um processo de aprovação humana.
Ao final deste tutorial, você será capaz de construir fluxos de trabalho de decisão automatizados sofisticados que conectam a lógica de negócios à ação do mundo real.
O Caso de Uso: Um Fluxo de Trabalho de Aprovação de AML Automatizado
Para tornar isso prático, usaremos um exemplo comum e poderoso do mundo real: um processo de triagem de Lavagem de Dinheiro (AML).
Nossa regra do DecisionRules analisará uma transação financeira e a classificará em uma das três categorias: Aprovada Automaticamente, Marcada para Revisão ou Escalar para Conformidade. Enquanto "Aprovada Automaticamente" é um caso fechado, os outros dois resultados exigem que um humano tome a decisão final. Este processo de aprovação "humano no loop" é uma tarefa perfeita para uma plataforma de automação.
Padrão 1: Executando uma Decisão do N8N
Nosso primeiro objetivo é construir um fluxo de trabalho que comece no N8N, chame nossa regra de AML no DecisionRules e, em seguida, encaminhe automaticamente a decisão para o lugar certo—neste caso, enviando uma notificação por e-mail se a transação precisar de revisão.
Vamos construir isso passo a passo. Em seu canvas do N8N, comece com um gatilho manual ("Ao clicar em 'Executar fluxo de trabalho'") e adicione um nó de Solicitação HTTP. Você tem duas maneiras fáceis de configurá-lo:
Passo 1: Configurar o Nó de Solicitação HTTP
Em seu canvas do N8N, comece com um gatilho manual ("Ao clicar em 'Executar fluxo de trabalho'") e adicione um Nó de Solicitação HTTP. Este nó será responsável por se comunicar com a API do DecisionRules. Você tem duas maneiras fáceis de configurá-lo.
Opção A: A Configuração em 10 Segundos (Importar cURL)
Este é o método mais rápido. No Testbench do DecisionRules para sua regra, clique no botão "cURL" para copiar a solicitação. Em seguida, no nó de Solicitação HTTP do N8N, basta clicar em "Importar cURL" e colar. Tudo, a URL, cabeçalhos e corpo, será configurado para você.
Opção B: Configuração Manual
Se você preferir configurá-lo manualmente, configure os seguintes parâmetros:
Método: POST
- URL: A URL da "Solve API" para sua regra (encontrada no DecisionRules).
- Enviar Cabeçalhos: Ativar.
- Nome do Cabeçalho: Autorização
- Valor do Cabeçalho: Bearer
Passo 2: Fornecer os Dados de Entrada (O Corpo)
A última parte da configuração da Solicitação HTTP é o Corpo. Estes são os dados de entrada que você deseja que o DecisionRules analise. A API espera esses dados como um objeto JSON, envolto dentro de um objeto pai chamado "data".
No nó do N8N, vá para a Corpo seção e cole seu JSON de entrada. Para nosso exemplo de AML, ele ficará assim:
Passo 3: Criar um Caminho Condicional com o Nó IF
Agora que você tem uma decisão do DecisionRules visualizada no painel direito, é hora de fazer seu fluxo de trabalho agir sobre isso. Usaremos o poderoso nó IF do N8N para criar uma bifurcação no caminho, enviando o fluxo de trabalho por um caminho diferente com base no resultado da regra.
- Adicione um nó IF ao seu canvas e conecte-o à saída do nó de Solicitação HTTP.
- Nas Condições do nó IF, precisamos dizer o que procurar nos dados que recebeu do DecisionRules. Usaremos uma expressão para inspecionar a saída JSON. Para nossa regra de AML, se o objeto de saída for chamado Escalation e tiver uma propriedade chamada escalate, a expressão seria: {{ $json.Escalation.escalate }}
- Defina o restante da condição para verificar se esse valor é verdadeiro. Sua configuração deve parecer exatamente assim:
Seu fluxo de trabalho agora tem dois caminhos distintos que se ramificam do nó IF: um caminho "verdadeiro" para quando uma transação precisa ser escalada, e um caminho "falso" para todos os outros resultados.
Passo 4: Definir a Ação
O passo final é definir o que acontece quando a condição de escalonamento é atendida.
- Adicione um Enviar E-mail nó ao seu canvas.
- Crucialmente, conecte a saída "verdadeira" do nó IF à entrada do nó Enviar E-mail. Isso garante que um e-mail seja enviado apenas quando a condição de escalonamento for atendida.
- Configure o nó Enviar E-mail com o destinatário, assunto e corpo do alerta. Você pode até puxar dados da saída do DecisionRules (como um ID de transação ou nome do cliente) para criar notificações dinâmicas e ricas em contexto.
Embora estejamos usando o nó genérico Enviar E-mail, o N8N possui nós dedicados para Gmail, Slack e Microsoft Teams que oferecem uma integração ainda mais profunda para suas ferramentas específicas.
Padrão 2: Acionando um Fluxo de Trabalho de Aprovação N8N a partir do DecisionRules
Agora vamos inverter o fluxo. E se um processo de decisão, iniciado a partir de qualquer uma de suas aplicações, precisar iniciar um fluxo de trabalho de aprovação humana? Neste padrão, o DecisionRules atua como o "cérebro", identificando a necessidade de uma escalonamento, e o N8N atua como as "mãos", orquestrando o processo de aprovação em múltiplas etapas.
Nosso objetivo é configurar nosso fluxo do DecisionRules para fazer uma chamada de API REST para um webhook do N8N, mas apenas quando nossa regra de AML determinar que uma transação precisa de revisão.
Este diagrama ilustra o fluxo: uma ferramenta externa chama o DecisionRules, que avalia os dados. Se uma escalonamento for necessária, ela aciona o N8N para iniciar o processo de aprovação.
Passo 1: Construir o Fluxo de Trabalho de Recepção no N8N
Antes que o DecisionRules possa acionar qualquer coisa, precisamos construir o fluxo de trabalho do N8N que irá escutar o acionador.
- Em um novo canvas do N8N, seu primeiro nó será o Gatilho Webhook. Quando você adicionar este nó, o N8N gera automaticamente uma URL única para ele. Esta URL é o endpoint que o DecisionRules chamará. Copie esta URL agora; você precisará dela na próxima etapa.
- Conecte o Webhook aos nós que definem seu processo de aprovação. O fluxo de trabalho mostrado acima é um exemplo clássico:
- EnviarEEsperar e-mail: Este nó envia um e-mail para um aprovador com links de "Aprovar" e "Rejeitar". O fluxo de trabalho então pausa, aguardando que o usuário clique em um dos links.
- Atualizar linhas em uma tabela: Uma vez que o usuário responda, este nó pode pegar o resultado e atualizar um registro no banco de dados para finalizar o status da transação.
Com isso em prática, você agora tem um poderoso serviço de aprovação sob demanda esperando para ser chamado.
Passo 2: Acionar o Webhook a partir do DecisionRules
Agora, vamos voltar ao seu fluxo do DecisionRules. Precisamos adicionar a lógica que chama o webhook do N8N que acabamos de criar, mas apenas quando uma escalonamento for necessária.
- No seu fluxo do DecisionRules, adicione um Nó Switch após sua Regra de Negócios. O Switch irá verificar a saída da regra.
- No caminho "Escalonar" do Switch, adicione um REST API Cliente nó. Este é o nó que irá acionar nosso fluxo de trabalho N8N.
Agora, vamos configurar o nó Cliente da API REST. É aqui que você conecta as duas plataformas.
- Selecionar Conector: Clique no dropdown "Selecionar Conector".
- URL POST: Cole a URL do Webhook que você copiou do N8N na etapa anterior.
- Corpo: É assim que você passa dados do DecisionRules para o N8N. Você pode construir um objeto JSON usando dados da saída da sua regra. Por exemplo, para enviar as informações da lista de e-mails, você usaria: { "mailing": mailing.output }
E é isso. Seu fluxo do DecisionRules agora executará sua lógica e, se uma escalonamento for necessária, acionará instantaneamente seu fluxo de trabalho de aprovação N8N, passando todos os dados necessários. Crucialmente, o fluxo do DecisionRules não espera; ele retorna imediatamente seu próprio resultado para a aplicação chamadora original enquanto o N8N gerencia o processo de aprovação separado e assíncrono.
Conclusão: De Regras Simples a Fluxos de Trabalho Poderosos
Como você viu nesses dois padrões, conectar DecisionRules e N8N é incrivelmente simples. O design orientado a API do DecisionRules significa que você pode integrar perfeitamente sua poderosa lógica de negócios com as vastas capacidades de orquestração das modernas plataformas de automação.
Você não apenas conectou duas ferramentas; você criou um sistema onde seus especialistas em negócios podem definir o "o que" (a lógica de decisão) e seus fluxos de trabalho de automação podem lidar com o "como" (as notificações, aprovações e atualizações de sistema). Esta é a base da verdadeira automação empresarial.