Como criar aprovação humana no n8n antes de uma ação automática

Se uma automação pode enviar uma mensagem para um cliente, alterar um cadastro ou publicar algo em seu nome, vale colocar uma pessoa no meio do caminho. No n8n, isso pode ser feito com uma etapa de aprovação antes da ação final — e sem transformar o fluxo inteiro em um processo manual.

A ideia deste guia é simples: o n8n recebe um evento, prepara um rascunho, envia os detalhes para revisão e só continua se alguém aprovar. O exemplo usa e-mail, mas o mesmo princípio pode ser levado para Slack, Telegram, Microsoft Teams ou outros canais disponíveis na plataforma.

O que é aprovação humana no n8n?

Aprovação humana, ou human-in-the-loop, é uma pausa deliberada no fluxo. O sistema pode coletar dados, consultar uma API, resumir um texto ou montar uma resposta. Antes de enviar, excluir, comprar ou atualizar alguma coisa, ele pede uma decisão a uma pessoa.

Isso é diferente de simplesmente mandar uma notificação. Na aprovação, o fluxo precisa receber uma resposta e seguir por caminhos diferentes. Se a pessoa aprovar, a próxima ação é executada; se negar, o processo pode ser encerrado, marcado como recusado ou encaminhado para revisão.

A própria documentação do n8n descreve esse mecanismo para ferramentas usadas por agentes de IA: a execução pausa, o revisor vê qual ferramenta seria chamada e com quais parâmetros, e a ação só roda depois de uma aprovação. A recomendação é especialmente importante para comunicações externas, alterações irreversíveis e decisões de alto impacto.

Quando vale usar esse bloqueio

• Mensagens externas: respostas comerciais, e-mails de cobrança, avisos a pacientes ou comunicados para clientes.
• Alterações em sistemas: editar um CRM, mudar o status de um pedido ou atualizar um cadastro.
• Ações difíceis de desfazer: apagar dados, publicar conteúdo ou disparar uma compra.
• Fluxos com IA: textos e classificações podem ser gerados automaticamente, mas uma pessoa revisa o resultado antes do envio.
• Processos regulados: a aprovação ajuda a registrar quem autorizou uma operação e em que momento.

Para uma tarefa puramente interna e reversível, a revisão pode só aumentar o atrito. O bom critério é perguntar: “se isso sair errado, consigo desfazer sem prejuízo?”. Se a resposta for não, a pausa costuma ser justificável.

Como montar o fluxo de aprovação no n8n

1. Escolha o gatilho

Comece pelo evento que inicia o processo. Pode ser um Webhook vindo de um formulário, um disparo agendado ou uma nova linha em uma planilha. Se você ainda não trabalha com webhooks, o JSMS já explicou como criar um webhook no n8n para receber dados de um formulário.

Para o exemplo, imagine que um formulário envie nome, e-mail e mensagem de um cliente. O gatilho não deve executar nenhuma ação externa ainda; ele apenas inicia o fluxo e entrega os dados para os próximos nós.

2. Prepare o rascunho antes de pedir a decisão

Use nós de transformação, como Edit Fields, ou uma etapa de código para normalizar os dados. Monte uma versão legível da operação: destinatário, assunto, texto que será enviado e, se necessário, o motivo da ação.

Essa etapa é mais importante do que parece. Um botão “aprovar” sem contexto convida ao clique automático. O revisor precisa saber o que vai acontecer, com quem e por quê. Em um atendimento, por exemplo, mostre a mensagem original do cliente e a resposta sugerida pela IA lado a lado.

3. Envie a solicitação de aprovação

No Gmail, a documentação do n8n oferece a operação Send and Wait for Approval, indicada para processos simples. Configure uma credencial do Gmail, informe o destinatário da revisão e personalize o assunto e o corpo do e-mail com expressões do fluxo.

Em Type of Approval, a opção Approve Only exibe apenas a aprovação. Para um fluxo que precisa distinguir recusa de aprovação, escolha Approve and Disapprove. A documentação também prevê rótulo próprio para o botão de recusa, que por padrão é “Decline”.

Não coloque senha, token ou informação desnecessária no e-mail. Mostre os dados mínimos para a decisão e inclua um identificador do processo. Se o conteúdo tiver dados pessoais, restrinja os destinatários e avalie se o canal escolhido atende às regras da sua empresa.

4. Ligue a aprovação à ação final

Depois do nó de aprovação, conecte a etapa que realmente produz o efeito: enviar o e-mail, chamar uma API, criar uma tarefa ou atualizar o CRM. O caminho de recusa deve fazer algo explícito, como gravar o status “negado” e encerrar a execução.

Uma estrutura básica fica assim:

Gatilho → preparar dados → montar rascunho → pedir aprovação
                                      ├─ aprovado → executar ação
                                      └─ negado   → registrar recusa e parar

O fluxo também pode registrar a decisão em uma planilha ou banco de dados. Esse histórico é útil para descobrir gargalos e para responder à pergunta que sempre aparece quando uma automação falha: quem autorizou a ação?

5. Defina o que acontece se ninguém responder

A ausência de resposta não deve ser interpretada como aprovação. Estabeleça um prazo e um caminho de expiração: manter pendente, avisar outro responsável ou cancelar a operação. Quando você precisa de mais controle sobre a pausa, o nó Wait do n8n pode retomar a execução após um intervalo, em um horário específico, por uma chamada de webhook ou depois do envio de um formulário.

Em uma operação financeira, por exemplo, faz sentido expirar uma autorização depois de algumas horas. Em uma publicação de conteúdo, talvez seja melhor reenviar um lembrete e encaminhar a decisão para um segundo revisor.

Como incluir um agente de IA sem perder o controle

O n8n permite aplicar revisão humana a ferramentas conectadas a um agente de IA. Nesse modelo, o agente pode decidir que precisa chamar uma ferramenta, mas o fluxo pausa antes de executar operações selecionadas. O revisor recebe o nome da ferramenta e os parâmetros que serão usados.

Não é necessário aprovar cada resposta textual. Selecione as ferramentas de maior risco, como enviar mensagens, modificar registros, excluir informações ou fazer compras. A documentação do n8n também recomenda explicar no system prompt quais ferramentas exigem aprovação e como o agente deve reagir quando a pessoa negar o pedido.

Na prática, isso cria uma divisão saudável: a IA prepara e sugere; a pessoa decide quando a consequência é relevante. É menos “mágico” do que deixar o agente fazer tudo sozinho, mas é muito mais fácil de auditar.

Erros comuns nesse tipo de automação

• Aprovar sem contexto: o e-mail não informa o destinatário, o conteúdo ou o impacto da ação.
• Tratar silêncio como sim: se não houver resposta, o fluxo precisa parar ou expirar.
• Deixar a ação antes da aprovação: teste o encadeamento para garantir que o nó externo está realmente depois da etapa de decisão.
• Não testar a recusa: confirme que o caminho negativo não dispara a ação por engano.
• Usar uma única conta para tudo: se possível, separe credenciais e aplique o menor privilégio necessário.
• Ignorar duplicidade: um reenvio do webhook pode criar duas solicitações. Use um identificador idempotente para evitar duas execuções da mesma operação.

Checklist antes de colocar em produção

1. Execute o fluxo com dados fictícios e confirme o conteúdo da aprovação.
2. Teste aprovação, recusa, expiração e erro de credencial.
3. Confira se a ação externa aparece somente depois do caminho aprovado.
4. Registre o identificador da execução, a decisão e o horário.
5. Defina um responsável substituto para aprovações urgentes.
6. Revise os dados pessoais exibidos no canal de aprovação.

Se o fluxo crescer, considere separar a preparação da execução em workflows menores. Isso facilita manutenção, testes e permissões. Também ajuda a trocar o canal de aprovação sem reescrever toda a automação.

Perguntas frequentes

O n8n pode esperar uma resposta antes de continuar?

Sim. O Gmail tem a operação Send and Wait for Approval para aprovações simples, e o nó Wait pode pausar e retomar uma execução conforme o tempo, uma chamada HTTP ou um formulário.

Posso aprovar uma ação de um agente de IA?

Sim. A revisão humana pode ser ligada a ferramentas específicas de um AI Agent. O agente fica pausado até a pessoa aprovar ou negar a chamada.

O que acontece quando a aprovação é negada?

A ação conectada ao caminho aprovado não deve ser executada. O fluxo pode registrar a recusa, avisar alguém ou encerrar a execução.

É melhor usar e-mail, Slack ou Telegram?

Depende de onde o responsável acompanha o trabalho. E-mail é simples para aprovações ocasionais; Slack, Telegram e outros canais podem ser mais rápidos para equipes que já trabalham neles. Em qualquer caso, preserve o registro da decisão no seu sistema.